# Backup

This endpoint will generate a full backup of the token bot. This call is identical to the call you can make from the Xenioo UI.

{% hint style="info" %}
Backup calls are throttled at 1 call per bot per hour. Trying to backup a bot before the expired hour will result in an error.
{% endhint %}

### Request

The following request will return a full bot backup:

```bash
curl --location --request GET 'https://<SERVICE ENDPOINT>/bots/backup' \
--header 'Authorization: Bearer <BOT_AUTH_TOKEN>' \
--header 'Content-Type: application/json'
```

### Response

If successful, the response will contain the raw bot backup information. This data can be used for follow up calls to restore or save to a file that can be used on the UI restore functionality.

### Response Codes

This endpoint will reply with the following standard HTTP codes.

| Code | Meaning                                                                         |
| ---- | ------------------------------------------------------------------------------- |
| 200  | Ok. The request has been successfully fulfilled.                                |
| 400  | Bad Request. The supplied token is invalid or does not have enough permissions. |
| 404  | Not Found. The bot specified by the token could not be found.                   |