Sign in
Custom Field

Create custom field definition

Create a typed custom-field definition. The definition is immediately usable.

post/v1/custom-fields

Request body

keystring required
namestring required
descriptionstring
kind'text' | 'integer' | 'decimal' | 'boolean' | 'date' | 'datetime' | 'url' | 'single_select' | 'multi_select' | 'user_reference' | 'resource_reference' required
scope_idstring required
scope_type'Assignment' | 'Attachment' | 'Comment' | 'Document' | 'Issue' | 'IssueRelation' | 'Label' | 'Namespace' | 'Notification' | 'Organization' | 'Permission' | 'Project' | 'ResourceType' | 'Role' | 'Team' | 'Todo' | 'User' | 'UserToken' | 'Folder' | 'Installation' | 'CustomFieldDefinition' | 'Extension' required
target_type'Assignment' | 'Attachment' | 'Comment' | 'Document' | 'Issue' | 'IssueRelation' | 'Label' | 'Namespace' | 'Notification' | 'Organization' | 'Permission' | 'Project' | 'ResourceType' | 'Role' | 'Team' | 'Todo' | 'User' | 'UserToken' | 'Folder' | 'Installation' | 'CustomFieldDefinition' | 'Extension' required
requiredboolean
index_exactboolean
index_rangeboolean
index_fulltextboolean
orderinteger

Example request

{
  "key": "story_points",
  "name": "Story points",
  "scope_id": "9bsv0s46s6s002p9ltq0",
  "schema": {
    "min": "0.01",
    "max": "100.00"
  }
}

Response

Created

idstring required
keystring required
namestring required
descriptionstring
kind'text' | 'integer' | 'decimal' | 'boolean' | 'date' | 'datetime' | 'url' | 'single_select' | 'multi_select' | 'user_reference' | 'resource_reference' required
scope_idstring required
scope_type'Assignment' | 'Attachment' | 'Comment' | 'Document' | 'Issue' | 'IssueRelation' | 'Label' | 'Namespace' | 'Notification' | 'Organization' | 'Permission' | 'Project' | 'ResourceType' | 'Role' | 'Team' | 'Todo' | 'User' | 'UserToken' | 'Folder' | 'Installation' | 'CustomFieldDefinition' | 'Extension' required
target_type'Assignment' | 'Attachment' | 'Comment' | 'Document' | 'Issue' | 'IssueRelation' | 'Label' | 'Namespace' | 'Notification' | 'Organization' | 'Permission' | 'Project' | 'ResourceType' | 'Role' | 'Team' | 'Todo' | 'User' | 'UserToken' | 'Folder' | 'Installation' | 'CustomFieldDefinition' | 'Extension' required
requiredboolean required
archivedboolean required
index_exactboolean required
index_rangeboolean required
index_fulltextboolean required
orderinteger required
owner_user_idstring required
registrar_client_idstring
created_atstring date-time
updated_atstring date-time nullable

Example response

{
  "id": "9bsv0s46s6s002p9ltq0",
  "key": "story_points",
  "name": "Story points",
  "scope_id": "9bsv0s46s6s002p9ltq0",
  "schema": {
    "min": "0.01",
    "max": "100.00"
  }
}

Changes

Changed in 2 of the 26 revisions of this API.34

  • 6c0b21e4101e33See the full diff
    • ●

      added the new Extension enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new Extension enum value to the response property for the response status

      response-property-enum-value-added

    • ●

      added the new Extension enum value to the response property for the response status

      response-property-enum-value-added

    • ○

      added the new Extension enum value to the request property ///

      request-property-enum-value-added

    • ○

      added the new Extension enum value to the request property

      request-property-enum-value-added

    • ○

      added the new Extension enum value to the request property

      request-property-enum-value-added

  • 605ffe113d3d1See the full diff
    • ○

      endpoint added

      endpoint-added