Skip to main content
POST
/
v1
/
issue
Create issue
curl --request POST \
  --url https://api.roark.ai/v1/issue \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "summary": "<string>",
  "severity": "LOW",
  "evidence": []
}
'
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "alertId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "source": "TREND_ALERT",
    "title": "<string>",
    "summary": "<string>",
    "severity": "LOW",
    "status": "OPEN",
    "openedAt": "<string>",
    "resolvedAt": "<string>",
    "assigneeUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "evidence": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "callId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "chatId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "observedAt": "<string>"
      }
    ],
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
}

Documentation Index

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

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

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
title
string
required

Short headline — required, max 280 characters

Required string length: 1 - 280
​
summary
string | null

Longer-form context — optional, max 2000 characters

Required string length: 1 - 2000
​
severity
enum<string> | null

Coarse priority. Null when unset.

Available options:
LOW,
MEDIUM,
HIGH,
CRITICAL
​
evidence
object[]

Calls / chats to attach as evidence. Optional; max 50 entries per issue.

Maximum array length: 50

Response

The created issue

​
data
object
required

An issue surfaced on the Roark Issues page