Revoke a connected agent

DELETE

/api/v1/agent-connections/{id}

const url = 'https://api.deploybase.eu/api/v1/api/v1/agent-connections/example';
const options = {method: 'DELETE', headers: {Authorization: '<Authorization>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://api.deploybase.eu/api/v1/api/v1/agent-connections/example \
  --header 'Authorization: <Authorization>'

Revokes one of the active team’s agent connections and every token of it; the agent must sign in again. Anyone may revoke an agent they connected themselves; revoking another person’s agent needs the admin or owner role. Requires a signed-in person: API keys and agent tokens are refused with HUMAN_SESSION_REQUIRED.

Authorizations

BearerAuth

Parameters

Path Parameters

required

string

Agent connection ID (UUID)

Responses

204

Revoked

401

Unauthorized

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

403

HUMAN_SESSION_REQUIRED or FORBIDDEN

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

404

AGENT_CONNECTION_NOT_FOUND

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

500

Internal Server Error

object

code

string

details

error

string

meta

object

request_id

string

timestamp

string

trace_id

string

Live a8b7eb1d built 2026-10-20