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

# API versioning and deprecation

> Learn how Tella versions its public API and announces deprecated endpoints and sunset dates.

# API versioning and deprecation

The Tella Public API is versioned in the URL. The current version uses the `/v1` base path:

```text theme={null}
https://api.tella.com/v1
```

## Compatibility

Tella may add backward-compatible fields, endpoints, and optional parameters to the current API version without changing the version number. Breaking changes are released under a new version.

## Deprecation process

When Tella deprecates an API version or operation, we:

1. Document its replacement and mark the affected operation as deprecated in the [OpenAPI specification](/docs/openapi.json).
2. Include the standard `Deprecation` header in responses from the deprecated endpoint.
3. Publish the removal date in the documentation and include a `Sunset` header once that date is scheduled.
4. Keep the deprecated endpoint available through its published sunset date.

## Migrating from a deprecated endpoint

Monitor the `Deprecation` and `Sunset` response headers, then move to the documented replacement before the sunset date. Contact [Tella support](mailto:support@tella.com) if you need help planning a migration.


## Related topics

- [Embed API](/docs/embed-api.md)
- [Public API and webhooks](/docs/help/integrations/public-api-and-webhooks.md)
- [Media library API](/docs/media-library-api.md)
- [Create and manage API keys](/docs/help/integrations/api-keys.md)
- [Set up webhooks](/docs/help/integrations/set-up-webhooks.md)