Skip to main content
PATCH
/
v1
/
triage
/
issues
/
{id}
Update Issue
curl --request PATCH \
  --url https://api.bland.ai/v1/triage/issues/{id} \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "status": "<string>",
  "severity": "<string>",
  "category": "<string>",
  "owner_id": {},
  "assignee_id": {}
}
'
{
  "data": {
    "id": "b4f022b0-e47e-4c8e-b67c-b763db7b4ba4",
    "triage_id": "T-1042",
    "org_id": "f038cd1d-aa49-4127-ab2d-90c3fce669f3",
    "number": 1042,
    "title": "Agent skipped the verification step (confirmed)",
    "description": "On the Aug 12 demo flow the agent jumped to the closing node without asking for the email confirmation.",
    "status": "in_progress",
    "severity": "high",
    "source": "manual",
    "category": "Routing",
    "owner_id": null,
    "assignee_id": "d8dddfff-cc75-4e31-8056-cf3521e8055b",
    "author_id": "df480553-8bf8-4327-917d-402c33282a2e",
    "external_link": null,
    "created_at": "2026-05-04T18:24:11.482Z",
    "updated_at": "2026-05-07T02:29:25.744Z",
    "last_activity_at": "2026-05-07T02:29:25.744Z",
    "resource_count": 3,
    "flag_count": 1,
    "relation_count": 0,
    "latest_agent_session": null,
    "is_processing": false,
    "has_unread_activity": true
  },
  "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

Partial update. Send only the fields you want to change. Pass null for owner_id or assignee_id to clear them. Returns the full updated issue.

Headers

authorization
string
required
Your API key for authentication.

Path Parameters

id
string
required
Internal UUID of the issue.

Body Parameters

Send any combination of the fields below. Sending an empty body is allowed but a no-op.
title
string
New title. 1-200 characters.
description
string
New description. Maximum 10,000 characters.
status
string
New status. One of backlog, todo, in_progress, in_review, done, closed.
severity
string
New severity. One of critical, high, medium, low.
category
string
New category. 1-64 characters. The category does not need to exist in the Categories catalog beforehand, freely-typed values are accepted.
owner_id
string | null
New owner. Pass a user ID to assign, or null to clear.
assignee_id
string | null
New assignee. Pass a user ID to assign, or null to clear.

Response

data
object
The updated issue. See Create Issue for the full field list.
errors
null | array
null on success. Returns 404 if the issue does not exist or is not in your org. Returns 400 with { error: "bad_request" } if any field fails validation, the message lists each invalid path.
{
  "data": {
    "id": "b4f022b0-e47e-4c8e-b67c-b763db7b4ba4",
    "triage_id": "T-1042",
    "org_id": "f038cd1d-aa49-4127-ab2d-90c3fce669f3",
    "number": 1042,
    "title": "Agent skipped the verification step (confirmed)",
    "description": "On the Aug 12 demo flow the agent jumped to the closing node without asking for the email confirmation.",
    "status": "in_progress",
    "severity": "high",
    "source": "manual",
    "category": "Routing",
    "owner_id": null,
    "assignee_id": "d8dddfff-cc75-4e31-8056-cf3521e8055b",
    "author_id": "df480553-8bf8-4327-917d-402c33282a2e",
    "external_link": null,
    "created_at": "2026-05-04T18:24:11.482Z",
    "updated_at": "2026-05-07T02:29:25.744Z",
    "last_activity_at": "2026-05-07T02:29:25.744Z",
    "resource_count": 3,
    "flag_count": 1,
    "relation_count": 0,
    "latest_agent_session": null,
    "is_processing": false,
    "has_unread_activity": true
  },
  "errors": null
}

Docs for agents: llms.txt