API Documentation

400">curl -X POST https://api.trajancloud.com/api/v1/public/tickets/ \
  -H "Authorization: Bearer trj_pk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Login button unresponsive on mobile",
    "type": "bug",
    "priority": "high",
    "description": "The login button does not respond to taps on iOS Safari 17."
  }'

{
  "id": "d4f8a1c2-9b3e-4f7a-a1d2-6c8e9f0b3a5d",
  "title": "Login button unresponsive on mobile",
  "status": "open",
  "type": "bug",
  "priority": 2,
  "created_at": "2026-02-23T14:30:00Z"
}

400">curl https://api.trajancloud.com/api/v1/public/tickets/ \
  -H "Authorization: Bearer trj_pk_your_api_key"

{
  "items": [
    {
      "id": "d4f8a1c2-9b3e-4f7a-a1d2-6c8e9f0b3a5d",
      "title": "Login button unresponsive on mobile",
      "type": "bug",
      "status": "open",
      "priority": 2,
      "source": "api",
      "created_at": "2026-02-23T14:30:00Z",
      "updated_at": "2026-02-23T14:30:00Z"
    }
  ],
  "total": 1,
  "limit": 50,
  "offset": 0
}

Authorization: Bearer trj_pk_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

{
  "detail": "Human-readable error message"
}

400">async 400">function submitWithRetry(url, body, apiKey, maxRetries = 3) {
  for (400">let attempt = 0; attempt <= maxRetries; attempt++) {
    400">const response = 400">await fetch(url, {
      method: "POST",
      headers: {
        "Authorization": `Bearer ${apiKey}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify(body),
    });

    400">if (response.ok) 400">return response.json();

    400">if (response.status === 429 || response.status >= 500) {
      400">const retryAfter = response.headers.get("Retry-After");
      400">const delay = retryAfter
        ? Number(retryAfter) * 1000
        : Math.min(1000 * 2 ** attempt, 30000);
      400">await 400">new Promise((r) => setTimeout(r, delay));
      continue;
    }

    // 401, 403, 404, 422 — do not retry
    400">const error = 400">await response.json();
    400">throw 400">new Error(error.detail);
  }
  400">throw 400">new Error("Max retries exceeded");
}