Connector API
REST endpoints for external management of agents, versions, and traffic routing
Connector API
Token-authenticated management endpoints for orchestration platforms, CI/CD pipelines, and external dashboards
Authentication Required
All /connector/* endpoints require a bearer token via Authorization: Bearer $CONNECTOR_TOKEN. Configure with AGENTFIELD_CONNECTOR_TOKEN.
Manifest
List Reasoners
Requires capability: reasoners:read
Get Reasoner
Requires capability: reasoners:read
List Versions
Requires capability: versions:read
Get Version
Requires capability: versions:read
Set Traffic Weight
Requires capability: versions:write
Restart Version
Requires capability: restart
List Groups
Requires capability: reasoners:read
List Group Nodes
Requires capability: reasoners:read
Capabilities Reference
| Capability | Endpoints |
|---|---|
reasoners:read | GET /connector/reasoners, GET /connector/reasoners/:id, GET /connector/groups, GET /connector/groups/:groupId |
reasoners:write | (reserved for future use) |
versions:read | GET /connector/reasoners/:id/versions, GET /connector/reasoners/:id/versions/:version |
versions:write | PUT /connector/reasoners/:id/versions/:version/weight |
restart | POST /connector/reasoners/:id/versions/:version/restart |
Related
- Connector Guide — Setup, authentication, and CI/CD integration
- Multi-Versioning Guide — Deployment patterns and traffic management
- Environment Variables — Full configuration reference