agent-swarm.devagent-swarm.dev

Config

Read and write swarm configuration values — global, agent-scoped, and repo-scoped settings

GET
/api/config

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Query Parameters

scope?string
scopeId?string
includeSecrets?string
Value in"true" | "false"

Response Body

application/json

curl -X GET "http://localhost:3013/api/config"
{
  "configs": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "scope": "global",
      "scopeId": "string",
      "key": "string",
      "value": "string",
      "isSecret": true,
      "envPath": "string",
      "description": "string",
      "createdAt": "string",
      "lastUpdatedAt": "string",
      "encrypted": true
    }
  ],
  "message": "string"
}
PUT
/api/config

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

curl -X PUT "http://localhost:3013/api/config" \  -H "Content-Type: application/json" \  -d '{    "scope": "global",    "key": "string"  }'
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "scope": "global",
  "scopeId": "string",
  "key": "string",
  "value": "string",
  "isSecret": true,
  "envPath": "string",
  "description": "string",
  "createdAt": "string",
  "lastUpdatedAt": "string",
  "encrypted": true
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
DELETE
/api/config/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Response Body

application/json

application/json

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

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Query Parameters

includeSecrets?string
Value in"true" | "false"

Response Body

application/json

application/json

curl -X GET "http://localhost:3013/api/config/string"
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "scope": "global",
  "scopeId": "string",
  "key": "string",
  "value": "string",
  "isSecret": true,
  "envPath": "string",
  "description": "string",
  "createdAt": "string",
  "lastUpdatedAt": "string",
  "encrypted": true,
  "message": "string"
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
GET
/api/config/env-presence

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Query Parameters

keys*string
Length1 <= length

Response Body

application/json

application/json

curl -X GET "http://localhost:3013/api/config/env-presence?keys=string"
{
  "presence": {
    "property1": true,
    "property2": true
  }
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
POST
/api/config/reload

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

curl -X POST "http://localhost:3013/api/config/reload" \  -H "Content-Type: application/json" \  -d '{}'
{
  "success": true,
  "configsLoaded": 0,
  "keysUpdated": [
    "string"
  ],
  "integrationsReinitialized": [
    "string"
  ]
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
GET
/api/config/resolved

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Query Parameters

agentId?string
repoId?string
includeSecrets?string
Value in"true" | "false"

Response Body

application/json

curl -X GET "http://localhost:3013/api/config/resolved"
{
  "configs": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "scope": "global",
      "scopeId": "string",
      "key": "string",
      "value": "string",
      "isSecret": true,
      "envPath": "string",
      "description": "string",
      "createdAt": "string",
      "lastUpdatedAt": "string",
      "encrypted": true
    }
  ],
  "message": "string"
}