Validate Runtime Config

Validate agent/team configuration for a specific runtime.

This endpoint checks if the provided configuration is compatible with the selected runtime, including model validation and required fields.

Use this before creating or updating agents to ensure compatibility.

POST /api/v1/runtimes/validate

Validate Runtime Config

cURL

curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/runtimes/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "runtime_type": "<string>",
  "model_id": "<string>",
  "agent_config": {},
  "system_prompt": "<string>"
}
'

200

{
  "valid": true,
  "errors": [
    "<string>"
  ]
}

Authorizations

Authorization · string · header · required

Enter your Kubiya API token (format: Bearer )

Body

application/json

Request to validate agent configuration for a runtime

runtime_type · string · required

Runtime type to validate for

model_id · string | null

Model ID to validate

agent_config · Agent Config · object

Agent configuration

system_prompt · string | null

System prompt

Response

200

application/json

Successful Response

Response from validation

valid · boolean · required

Whether configuration is valid

errors · string[]

Validation errors if any