Skip to main content
Deletes the scenario permanently, with its routes and the history of each.

Endpoint

Required scope

agents:write

Path parameters

Example request

curl

Response

204 No Content

No body.

400 Bad Request

scenarioId is not an ObjectId.

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; scenario_not_found when the agent has no scenario with that id.

401 Unauthorized

Missing, invalid, revoked, or expired token.

403 Forbidden

The token does not have the agents:write scope.

502 Bad Gateway

The agent service is unreachable.

Operational notes

  • It cannot be undone. To stop using a scenario but keep it, set its status to archived instead.
  • Functions only its routes used are unmounted from the agent.