Sign in
latestOpenAPI 3.0.32026-08-22149327338.9 KB

d4db007b26b2

tasks

Link or unlink an external issue to/from a task

By default, links the external issue. To unlink it, set the operation field to "unlink". Repeating the same link request is a successful no-op.

Rate limit: 20 requests per minute

post/tasks/{id}/external-issues

Path parameters

idstring required

The ID of the task to link an external issue to.

Request body

external_issue_idstring required

The ID or human-readable key of the external issue in the source system.

operationstring

Operation to perform. Use "link" to link the issue (default) or "unlink" to unlink it.

sourcestring required

The source system of the external issue (e.g., "linear", "asana", "jira", "github", "shortcut").

Response

request_idstring

The request ID for tracking.

Example response

{
  "data": {
    "custom_fields": {
      "priority": {
        "value": "high"
      }
    }
  }
}