---
title: "Create a question"
method: POST
path: "/v1/org/{orgId}/question"
tags: ["question"]
---

# Create a question

`POST /v1/org/{orgId}/question`

## Path parameters

- `orgId` string, required

## Request body

- CreateQuestion
  - `orgId` string — parent organization id (empty if global)
  - `question` string, required — text of the question
  - `questionTr` Translations
    - `values` object, required
  - `fieldId` string — if the question is linked to a field, the id of that field. Any question responses will be automatically saved to the field
  - `type` 'ADDRESS' | 'AUDIO' | 'BOOLEAN' | 'COMP' | 'COMPOUND' | 'COMP_BAND' | 'CONTACTS' | 'CURRENCY' | 'DATE' | 'DECIMAL' | 'ELAPSED_DAYS' | 'ELAPSED_MONTHS' | 'ELAPSED_YEARS' | 'EMAIL' | 'ENUM' | 'ENUM_EXPR' | 'ENUM_MULTI' | 'ENUM_SCALE' | 'EXPR' | 'FILE' | 'GROUP' | 'GROUPS' | 'GROUP_ASSIGNMENTS' | 'GROUP_TYPE' | 'GROUP_POSITION_ASSIGNMENTS' | 'IMAGE' | 'INTEGER' | 'JOB' | 'JOB_CODE' | 'JOBS' | 'JOB_TIER' | 'LIST' | 'MAP' | 'MONEY' | 'NAME' | 'OBJECT' | 'PAY_INTERVAL' | 'PERCENT' | 'PERSON' | 'PERSONS' | 'PHONE' | 'STOCKGRANT' | 'STRING' | 'TABLE_REF' | 'TEXT' | 'TIMEOFF' | 'TIMESTAMP' | 'TRACKED_GROUP' | 'URL' | 'USER' | 'VARIABLE_COMP' | 'VARIABLE_COMPS' — datatype of the question
  - `plural` 'SINGLE' | 'LIST' | 'SET' — plural type of the question datatype (either SINGLE, LIST, or SET)
  - `values` EnumValue[] — possible values (enum type only)
    - `name` string, required — enum value name
    - `label` string, required — enum value label
    - `color` string — color of property
    - `expr` string — computed expression, for ENUM_EXPR type
    - `num` number — numeric value, for ENUM_SCALE type
    - `sort` integer — sort order
    - `rank` integer — rank order, if selected in rank order
    - `id` string — unique identifier for enum
    - `labelTr` Translations
      - `values` object, required
  - `places` integer — number of decimal places for numeric values
  - `options` FieldOptions
    - `min` string — minimum value, for numeric and date fields
    - `max` string — maximum value, for numeric and date fields
    - `minItems` integer
    - `maxItems` integer
    - `stackRank` boolean
    - `step` number
    - `enableEditDialog` boolean
    - `requiredJobField` boolean
    - `excludeTargetPersonId` boolean
    - `maxLength` integer
    - `readOnly` boolean
    - `includeFormer` boolean
    - `effectiveDated` boolean
    - `unique` boolean
    - `required` boolean

## Response `201`

question created

- Question
  - `id` string, required — globally unique id
  - `orgId` string — parent organization id (empty if global)
  - `question` string, required — text of the question
  - `questionTr` Translations
    - `values` object, required
  - `fieldId` string — if the question is linked to a field, the id of that field. Any question responses will be automatically saved to the field
  - `type` 'ADDRESS' | 'AUDIO' | 'BOOLEAN' | 'COMP' | 'COMPOUND' | 'COMP_BAND' | 'CONTACTS' | 'CURRENCY' | 'DATE' | 'DECIMAL' | 'ELAPSED_DAYS' | 'ELAPSED_MONTHS' | 'ELAPSED_YEARS' | 'EMAIL' | 'ENUM' | 'ENUM_EXPR' | 'ENUM_MULTI' | 'ENUM_SCALE' | 'EXPR' | 'FILE' | 'GROUP' | 'GROUPS' | 'GROUP_ASSIGNMENTS' | 'GROUP_TYPE' | 'GROUP_POSITION_ASSIGNMENTS' | 'IMAGE' | 'INTEGER' | 'JOB' | 'JOB_CODE' | 'JOBS' | 'JOB_TIER' | 'LIST' | 'MAP' | 'MONEY' | 'NAME' | 'OBJECT' | 'PAY_INTERVAL' | 'PERCENT' | 'PERSON' | 'PERSONS' | 'PHONE' | 'STOCKGRANT' | 'STRING' | 'TABLE_REF' | 'TEXT' | 'TIMEOFF' | 'TIMESTAMP' | 'TRACKED_GROUP' | 'URL' | 'USER' | 'VARIABLE_COMP' | 'VARIABLE_COMPS', required — datatype of the question
  - `plural` 'SINGLE' | 'LIST' | 'SET' — plural type of the question datatype (either SINGLE, LIST, or SET)
  - `values` EnumValue[] — possible values (enum type only)
    - `name` string, required — enum value name
    - `label` string, required — enum value label
    - `color` string — color of property
    - `expr` string — computed expression, for ENUM_EXPR type
    - `num` number — numeric value, for ENUM_SCALE type
    - `sort` integer — sort order
    - `rank` integer — rank order, if selected in rank order
    - `id` string — unique identifier for enum
    - `labelTr` Translations
      - `values` object, required
  - `places` integer — number of decimal places for numeric values
  - `options` FieldOptions
    - `min` string — minimum value, for numeric and date fields
    - `max` string — maximum value, for numeric and date fields
    - `minItems` integer
    - `maxItems` integer
    - `stackRank` boolean
    - `step` number
    - `enableEditDialog` boolean
    - `requiredJobField` boolean
    - `excludeTargetPersonId` boolean
    - `maxLength` integer
    - `readOnly` boolean
    - `includeFormer` boolean
    - `effectiveDated` boolean
    - `unique` boolean
    - `required` boolean
  - `createId` string — created by user id
  - `createBehalfId` string — created on behalf of user id
  - `createAttribution` Attribution
    - `principalUserId` string
    - `agentUserIds` string[]
    - `eventId` string
    - `aiChatId` string
    - `aiToolUseId` string
    - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `createAt` string — created timestamp
  - `updateId` string — last updated by user id
  - `updateBehalfId` string — last updated on behalf of user id
  - `updateAttribution` Attribution
    - `principalUserId` string
    - `agentUserIds` string[]
    - `eventId` string
    - `aiChatId` string
    - `aiToolUseId` string
    - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `updateAt` string — last updated timestamp
  - `deleteId` string — deleted by user id
  - `deleteBehalfId` string — deleted on behalf of user id
  - `deleteAttribution` Attribution
    - `principalUserId` string
    - `agentUserIds` string[]
    - `eventId` string
    - `aiChatId` string
    - `aiToolUseId` string
    - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `deleteAt` string — deleted timestamp

## Other responses

- `400` — invalid data
- `401` — not authorized
- `403` — permission denied
- `404` — org not found

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/revisions/2de21f45f447/schema)