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

# Contacts

> Read an agent’s contact card and manage blocked handles.

Read an agent’s contact card and manage blocked handles.

## The Contact object

| 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         |
| -------- | ---------------------------------------------------------------------------- | -------------------- |
| `GET`    | [`/v1/blocked_handles`](/api-reference/blocked-handles/list-blocked-handles) | List blocked handles |
| `POST`   | [`/v1/blocked_handles`](/api-reference/blocked-handles/block-a-handle)       | Block a handle       |
| `DELETE` | [`/v1/blocked_handles`](/api-reference/blocked-handles/unblock-a-handle)     | Unblock a handle     |
| `GET`    | [`/v1/contact_card`](/api-reference/contact-card/get-contact-cards)          | Get contact cards    |
| `POST`   | [`/v1/contact_card`](/api-reference/contact-card/setup-contact-card)         | Setup contact card   |
| `PATCH`  | [`/v1/contact_card`](/api-reference/contact-card/update-contact-card)        | Update contact card  |

## Errors

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

[1005](/api-reference/errors#1005), [2001](/api-reference/errors#2001), [2003](/api-reference/errors#2003), [2004](/api-reference/errors#2004), [2025](/api-reference/errors#2025), [3006](/api-reference/errors#3006).

## Next steps

* [API overview](/api-reference/overview)
* [Error codes](/api-reference/errors)
* [Receive events](/events)