Common failures
Machine-facing auth routes use a consistent error envelope witherror.code, error.message, error.requestId, error.details, and error.docsUrl.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Shared MCPCloud machine-auth error envelope and common runtime auth failures.
error.code, error.message, error.requestId, error.details, and error.docsUrl.
{
"error": {
"code": "organization_id_required",
"message": "organizationId is required for API-key runtime token exchange.",
"requestId": "api_123",
"details": { "field": "organizationId" },
"docsUrl": "/docs/api#common-failures"
}
}
curl -X POST "$MCPFACTORY_BASE_URL/api/v1/runtime/auth/token" \
-H "Authorization: Bearer $MCPFACTORY_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "deploymentId": "dep_123" }'
{
"error": {
"code": "organization_id_required",
"message": "organizationId is required for API-key runtime token exchange.",
"requestId": "api_123"
}
}