Skip to main content

Documentation Index

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

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

Issues let users report problems with responses or content. Use these endpoints to list, create, update, and close issues.

​
Basic request and response

List issues with GET /api/v1/app/issue before creating or updating. 
curl "https://{BASE_URL}/api/v1/app/issue?page=1&page_size=20" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"

{
  "data": [
    {
      "id": "issue_5c4b3a2d1e0f9a8b",
      "issue_number": 1842,
      "description": "Response missed the attached policy details.",
      "resource_type": "Thread",
      "type": "NoContextUsed",
      "state": "NotReviewed",
      "is_read": false,
      "created_at": "2026-02-08T14:55:10Z",
      "updated_at": "2026-02-08T14:55:10Z",
      "created_by": {
        "id": "user_4b7c2a1d9e5f3c8b",
        "org_id": "org_2f3a9d1c7b5e4a8f",
        "account_id": "acct_6c8a1f3b2d4e5f7a",
        "name": "Sasha Patel",
        "email": "sasha@auroralabs.com",
        "state": "Active",
        "roles": ["AppAdmin"],
        "created_at": "2026-02-08T14:12:45Z"
      }
    }
  ],
  "has_next_page": false,
  "has_previous_page": false,
  "total_count": 1
}

​
Create an issue

curl -X POST "https://{BASE_URL}/api/v1/app/issue" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Response missed the attached policy details.",
    "resource_type": "Thread",
    "type": "NoContextUsed",
    "anonymous": false
  }'

{
  "id": "issue_5c4b3a2d1e0f9a8b",
  "issue_number": 1842,
  "description": "Response missed the attached policy details.",
  "resource_type": "Thread",
  "type": "NoContextUsed",
  "state": "NotReviewed",
  "is_read": false,
  "created_at": "2026-02-08T14:55:10Z",
  "updated_at": "2026-02-08T14:55:10Z",
  "created_by": {
    "id": "user_4b7c2a1d9e5f3c8b",
    "org_id": "org_2f3a9d1c7b5e4a8f",
    "account_id": "acct_6c8a1f3b2d4e5f7a",
    "name": "Sasha Patel",
    "email": "sasha@auroralabs.com",
    "state": "Active",
    "roles": ["AppAdmin"],
    "created_at": "2026-02-08T14:12:45Z"
  }
}

​
Get or update an issue

curl "https://{BASE_URL}/api/v1/app/issue/issue_5c4b3a2d1e0f9a8b" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"

{
  "id": "issue_5c4b3a2d1e0f9a8b",
  "issue_number": 1842,
  "description": "Response missed the attached policy details.",
  "state": "NotReviewed"
}

​
Delete an issue

curl -X DELETE "https://{BASE_URL}/api/v1/app/issue/issue_5c4b3a2d1e0f9a8b" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"

HTTP/1.1 204 No Content

​
Errors and edge cases

  • 404: issue not found.
  • 400: invalid issue state.