# 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.                   |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xenioo.com/xenioo-api/globa-platform-api/bots/backup-and-restore/backup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
