AGagentsky

Delete the agent — only with zero live sessions (409 agent_has_sessions) [admin]

Changed on

An agent that never had a session is deleted (outcome deleted). One whose sessions were all deleted is archived instead (outcome archived), so their history keeps naming it: it stays readable, is listed with archived: true, and starts no new sessions — the same state POST /agents/{id}/archive leaves.

delete/agents/{id}

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/agents/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

The agent id (agent_…)

Response

OK

oktrue required
outcome'deleted' | 'archived' required

Changes

  • e5e8f0229a99Revision changes
    • breaking

      the response property const value true was removed for the status

    • warning

      added the new true enum value to the response property for the response status

    • info

      added the optional property / to the response with the status

    • info

      the response property became required for the status

    • info

      the response property / became required for the status

    • info

      the response property / became required for the status

    • info

      added the required property to the response with the status