Skip to main content
Lists the scenarios of an agent in index order, each with its routes. Scenarios only drive an agent whose engine is scenarios; on turn they are kept but mount nothing.

Endpoint

Required scope

agents:read

Path parameters

Example request

curl

Response

200 OK

404 Not Found

AGENT_NOT_FOUND when the agent belongs to another project of the company, UPSTREAM_ERROR (message AGENT_NOT_FOUND) when no agent has that id in the company.

401 Unauthorized

Missing, invalid, revoked, or expired token.

403 Forbidden

The token does not have the agents:read scope.

502 Bad Gateway

The agent service is unreachable.

Operational notes

  • Send updated_at back as expected_updated_at when you edit a scenario or route you read here, so a concurrent change fails with 409 instead of being overwritten.
  • Routes come whole: steps, cases and the current version.