Responses are generated using AI and may contain mistakes.
Bland is getting a major upgrade. We're working on updating our docs as users transition in the coming weeks. Reach out to support@bland.ai with questions.
{ "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}
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
string
required
Your API key for authentication.
Body Parameters
string
required
Short, human-readable summary of the issue. 1-200 characters.
string
required
How urgent the issue is. Must be one of:
critical
high
medium
low
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
string
Longer explanation of the problem. Maximum 10,000 characters. Shown to Norm as part of the evidence snapshot when you prompt the agent.
string
default:"todo"
Initial status. Defaults to todo if omitted. Must be one of:
backlog
todo
in_progress
in_review
done
closed
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
string
User ID of the person ultimately accountable for the issue.
string
User ID of the person currently working on the issue.
array
Evidence to attach to the issue at creation. Each entry links the issue to a call, SMS conversation, or uploaded file.If you attach a call, the issue belongs to the agent that handled that call. It then appears on that agent’s Issues page in the dashboard.
resource_type, one of call, sms_conversation, or file.
resource_id, the ID of the resource. For calls this is the call_id returned by Send Call.
Response
Returns 201 Created with the newly created issue.
object
The created issue.
Show Issue fields
string
Internal UUID of the issue. Use this in all /v1/triage/issues/{id}/... endpoints.
string
Short, human-friendly issue identifier (for example T-1001) shown in the dashboard.
string
The org that owns this issue.
number
Sequential issue number within your org. Matches the numeric portion of triage_id.
string
string
string
One of backlog, todo, in_progress, in_review, done, closed.
string
One of critical, high, medium, low.
string
One of manual, automated, client.
string
string | null
string | null
string
User ID of the caller that created the issue.
object | null
External system link (for example a GitHub issue) bound to this triage issue, if any.
number
Number of attached resources (calls, SMS, files).
number
Number of flags raised against attached calls.
number
Number of related issues linked to this one.
object | null
The most recent Norm session bound to this issue, including its run state and any draft pathway version Norm is working against. null if Norm has never been prompted for this issue.
boolean
true while Norm is actively running against the issue.
boolean
true if there is activity since the caller last viewed the issue.
string
ISO 8601 timestamp.
string
ISO 8601 timestamp.
string
ISO 8601 timestamp of the most recent activity entry.
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}