API
Issue configuration
Statuses, issue types, priorities, resolutions, link types, workflows, custom fields, screens and permission schemes.
See Tasks.
Every route below, with its parameters, request and response, errors and samples, is in the API reference.
| Route | What it does |
|---|---|
GET /v1/orgs/:orgId/issues/config/meta | Everything the Tasks app loads once: catalogs, fields, spaces, people, templates. |
GET /v1/orgs/:orgId/issues/config/settings | The org's catalogs and their version (for optimistic updates). |
PUT /v1/orgs/:orgId/issues/config/settings | Replaces the catalogs. Statuses and types still used by workflows or spaces can't be removed. |
GET /v1/orgs/:orgId/issues/config/workflows | Every workflow with its statuses and transitions. |
GET /v1/orgs/:orgId/issues/config/workflows/:workflowId | A workflow and the spaces that use it. |
POST /v1/orgs/:orgId/issues/config/workflows | Creates a workflow (every status must be reachable from the initial one). |
PUT /v1/orgs/:orgId/issues/config/workflows/:workflowId | Replaces a workflow; pass baseVersion to fail instead of overwriting newer edits. |
DELETE /v1/orgs/:orgId/issues/config/workflows/:workflowId | Deletes a workflow no space uses. |
GET /v1/orgs/:orgId/issues/config/fields | Custom fields and the built-in fields. |
POST /v1/orgs/:orgId/issues/config/fields | Creates a custom field (text, number, date, select, multi-select, cascading, people, team, URL, checkbox, labels). |
PUT /v1/orgs/:orgId/issues/config/fields/:fieldId | Changes a custom field (its type can't change). |
DELETE /v1/orgs/:orgId/issues/config/fields/:fieldId | Deletes the definition; values stay on issues but are no longer shown or searchable. |
GET /v1/orgs/:orgId/issues/config/screens | Screens: which fields show on create, edit and view, in tabs. |
POST /v1/orgs/:orgId/issues/config/screens | Creates a screen. |
PUT /v1/orgs/:orgId/issues/config/screens/:screenId | Replaces a screen. |
DELETE /v1/orgs/:orgId/issues/config/screens/:screenId | Deletes a screen no space uses. |
GET /v1/orgs/:orgId/issues/config/schemes | Permission schemes and the permissions they can grant. |
POST /v1/orgs/:orgId/issues/config/schemes | Creates a permission scheme. |
PUT /v1/orgs/:orgId/issues/config/schemes/:schemeId | Replaces a permission scheme's grants. |
DELETE /v1/orgs/:orgId/issues/config/schemes/:schemeId | Deletes a permission scheme no space uses. |