> ## 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.

# Create Issue

> Create a triage issue.

## 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](https://app.bland.ai/dashboard/monitor/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](https://docs.bland.ai/api-v1/post/triage-categories.md):

* `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.

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.

```json theme={null}
{
  "resource_links": [
    { "resource_type": "call", "resource_id": "d8ef6e50-830b-4c73-a956-3b04a1f28550" },
    { "resource_type": "file", "resource_id": "54eaa506-8b68-4be7-8d14-1ff260899eee" }
  ]
}
```

> [accordion] Resource link fields
>
> * `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](https://docs.bland.ai/api-v1/post/calls.md).

***

## Response

Returns `201 Created` with the newly created issue.

**data** `object`

The created issue.

**Issue fields**

**id** `string`

Internal UUID of the issue. Use this in all `/v1/triage/issues/{id}/...` endpoints.

**triage\_id** `string`

Short, human-friendly issue identifier (for example `T-1001`) shown in the dashboard.

**org\_id** `string`

The org that owns this issue.

**number** `number`

Sequential issue number within your org. Matches the numeric portion of `triage_id`.

**title** `string`

**description** `string`

**status** `string`

One of `backlog`, `todo`, `in_progress`, `in_review`, `done`, `closed`.

**severity** `string`

One of `critical`, `high`, `medium`, `low`.

**source** `string`

One of `manual`, `automated`, `client`.

**category** `string`

**owner\_id** `string | null`

**assignee\_id** `string | null`

**author\_id** `string`

User ID of the caller that created the issue.

**external\_link** `object | null`

External system link (for example a GitHub issue) bound to this triage issue, if any.

**resource\_count** `number`

Number of attached resources (calls, SMS, files).

**flag\_count** `number`

Number of flags raised against attached calls.

**relation\_count** `number`

Number of related issues linked to this one.

**latest\_agent\_session** `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.

**is\_processing** `boolean`

`true` while Norm is actively running against the issue.

**has\_unread\_activity** `boolean`

`true` if there is activity since the caller last viewed the issue.

**created\_at** `string`

ISO 8601 timestamp.

**updated\_at** `string`

ISO 8601 timestamp.

**last\_activity\_at** `string`

ISO 8601 timestamp of the most recent activity entry.

**errors** `null | array`

`null` on success, or a list of error objects if the request failed.

```json Response theme={null}
{
  "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](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.