Skip to main content
POST
Create 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.

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.
Evidence to attach to the issue at creation. Each entry links the issue to a call, SMS conversation, or uploaded file.

Response

Returns 201 Created with the newly created issue.
object
The created issue.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt