Agent Config Service — OpenAPI
The agent-config-service exposes endpoints for prompt template management, versioning, lifecycle, runtime resolution, skill/capability/rule configuration, (R36) skill routers — the recruitment taxonomy behind message-driven skill selection (/skill-routers, /skill-routers/manifest, /skill-routers/disambiguation, /skill-routers/{id}/mappings, /skills/{skill_id}/description-versions) — and platform settings, the tenant LLM runtime config (/settings, /settings/model-options, /settings/user-overrides). See Agent Config Service for the endpoint tables.
Accessing the Spec
When the service is running locally on port 8010:
| Format | URL |
|---|---|
| Swagger UI | http://localhost:8010/docs |
| ReDoc | http://localhost:8010/redoc |
| OpenAPI JSON | http://localhost:8010/openapi.json |
Route Prefix
Through the API gateway, the prompt endpoints are prefixed with /api/v1/prompts/ and the platform-settings endpoints with /api/v1/settings.
| Gateway Path | Service Path |
|---|---|
GET /api/v1/prompts/namespaces | GET /prompts/namespaces |
POST /api/v1/prompts/render/agents:rule_37_system_prompt | POST /prompts/render/agents:rule_37_system_prompt |
GET /api/v1/settings | GET /settings |
PUT /api/v1/settings/user-overrides/{user_id} | PUT /settings/user-overrides/{user_id} |
Key Models
| Model | Description |
|---|---|
NamespaceResponse | Namespace with key, display name, auto_approve, approvers, classification |
TierResponse | Budget tier with key, max_tokens |
TemplateDetailResponse | Template with active version body included |
VersionResponse | Version with body, validation_result, status, targeting |
ValidationResultSchema | Syntax, subset, injection, token, variable analysis |
ConflictResponse | Pre-prod conflict with existing version details and resolution options |
AuditVerifyResponse | HMAC verification summary with tampered entry list |
PlatformSettingsResponse | Tenant settings row + resolved effective values + sources map + the caller’s user_override |
PlatformSettingsUpdate | PUT /settings body — every field optional; null clears back to inherit |
ModelOption | Curated model picker entry (LiteLLM id, label, provider, context window) |
UserBudgetOverride | Per-user daily token/cost caps |
Last updated on