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

# API v1.0 (legacy)

> The historical Shortext API. Still served, no longer developed, and going away.

> [!WARNING]
>
> **v1.0 is legacy and will be removed.** It receives no new features. Its deprecation and sunset dates will be announced through the `Deprecation` and `Sunset` response headers; after the sunset date, every v1.0 call answers HTTP 410 with `code` `1200`. Build new integrations on [v2.0](https://docs.shortext.ny-corp.io/api-reference/introduction.md) and [migrate](https://docs.shortext.ny-corp.io/api-reference/guides/migrate-to-v2.md) existing ones.

## Base URL

```text theme={null}
https://shortext.ny-corp.io/api
```

v1.0 endpoints are served without a version prefix, for example `POST https://shortext.ny-corp.io/api/messages/send`. Responses carry `X-Shortext-Api-Version: v1.0`.

## Authentication

The same company API keys as v2.0, as a bearer token: `Authorization: Bearer {key}`. **v1.0 does not check the permissions of the key.**

## Responses

The same envelope as v2.0: HTTP 200 with `success`, `code`, `message`, `body` and, on failures, `trace_id`. See [Errors](https://docs.shortext.ny-corp.io/api-reference/errors.md). Lists are paginated with `?page=`.

## Endpoints

| Endpoint | Use | v2.0 replacement |
| - | - | - |
| `POST /messages/send` | Send a message to a contact | `POST /conversations`, `POST /conversations/{id}/messages` |
| `GET /agent/search` | List agents | `GET /agents` |
| `GET /business-manager/balance` | Company balance | None yet |
| `GET /ticket/search`, `/ticket/sla/search`, `/ticket/status/search` | Tickets, SLAs and statuses | None yet |
| `POST /contact/knowledge/add` | Add knowledge about a contact | None yet |
| `POST /v1.0/messages/inbound` | Shortext endpoint inbound messages | Still current, see [Shortext endpoint](https://docs.shortext.ny-corp.io/api-reference/shortext-endpoint.md) |

The reference of each endpoint is in **Endpoints**.


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