Soft-delete an agent

DELETE

/v1/agents/{id}

const url = 'https://example.com/v1/agents/example';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

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://example.com/v1/agents/example \
  --header 'Authorization: Bearer <token>'

Sets the agent’s status to inactive. The record is preserved for audit; it is no longer invocable.

Authorizations

oidcBearer

Parameters

Path Parameters

required

string

The agt_<uuidv7> agent ID.

Responses

204

Deleted.

401

Missing or invalid bearer token, or the token’s tenant/user claims are absent. No body.

404

No resource with this ID exists in the caller’s tenant.

application/json

The uniform error body for all 4xx responses that carry one.

object

error

required

A coarse, caller-safe message. Never contains internal state (invariant