agent-swarm.devagent-swarm.dev

Extensions

Extensions API endpoints

GET
/api/extensions

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Response Body

application/json

curl -X GET "http://localhost:3013/api/extensions"
{
  "extensions": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "runtime": "api",
      "manifestJson": "string",
      "contentHash": "string",
      "version": 1,
      "activeVersion": 1,
      "enabled": true,
      "priority": 0,
      "configJson": "string",
      "status": "disabled",
      "consecutiveFailures": 0,
      "lastError": "string",
      "agentId": "string",
      "createdByAgentId": "string",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ]
}
DELETE
/api/extensions/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string
Length1 <= length

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "http://localhost:3013/api/extensions/string"
{
  "deleted": true
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
GET
/api/extensions/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string
Length1 <= length

Response Body

application/json

application/json

curl -X GET "http://localhost:3013/api/extensions/string"
{
  "extension": {
    "id": "string",
    "name": "string",
    "description": "string",
    "runtime": "api",
    "manifestJson": "string",
    "contentHash": "string",
    "version": 1,
    "activeVersion": 1,
    "enabled": true,
    "priority": 0,
    "configJson": "string",
    "status": "disabled",
    "consecutiveFailures": 0,
    "lastError": "string",
    "agentId": "string",
    "createdByAgentId": "string",
    "createdAt": "string",
    "updatedAt": "string"
  },
  "manifest": {
    "name": "string",
    "description": "string",
    "version": "string",
    "runtime": "api",
    "assets": {
      "hooks": "string",
      "skills": [
        "string"
      ],
      "workflows": [
        "string"
      ],
      "schedules": [
        "string"
      ]
    },
    "homepage": "http://example.com",
    "author": "string"
  },
  "files": {
    "property1": "string",
    "property2": "string"
  }
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
PATCH
/api/extensions/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string
Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X PATCH "http://localhost:3013/api/extensions/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "extension": {
    "id": "string",
    "name": "string",
    "description": "string",
    "runtime": "api",
    "manifestJson": "string",
    "contentHash": "string",
    "version": 1,
    "activeVersion": 1,
    "enabled": true,
    "priority": 0,
    "configJson": "string",
    "status": "disabled",
    "consecutiveFailures": 0,
    "lastError": "string",
    "agentId": "string",
    "createdByAgentId": "string",
    "createdAt": "string",
    "updatedAt": "string"
  }
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
POST
/api/extensions/{id}/activate-version

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string
Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "http://localhost:3013/api/extensions/string/activate-version" \  -H "Content-Type: application/json" \  -d '{    "version": 1  }'
{
  "extension": {
    "id": "string",
    "name": "string",
    "description": "string",
    "runtime": "api",
    "manifestJson": "string",
    "contentHash": "string",
    "version": 1,
    "activeVersion": 1,
    "enabled": true,
    "priority": 0,
    "configJson": "string",
    "status": "disabled",
    "consecutiveFailures": 0,
    "lastError": "string",
    "agentId": "string",
    "createdByAgentId": "string",
    "createdAt": "string",
    "updatedAt": "string"
  }
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
POST
/api/extensions/{id}/disable

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string
Length1 <= length

Response Body

application/json

application/json

application/json

curl -X POST "http://localhost:3013/api/extensions/string/disable"
{
  "extension": {
    "id": "string",
    "name": "string",
    "description": "string",
    "runtime": "api",
    "manifestJson": "string",
    "contentHash": "string",
    "version": 1,
    "activeVersion": 1,
    "enabled": true,
    "priority": 0,
    "configJson": "string",
    "status": "disabled",
    "consecutiveFailures": 0,
    "lastError": "string",
    "agentId": "string",
    "createdByAgentId": "string",
    "createdAt": "string",
    "updatedAt": "string"
  }
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
POST
/api/extensions/{id}/enable

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string
Length1 <= length

Response Body

application/json

application/json

application/json

application/json

curl -X POST "http://localhost:3013/api/extensions/string/enable"
{
  "extension": {
    "id": "string",
    "name": "string",
    "description": "string",
    "runtime": "api",
    "manifestJson": "string",
    "contentHash": "string",
    "version": 1,
    "activeVersion": 1,
    "enabled": true,
    "priority": 0,
    "configJson": "string",
    "status": "disabled",
    "consecutiveFailures": 0,
    "lastError": "string",
    "agentId": "string",
    "createdByAgentId": "string",
    "createdAt": "string",
    "updatedAt": "string"
  }
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
GET
/api/extensions/{id}/runs

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string
Length1 <= length

Query Parameters

limit?integer
Range1 <= value <= 500

Response Body

application/json

application/json

curl -X GET "http://localhost:3013/api/extensions/string/runs"
{
  "runs": [
    {
      "id": "string",
      "extensionId": "string",
      "version": 1,
      "event": "string",
      "action": "continue",
      "durationMs": 0,
      "message": "string",
      "agentId": "string",
      "subject": "string",
      "createdAt": "string"
    }
  ]
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
GET
/api/extensions/{id}/versions

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string
Length1 <= length

Response Body

application/json

application/json

curl -X GET "http://localhost:3013/api/extensions/string/versions"
{
  "versions": [
    {
      "id": "string",
      "extensionId": "string",
      "version": 1,
      "manifestJson": "string",
      "filesJson": "string",
      "contentHash": "string",
      "changedByAgentId": "string",
      "changedAt": "string",
      "changeReason": "string"
    }
  ]
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
POST
/api/extensions/install

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/extensions/install" \  -H "Content-Type: application/json" \  -d '{    "manifest": {      "name": "string",      "description": "string",      "version": "string",      "runtime": "api",      "assets": {        "hooks": "string"      }    },    "files": {      "property1": "string",      "property2": "string"    }  }'
{
  "extension": {
    "id": "string",
    "name": "string",
    "description": "string",
    "runtime": "api",
    "manifestJson": "string",
    "contentHash": "string",
    "version": 1,
    "activeVersion": 1,
    "enabled": true,
    "priority": 0,
    "configJson": "string",
    "status": "disabled",
    "consecutiveFailures": 0,
    "lastError": "string",
    "agentId": "string",
    "createdByAgentId": "string",
    "createdAt": "string",
    "updatedAt": "string"
  },
  "manifest": {
    "name": "string",
    "description": "string",
    "version": "string",
    "runtime": "api",
    "assets": {
      "hooks": "string",
      "skills": [
        "string"
      ],
      "workflows": [
        "string"
      ],
      "schedules": [
        "string"
      ]
    },
    "homepage": "http://example.com",
    "author": "string"
  },
  "contentDeduped": true
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
GET
/api/extensions/type-defs

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Response Body

curl -X GET "http://localhost:3013/api/extensions/type-defs"
Empty

Events

Stream and query swarm lifecycle events — task transitions, agent state changes, and audit log

External APIs

External APIs API endpoints