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

# API Reference

> Deepslate REST API for managing voice AI assistants and agents

## Base URL

```
https://app.deepslate.eu
```

## Authentication

All API endpoints require Bearer token authentication:

```bash theme={null}
curl -X GET "https://app.deepslate.eu/api/v1/vendors/{vendorId}/organizations/{organizationId}/assistants" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

## Response format

All responses follow a consistent structure:

```json theme={null}
{
  "success": true,
  "message": "Human-readable message",
  "data": { },
  "timestamp": "2025-04-17T14:23:30Z",
  "traceId": "correlation-id"
}
```

### Paginated responses

List endpoints return paginated data:

```json theme={null}
{
  "success": true,
  "data": [],
  "page": 0,
  "size": 20,
  "totalElements": 100,
  "totalPages": 5,
  "timestamp": "2025-04-17T14:23:30Z"
}
```

## Pagination parameters

| Parameter | Type    | Default    | Description                       |
| --------- | ------- | ---------- | --------------------------------- |
| `page`    | integer | 0          | Page number (0-indexed)           |
| `size`    | integer | 20         | Items per page                    |
| `sort`    | string  | `name,asc` | Sort criteria (e.g., `name,desc`) |

## Path parameters

All resource endpoints use UUID identifiers:

* `vendorId` - Vendor identifier
* `organizationId` - Organization identifier
* `assistantId` - Assistant identifier
* `agentId` - Agent identifier

## Error responses

| Status | Description                                                       |
| ------ | ----------------------------------------------------------------- |
| 400    | Bad Request - Invalid input data                                  |
| 401    | Unauthorized - Invalid or missing token                           |
| 403    | Forbidden - Insufficient permissions                              |
| 404    | Not Found - Resource does not exist                               |
| 409    | Conflict - Resource cannot be modified (e.g., dependencies exist) |