***

title: Legacy & Deprecated APIs
description: 'Moveworks API lifecycle stages, from stable through legacy and deprecated'
----------------------------------------------------------------------------------------

Moveworks APIs follow a defined lifecycle. Understanding each stage helps you plan integrations and migrations.

## API Lifecycle Stages

| Stage          | What it means                                                             | Support level                                   | Example                            |
| -------------- | ------------------------------------------------------------------------- | ----------------------------------------------- | ---------------------------------- |
| **Stable**     | Actively supported, maintained, and improved                              | Full support, bug fixes, new features           | Events API, Webhooks API, Data API |
| **Legacy**     | Works and existing functionality is preserved, but no future improvements | Maintained, no new features                     | Message API                        |
| **Deprecated** | Not expected to work. If it does, that's a fluke.                         | No support, no bug fixes, scheduled for removal | Beta API endpoints                 |

## Stable APIs

Stable APIs are the current, recommended endpoints for building integrations. These are actively supported and receive ongoing improvements.

For versioned releases, Moveworks may publish alpha and beta endpoints to select pilot customers before promoting them to stable. See [API Release Management](/api-reference/api-release-management) for details on the versioning process.

## Legacy APIs

Legacy APIs continue to function and existing behavior is preserved. However, Moveworks will not make future improvements or add new features to these endpoints.

If you are currently using a legacy API, your integration will continue to work. We recommend migrating to the stable equivalent when possible.

### Legacy endpoints

#### `POST /rest/v1/messages/send`

The V1 Messages API is considered legacy. It continues to function, but no further enhancements will be made.

## Deprecated APIs

<Warning>
  Deprecated APIs are not expected to work. Errors will not be addressed and customers should not use these endpoints. They are scheduled for removal.
</Warning>

### Deprecated endpoints

#### `POST /rest/v1beta1/messages/send`

This endpoint was deprecated as of **January 31, 2023**.

To migrate, switch all instances of this endpoint to:

```
https://api.moveworks.ai/rest/v1/messages/send
```

<Note>
  You will still be able to use your current Message API Key.
</Note>

## Experimental APIs

<Warning>
  Experimental APIs are subject to change or deprecation with advance notice of at least 14 days.
</Warning>

Moveworks publishes bleeding-edge capabilities to select pilot customers through beta endpoints. Beta endpoints are denoted by their version path.

For example, `https://api.moveworks.ai/rest/v2beta3/*` represents the 3rd beta iteration of the V2 API.