---
title: "Revoke an agent"
method: DELETE
path: "/agent-delegations/{delegationId}"
tags: ["agent-auth"]
---

# Revoke an agent

`DELETE /agent-delegations/{delegationId}`

## Request

- Base URL: `https://api.letsship.ai/v1`
- URL: `https://api.letsship.ai/v1/agent-delegations/{delegationId}`
- Auth: HTTP bearer

Revokes one of your own delegations. Every access token issued under it stops working at once, and its identity assertion can no longer be exchanged. Another member's delegation reads as not found.

## Path parameters

- `delegationId` string, required

## Response `200`

Revoked.

- RevokeAgentDelegationResult
  - `kind` 'revoked' | 'already-revoked', required
  - `delegationId` string, required
  - `revokedAt` integer, required
  - `revokedTokens` integer, required: Live access tokens that stopped working with it.

## Other responses

- `404`: No such delegation of yours.

---

[API](https://skmtc.dev/letsship/apis/ship-api.md) · [All operations](https://skmtc.dev/letsship/apis/ship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/letsship/apis/ship-api/revisions/e6eac1bcadd4?raw)