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

# API Reference Overview

> Overview of the Morphic API endpoints.

## Base URL

All API requests use the following base URL:

```
https://api.morphic.io/api
```

## Request format

* All request bodies must be JSON with `Content-Type: application/json`
* File uploads use `Content-Type: multipart/form-data`
* UUIDs are used for all resource identifiers

## Authentication

Include your API key in every request:

<CodeGroup>
  ```bash cURL theme={null}
  curl -H "X-API-Key: sk_your_api_key_here"
  ```

  ```python Python theme={null}
  headers = {"X-API-Key": "sk_your_api_key_here"}
  ```

  ```javascript JavaScript theme={null}
  const headers = { "X-API-Key": "sk_your_api_key_here" };
  ```
</CodeGroup>

## Response format

All responses return JSON. Successful responses return the resource directly or a paginated wrapper:

```json theme={null}
// Single resource
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "full_name": "Jane Smith",
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-02-20T14:00:00Z"
}
```

```json theme={null}
// Paginated list
{
  "items": [],
  "total": 42,
  "page": 1,
  "page_size": 25,
  "total_pages": 2
}
```

## Common patterns

| Pattern        | Example                                 |
| -------------- | --------------------------------------- |
| List resources | `GET /api/contacts?page=1&page_size=25` |
| Get by ID      | `GET /api/contacts/{id}`                |
| Create         | `POST /api/contacts`                    |
| Update         | `PUT /api/contacts/{id}`                |
| Delete         | `DELETE /api/contacts/{id}`             |
| Bulk delete    | `POST /api/contacts/bulk-delete`        |

## Endpoint groups

| Group           | Prefix                 | Description             |
| --------------- | ---------------------- | ----------------------- |
| Contacts        | `/api/contacts`        | People in your CRM      |
| Companies       | `/api/companies`       | Organizations and teams |
| Deals           | `/api/deals`           | Sales pipeline deals    |
| Activities      | `/api/activities`      | Calls, meetings, tasks  |
| Notes           | `/api/notes`           | Notes on entities       |
| Favorites       | `/api/favorites`       | Bookmarked records      |
| Email Drafts    | `/api/email-drafts`    | Email drafts            |
| Email Templates | `/api/email-templates` | Email templates         |
| Knowledge Base  | `/api/kb`              | KB documents            |
| Chats           | `/api/chats`           | AI chat conversations   |