agent-swarm.devagent-swarm.dev

Trackers

Integrate with Linear and Jira ticket trackers — sync issues to swarm tasks bidirectionally

GET
/api/trackers/jira/authorize

Response Body

application/json

application/json

curl -X GET "http://localhost:3013/api/trackers/jira/authorize"
Empty
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
GET
/api/trackers/jira/callback

Query Parameters

code*string
state*string

Response Body

application/json

application/json

curl -X GET "http://localhost:3013/api/trackers/jira/callback?code=string&state=string"
Empty
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
DELETE
/api/trackers/jira/disconnect

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Response Body

application/json

application/json

curl -X DELETE "http://localhost:3013/api/trackers/jira/disconnect"
{
  "disconnected": true,
  "webhooksDeleted": 0,
  "webhooksTotal": 0,
  "webhookFailures": [
    {
      "id": 0,
      "error": "string"
    }
  ],
  "revokeNote": "string"
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
POST
/api/trackers/jira/refresh

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Response Body

application/json

application/json

application/json

application/json

curl -X POST "http://localhost:3013/api/trackers/jira/refresh"
{
  "provider": "jira",
  "connected": true,
  "cloudId": "string",
  "siteUrl": "string",
  "tokenExpiresAt": "string",
  "scope": "string",
  "hasManageWebhookScope": true,
  "webhookTokenConfigured": true,
  "webhookUrl": "string",
  "redirectUri": "string",
  "webhookIds": [
    {
      "id": 0,
      "expiresAt": "string",
      "jql": "string"
    }
  ],
  "manualWebhookInstructions": "string"
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
GET
/api/trackers/jira/status

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Response Body

application/json

application/json

curl -X GET "http://localhost:3013/api/trackers/jira/status"
{
  "provider": "jira",
  "connected": true,
  "cloudId": "string",
  "siteUrl": "string",
  "tokenExpiresAt": "string",
  "scope": "string",
  "hasManageWebhookScope": true,
  "webhookTokenConfigured": true,
  "webhookUrl": "string",
  "redirectUri": "string",
  "webhookIds": [
    {
      "id": 0,
      "expiresAt": "string",
      "jql": "string"
    }
  ],
  "manualWebhookInstructions": "string"
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
POST
/api/trackers/jira/webhook-register

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "http://localhost:3013/api/trackers/jira/webhook-register" \  -H "Content-Type: application/json" \  -d '{    "jqlFilter": "string"  }'
{
  "webhookId": 0,
  "expiresAt": "string",
  "jql": "string"
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
DELETE
/api/trackers/jira/webhook/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*integer
Range0 < value

Response Body

application/json

application/json

application/json

curl -X DELETE "http://localhost:3013/api/trackers/jira/webhook/0"
{
  "deleted": true,
  "webhookId": 0
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
POST
/api/trackers/jira/webhook/{token}

Path Parameters

token*string

Response Body

application/json

application/json

application/json

curl -X POST "http://localhost:3013/api/trackers/jira/webhook/string"
{
  "status": "accepted"
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
GET
/api/trackers/linear/authorize

Response Body

application/json

application/json

curl -X GET "http://localhost:3013/api/trackers/linear/authorize"
Empty
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
GET
/api/trackers/linear/callback

Query Parameters

code*string
state*string

Response Body

application/json

application/json

curl -X GET "http://localhost:3013/api/trackers/linear/callback?code=string&state=string"
Empty
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
DELETE
/api/trackers/linear/disconnect

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Response Body

application/json

application/json

curl -X DELETE "http://localhost:3013/api/trackers/linear/disconnect"
{
  "disconnected": true,
  "revoked": true
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
POST
/api/trackers/linear/refresh

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Response Body

application/json

application/json

application/json

application/json

curl -X POST "http://localhost:3013/api/trackers/linear/refresh"
{
  "provider": "linear",
  "connected": true,
  "tokenExpiry": "string",
  "scope": "string",
  "webhookUrl": "string",
  "redirectUri": "string"
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
GET
/api/trackers/linear/status

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Response Body

application/json

application/json

curl -X GET "http://localhost:3013/api/trackers/linear/status"
{
  "provider": "linear",
  "connected": true,
  "tokenExpiry": "string",
  "scope": "string",
  "webhookUrl": "string",
  "redirectUri": "string"
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
POST
/api/trackers/linear/webhook

Response Body

application/json

application/json

application/json

curl -X POST "http://localhost:3013/api/trackers/linear/webhook"
{
  "status": "duplicate"
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}

Tasks

Core task API — create, assign, update, and monitor tasks across the swarm

Users

Manage the user registry — create users, link cross-platform identities, mint tokens, merge duplicates, and triage unmapped senders