Skip to main content
POST
/
v1
/
triage
/
issues
Create Issue
curl --request POST \
  --url https://api.bland.ai/v1/triage/issues \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "title": "<string>",
  "severity": "<string>",
  "category": "<string>",
  "description": "<string>",
  "status": "<string>",
  "source": "<string>",
  "owner_id": "<string>",
  "assignee_id": "<string>",
  "resource_links": [
    {}
  ]
}
'
{
  "data": {
    "id": "68007859-4325-4ea2-bbd6-e7c8be3a233a",
    "triage_id": "T-1001",
    "org_id": "685b69b7-b903-4d98-9755-af3c957df9e3",
    "number": 1001,
    "title": "Agent skipped the verification step",
    "description": "On the Aug 12 demo flow the agent jumped to the closing node without asking for the email confirmation.",
    "status": "todo",
    "severity": "high",
    "source": "manual",
    "category": "Routing",
    "owner_id": null,
    "assignee_id": "beed099d-e493-4142-a68b-af13bd72c035",
    "author_id": "4d5ac1b5-1f24-46d3-8355-5debfd029a65",
    "external_link": null,
    "created_at": "2026-05-06T21:09:57.081Z",
    "updated_at": "2026-05-06T21:09:57.081Z",
    "last_activity_at": "2026-05-06T21:09:57.081Z",
    "resource_count": 1,
    "flag_count": 0,
    "relation_count": 0,
    "latest_agent_session": null,
    "is_processing": false,
    "has_unread_activity": false
  },
  "errors": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.bland.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Opens a new triage issue, optionally with the calls, SMS conversations, or files that prompted it. Issues are the unit of work in Triage.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Body Parameters

​
title
string
required
Short, human-readable summary of the issue. 1-200 characters.
​
severity
string
required
How urgent the issue is. Must be one of:
  • critical
  • high
  • medium
  • low
​
category
string
required
Free-form category label, 1-64 characters. Categories are scoped to your org and reused across issues. The dashboard ships with these defaults out of the box, but you can add your own with Create Category:
  • Transcription
  • Speech
  • Dialogue
  • Routing
  • Tools
  • Latency
  • Telephony
  • Bug
​
description
string
Longer explanation of the problem. Maximum 10,000 characters. Shown to Norm as part of the evidence snapshot when you prompt the agent.
​
status
string
default:"todo"
Initial status. Defaults to todo if omitted. Must be one of:
  • backlog
  • todo
  • in_progress
  • in_review
  • done
  • closed
​
source
string
default:"manual"
Where the issue originated. Must be one of:
  • manual, created by a user from the dashboard or API (default)
  • automated, created by an automated rule (e.g. an alert binding)
  • client, created by a client integration on the user’s behalf
​
owner_id
string
User ID of the person ultimately accountable for the issue.
​
assignee_id
string
User ID of the person currently working on the issue.
​
resource_links
array
Evidence to attach to the issue at creation. Each entry links the issue to a call, SMS conversation, or uploaded file.
{
  "resource_links": [
    { "resource_type": "call", "resource_id": "d8ef6e50-830b-4c73-a956-3b04a1f28550" },
    { "resource_type": "file", "resource_id": "54eaa506-8b68-4be7-8d14-1ff260899eee" }
  ]
}

​
Response

Returns 201 Created with the newly created issue.
​
data
object
The created issue.
​
errors
null | array
null on success, or a list of error objects if the request failed.
{
  "data": {
    "id": "68007859-4325-4ea2-bbd6-e7c8be3a233a",
    "triage_id": "T-1001",
    "org_id": "685b69b7-b903-4d98-9755-af3c957df9e3",
    "number": 1001,
    "title": "Agent skipped the verification step",
    "description": "On the Aug 12 demo flow the agent jumped to the closing node without asking for the email confirmation.",
    "status": "todo",
    "severity": "high",
    "source": "manual",
    "category": "Routing",
    "owner_id": null,
    "assignee_id": "beed099d-e493-4142-a68b-af13bd72c035",
    "author_id": "4d5ac1b5-1f24-46d3-8355-5debfd029a65",
    "external_link": null,
    "created_at": "2026-05-06T21:09:57.081Z",
    "updated_at": "2026-05-06T21:09:57.081Z",
    "last_activity_at": "2026-05-06T21:09:57.081Z",
    "resource_count": 1,
    "flag_count": 0,
    "relation_count": 0,
    "latest_agent_session": null,
    "is_processing": false,
    "has_unread_activity": false
  },
  "errors": null
}
Docs for agents: llms.txt