Check agent readiness

GET/v1/agents/{agent_id}/readiness

Check the agent bound to the connection key. Use the exact ID from setup in the URL.

curl "https://app.actera.dev/v1/agents/$ACTERA_AGENT_ID/readiness" \
  --header "Authorization: Bearer $ACTERA_API_KEY"

const readiness = await agent.getReadiness()

Response

Returns 200 OK with the connection’s agent and readiness:

{
  "agent_id": "agent-from-connection-setup",
  "status": "DISCOVERED",
  "ready": true
}

A registered agent can be ready to send decisions before its policy setup is complete. Status DISCOVERED or ACTIVE can therefore have ready: true.

This check does not confirm that policies cover an action, that the fallback is appropriate, or that the application enforces the result. Verify those with controlled decision requests.

An ID different from the connection’s agent returns 404. Missing or invalid authentication returns 401; a caller without an agent connection can receive 403. Temporary failures return 503 and can be retried.

If setup is incomplete or the key needs replacement, open the agent’s Connection panel.