> ## Documentation Index
> Fetch the complete documentation index at: https://docs.staging.relayapp.im/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents

> Delete an existing developer-managed agent with its Agent Token.

Delete an existing developer-managed Agent (one with no organization) with its Agent Token.
Create and manage organization Agents through [Relay Console](https://docs.staging.relayapp.im/console/agents.md)
or the [CLI creation guide](https://docs.staging.relayapp.im/agents/create-agent.md).

## The Agent object

The agent object uses the contact card fields with `kind: "agent"`.

| Field | Type | Description |
| - | - | - |
| `first_name` | string | First name on the contact card. |
| `last_name` | string or null | Last name on the contact card. |
| `image_url` | string or null | Contact image URL, or null. |
| `is_active` | boolean | Whether this contact card is active. |
| `handle` | string | Relay Handle associated with this contact card. |
| `kind` | string | Whether the Contact is a user or an agent. |

## Example

Example response from `GET /v1/contact_card`:

```json theme={null}
{
  "handle": "example_agent",
  "kind": "agent",
  "first_name": "Example Agent",
  "last_name": null,
  "image_url": null,
  "is_active": true
}
```

## Operations

| Method | Path | What it does |
| - | - | - |
| `DELETE` | [`/v1/agents/{handle}`](https://docs.staging.relayapp.im/api-reference/agents/delete-an-agent) | Delete an agent |

## Errors

Common authentication, validation, and server errors apply alongside resource errors. Read `error.message` for the rejected condition.

[1005](https://docs.staging.relayapp.im/api-reference/errors.md#1005), [2001](https://docs.staging.relayapp.im/api-reference/errors.md#2001), [2003](https://docs.staging.relayapp.im/api-reference/errors.md#2003), [2004](https://docs.staging.relayapp.im/api-reference/errors.md#2004), [2008](https://docs.staging.relayapp.im/api-reference/errors.md#2008), [3006](https://docs.staging.relayapp.im/api-reference/errors.md#3006).

## Next steps

* [API overview](https://docs.staging.relayapp.im/api-reference/overview.md)
* [Error codes](https://docs.staging.relayapp.im/api-reference/errors.md)
* [Receive events](https://docs.staging.relayapp.im/events.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.