Create Ai Sub Ticket

import requests

url = "https://platform.ankra.app/api/v1/org/ai-tickets/{ticket_id}/sub-tickets"

payload = { "title": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({title: '<string>'})
};

fetch('https://platform.ankra.app/api/v1/org/ai-tickets/{ticket_id}/sub-tickets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request POST \
  --url https://platform.ankra.app/api/v1/org/ai-tickets/{ticket_id}/sub-tickets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>"
}
'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ticket_number": 123,
  "title": "<string>",
  "body": "<string>",
  "kind": "<string>",
  "status": "<string>",
  "priority": "<string>",
  "assignee_agent_task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "assignee_agent_name": "<string>",
  "assignee_user_id": "<string>",
  "assignee_user_email": "<string>",
  "assignee_user_name": "<string>",
  "parent_ticket_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "parent_ticket_number": 123,
  "sub_ticket_count": 123,
  "open_sub_ticket_count": 123,
  "cluster_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "cluster_name": "<string>",
  "cluster_archived": true,
  "alert_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "source_kind": "<string>",
  "source_id": "<string>",
  "plan_document": "<string>",
  "plan_status": "<string>",
  "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "slack_channel_id": "<string>",
  "slack_thread_ts": "<string>",
  "teams_conversation_id": "<string>",
  "labels": [
    "<string>"
  ],
  "staffing": "auto",
  "due_at": "2023-11-07T05:31:56Z",
  "created_by_kind": "<string>",
  "created_by": "<string>",
  "resolution": "<string>",
  "recurrence_count": 123,
  "last_event_sequence": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "closed_at": "2023-11-07T05:31:56Z",
  "status_changed_at": "2023-11-07T05:31:56Z",
  "decision_request": {
    "prompt": "<string>",
    "options": [
      {
        "key": "<string>",
        "title": "<string>",
        "summary": "<string>",
        "recommended": true,
        "action_class": "none"
      }
    ]
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

POST

api

org

ai-tickets

{ticket_id}

sub-tickets

Create Ai Sub Ticket

import requests

url = "https://platform.ankra.app/api/v1/org/ai-tickets/{ticket_id}/sub-tickets"

payload = { "title": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({title: '<string>'})
};

fetch('https://platform.ankra.app/api/v1/org/ai-tickets/{ticket_id}/sub-tickets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request POST \
  --url https://platform.ankra.app/api/v1/org/ai-tickets/{ticket_id}/sub-tickets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>"
}
'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "ticket_number": 123,
  "title": "<string>",
  "body": "<string>",
  "kind": "<string>",
  "status": "<string>",
  "priority": "<string>",
  "assignee_agent_task_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "assignee_agent_name": "<string>",
  "assignee_user_id": "<string>",
  "assignee_user_email": "<string>",
  "assignee_user_name": "<string>",
  "parent_ticket_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "parent_ticket_number": 123,
  "sub_ticket_count": 123,
  "open_sub_ticket_count": 123,
  "cluster_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "cluster_name": "<string>",
  "cluster_archived": true,
  "alert_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "source_kind": "<string>",
  "source_id": "<string>",
  "plan_document": "<string>",
  "plan_status": "<string>",
  "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "slack_channel_id": "<string>",
  "slack_thread_ts": "<string>",
  "teams_conversation_id": "<string>",
  "labels": [
    "<string>"
  ],
  "staffing": "auto",
  "due_at": "2023-11-07T05:31:56Z",
  "created_by_kind": "<string>",
  "created_by": "<string>",
  "resolution": "<string>",
  "recurrence_count": 123,
  "last_event_sequence": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "closed_at": "2023-11-07T05:31:56Z",
  "status_changed_at": "2023-11-07T05:31:56Z",
  "decision_request": {
    "prompt": "<string>",
    "options": [
      {
        "key": "<string>",
        "title": "<string>",
        "summary": "<string>",
        "recommended": true,
        "action_class": "none"
      }
    ]
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

authorization

string | null

x-ankra-organisation-id

string | null

Path Parameters

ticket_id

string<uuid>

required

Body

application/json

title

string

required

body

string | null

kind

string | null

priority

string | null

cluster_id

string<uuid> | null

parent_ticket_id

string<uuid> | null

labels

string[] | null

staffing

enum<string> | null

'auto' (default) lets the AI team staff, mirror and escalate the ticket. 'manual' files it as human-owned: no agent is assigned, it is not mirrored into the bound Slack/Teams thread, and it is never escalated as stale. A sub-ticket inherits its parent's staffing when this is omitted.

Available options:

auto,

manual

due_at

string | null

Optional due date as an RFC 3339 timestamp.

source_kind

string | null

Optional dedupe-key half; one of 'alert', 'external'. Must be provided together with source_id.

source_id

string | null

Optional dedupe-key half (at most 200 characters). While a live ticket exists for the same (source_kind, source_id), re-filing bumps its recurrence and returns it with status 200.

alert_id

string<uuid> | null

client_token

string | null

Optional idempotency key (max 200 characters); the body equivalent of the Idempotency-Key header.

Response

Successful Response

string<uuid>

required

ticket_number

integer

required

title

string

required

body

string

required

kind

string

required

status

string

required

priority

string

required

assignee_agent_task_id

string<uuid> | null

required

assignee_agent_name

string | null

required

assignee_user_id

string | null

required

assignee_user_email

string | null

required

assignee_user_name

string | null

required

parent_ticket_id

string<uuid> | null

required

parent_ticket_number

integer | null

required

sub_ticket_count

integer

required

open_sub_ticket_count

integer

required

cluster_id

string<uuid> | null

required

cluster_name

string | null

required

cluster_archived

boolean

required

alert_id

string<uuid> | null

required

source_kind

string | null

required

source_id

string | null

required

plan_document

string | null

required

plan_status

string

required

workspace_id

string<uuid> | null

required

slack_channel_id

string | null

required

slack_thread_ts

string | null

required

teams_conversation_id

string | null

required

labels

string[]

required

staffing

enum<string>

required

Who works this ticket: 'auto' (the AI team may staff it, mirror it into the organisation's bound Slack/Teams thread, and escalate it when stale) or 'manual' (a human owns it; all three automatic lanes skip it).

Available options:

auto,

manual

due_at

string<date-time> | null

required

Advisory due date. No loop reads it; it is metadata for the humans on the board.

created_by_kind

string

required

created_by

string

required

resolution

string | null

required

recurrence_count

integer

required

last_event_sequence

integer

required

created_at

string<date-time>

required

updated_at

string<date-time>

required

closed_at

string<date-time> | null

required

status_changed_at

string<date-time>

required

decision_request

AiTicketDecisionRequest · object | null

required

Set while the ticket is blocked on a choice the agent offered; null otherwise. Answer it with POST /ai-tickets/{ticket_id}/decision.

Show child attributes

API reference

Endpoints

Create Ai Sub Ticket

Authorizations

Headers

Path Parameters

Body

Response