API Reference

Trigger agent runs programmatically using the TicksyAI public API.

Authentication

All API requests require a Bearer token. Generate one in Settings > API Keys.

Authorization: Bearer tsk_...

Endpoints

Trigger a run

POST https://ticksyai-api.wedevit.fr/api/v1/runs
Content-Type: application/json
Authorization: Bearer tsk_...

{
  "projectSlug": "my-project",
  "ticketKey": "PROJ-42",
  "postComment": true
}

Response:

{ "runId": "clxyz..." }

Get run status

GET https://ticksyai-api.wedevit.fr/api/v1/runs/{runId}
Authorization: Bearer tsk_...

Response:

{
  "id": "clxyz...",
  "status": "success",
  "ticketKey": "PROJ-42",
  "output": { "plan": "..." },
  "durationMs": 12400,
  "createdAt": "2026-04-06T10:00:00Z"
}

List projects

GET https://ticksyai-api.wedevit.fr/api/v1/projects
Authorization: Bearer tsk_...

Response:

{ "projects": [{ "id": "...", "name": "My Project", "slug": "my-project" }] }

Rate limits

  • 100 requests/minute per API key
  • Runs count toward your monthly quota