Batch agentState lookup by workflow/practitioner ids
POST/agent/workflows/agent-state
Batch agentState lookup by workflow/practitioner ids
Request
Responses
- 200
- 400
- 404
- 422
- 502
- 503
OK - agentOS's response, passed through unchanged
Bad Request - missing or blank tenant-id, or the request body is not a well-formed JSON object with a non-empty workflowIds array of at most 200 string ids (the frontend's own agent-service.getWorkflowsAgentState never sends anything else -- see requireWorkflowIds's javadoc)
Not Found - agentOS integration is off, this tenant is not enrolled (tenant-level: the caller's own enrollment in the section's user list is not checked on this route, unlike every other agent-runs route -- see CredentialingAgentConfigGate.isAnySectionEnabledForTenant), or a workflowIds entry does not belong to the caller's tenant
Unprocessable Entity - agentOS's response, passed through unchanged (e.g. too_many_ids or invalid_ids)
Bad Gateway - a network/timeout failure reaching agentOS, or a genuine 5xx from agentOS itself
Service Unavailable - agentos_not_configured (no credential configured) or agentos_credential_unavailable (m2m mode: Auth0 unreachable and no still-valid cached token); api-layer never called agentOS