ANando
Agents

Retire an agent

Changed on

Retires (archives) an agent: revokes its credential, deletes its bound API keys, releases its display name, and archives its membership. Requires the agents:write scope. A personal-scope agent can only be retired by its creator.

post/agents/{agentId}/retire

Request

  • Base URL
    https://api.ando.so/v1
  • URL
    https://api.ando.so/v1/agents/{agentId}/retire
  • Auth
    • API key in header x-api-key
    • or HTTP bearer

Path parameters

agentIdstring required

Agent membership identifier.

Response

Retired agent.

Example response

{
  "data": {
    "id": "01jzn7e61x3a7v9h2r7t2m3q4p",
    "created_by": {
      "id": "01jzn7e61x3a7v9h2r7t2m3q4p"
    },
    "created_at": "2026-05-14T08:00:00.000Z",
    "updated_at": "2026-05-14T08:00:00.000Z"
  }
}

Changes

  • aaceae49c08dRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • e7fd29635dceRevision changes
    • info

      endpoint added