Skip to Content
API ReferenceOpenAPI SpecsAgent Config Service

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:

FormatURL
Swagger UIhttp://localhost:8010/docs 
ReDochttp://localhost:8010/redoc 
OpenAPI JSONhttp://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 PathService Path
GET /api/v1/prompts/namespacesGET /prompts/namespaces
POST /api/v1/prompts/render/agents:rule_37_system_promptPOST /prompts/render/agents:rule_37_system_prompt
GET /api/v1/settingsGET /settings
PUT /api/v1/settings/user-overrides/{user_id}PUT /settings/user-overrides/{user_id}

Key Models

ModelDescription
NamespaceResponseNamespace with key, display name, auto_approve, approvers, classification
TierResponseBudget tier with key, max_tokens
TemplateDetailResponseTemplate with active version body included
VersionResponseVersion with body, validation_result, status, targeting
ValidationResultSchemaSyntax, subset, injection, token, variable analysis
ConflictResponsePre-prod conflict with existing version details and resolution options
AuditVerifyResponseHMAC verification summary with tampered entry list
PlatformSettingsResponseTenant settings row + resolved effective values + sources map + the caller’s user_override
PlatformSettingsUpdatePUT /settings body — every field optional; null clears back to inherit
ModelOptionCurated model picker entry (LiteLLM id, label, provider, context window)
UserBudgetOverridePer-user daily token/cost caps
Last updated on