Sign in
latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-167449145.8 KB

6965ecf3ab92

Issue

Add issue relation

Create an outgoing relation from the issue in the URL to another issue. Self-relations and the reserved "subtask of" kind are rejected.

post/v1/issues/{id}/relations

Request body

related_idstring required

ID of the related issue. The created edge is always outgoing from the issue in the URL.

kind'blocked by' | 'blocks' | 'depends on' | 'duplicated by' | 'duplicates' | 'related to' | 'subtask of' required

Kind of relation between two issues.

Example request

{
  "related_id": "9bsv0s46s6s002p9ltq0",
  "kind": "blocks"
}

Response

Created

idstring required

Unique identifier of the relation.

kind'blocked by' | 'blocks' | 'depends on' | 'duplicated by' | 'duplicates' | 'related to' | 'subtask of' required

Kind of relation between two issues.

direction'outgoing' | 'incoming' required

Whether the relation edge leaves (outgoing) or enters (incoming) the issue in the URL.

created_atstring date-time required

Date when the relation was created.

Example response

{
  "id": "9bsv0s46s6s002p9ltq0",
  "kind": "blocks",
  "direction": "outgoing",
  "related": {
    "id": "9bsv0s46s6s002p9ltq0",
    "key": "MOB-1",
    "numeric_id": 1,
    "kind": "story",
    "title": "Implement authentication",
    "description": "Add OAuth2 password and authorization code flows.",
    "status": "open",
    "priority": "normal",
    "reported_by": {
      "id": "9bsv0s46s6s002p9ltq0",
      "first_name": "Test",
      "last_name": "User",
      "picture": "https://example.com/users/my-user.png"
    },
    "assignees": [
      {
        "id": "9bsv0s46s6s002p9ltq0",
        "first_name": "Test",
        "last_name": "User",
        "picture": "https://example.com/users/my-user.png"
      }
    ],
    "reviewers": [
      {
        "id": "9bsv0s46s6s002p9ltq0",
        "first_name": "Test",
        "last_name": "User",
        "picture": "https://example.com/users/my-user.png"
      }
    ],
    "labels": [
      {
        "id": "9bsv0s46s6s002p9ltq0",
        "name": "frontend"
      }
    ],
    "project": {
      "id": "9bsv0s46s6s002p9ltq0",
      "key": "ENG",
      "name": "Engineering Project",
      "description": "Main engineering project",
      "logo": "https://example.com/logo.png",
      "status": "active"
    },
    "namespace": {
      "id": "9bsv0s46s6s002p9ltq0",
      "name": "Engineering"
    }
  }
}