Create an AI sub-ticket

Files a sub-ticket under an open ticket and answers 201. title is required; kind defaults to request and priority to medium. Answers 400 when the parent ticket is closed.

POST /api/v1/org/ai-tickets/{ticket_id}/sub-tickets

Create an AI sub-ticket

Python

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)

201

{
  "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"
      }
    ]
  },
  "condition_check": {
    "state": "present",
    "basis": "alert",
    "reason": "cluster_retired",
    "observed_at": "2023-11-07T05:31:56Z",
    "cluster_state": "<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

201

application/json

Successful Response

id · 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

condition_check · AiTicketConditionCheck · object · required

Whether what the ticket is about still holds, derived when the ticket is read from the bound cluster, the linked alert and the newest observation of its condition. Never null.

Show child attributes