# Pandorabots AIaaS API

> Pandorabots AIaaS API on Apizie: 13 endpoints (Anonymous Talk, List of bots, List of bot files, Create a bot, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/ai:pandorabots/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `ai:pandorabots`
- Category: Artificial Intelligence
- Status: byok
- Source: https://pandorabots.com
- Page: https://zieapi.vercel.app/api/ai/pandorabots
- OpenAPI: https://zieapi.vercel.app/api/ai/pandorabots/openapi.json

AIaaS provides API access to our bot hosting platform and SDKs, allowing developers to easily integrate conversational interfaces into applications.

## Endpoints

### Anonymous Talk
`POST https://zieapi.vercel.app/v1/ai:pandorabots/atalk-bot` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| app_id | string | yes | Your Application ID |
| botname | string | yes | The name of the bot. Format required is 3-64 characters in length and only numbers or lower-case letters [0-9][a-z] |
| input | string | yes | Message to be sent to the bot. This can contain multiple sentences. Currently the limit is 500 characters. |
| client_name | string | no | Leave blank to request Pandorabots to create a client_name which will support persistent predicates. Including a valid client_name in this… |
| sessionid | string | no | Session ID generated by Pandorabots. This allows the application to group individual conversations into a collection as needed. If not… |
| recent | string | no | If true, the system will not signal an error if the bot is uncompiled, and will instead look for a previous version of the bot that is… |

### List of bots
`GET https://zieapi.vercel.app/v1/ai:pandorabots/list-bots` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| app_id | string | yes | Your Application ID |

### List of bot files
`GET https://zieapi.vercel.app/v1/ai:pandorabots/list-bot-files` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| app_id | string | yes | Your Application ID |
| botname | string | yes | The name of the bot. |
| return | string | no | If set to zip, a zip file with all bot files will be returned. |

### Create a bot
`POST https://zieapi.vercel.app/v1/ai:pandorabots/create-bot` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| app_id | string | yes | Your Application ID |
| botname | string | yes | Must be unique from all the other bots you have created under this app_id. Can only be numbers and lowercase letters, and must be between… |

### Delete a bot
`POST https://zieapi.vercel.app/v1/ai:pandorabots/delete-bot` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| app_id | string | yes | Your Application ID |
| botname | string | yes | Name of the bot to delete. |

### Compile a bot
`GET https://zieapi.vercel.app/v1/ai:pandorabots/compile-bot` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| app_id | string | yes | Your Application ID |
| botname | string | yes | Your bot's name |

### Retrieve a bot file (pdefaults, properties)
`GET https://zieapi.vercel.app/v1/ai:pandorabots/get-bot-file2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| app_id | string | yes | Your Application ID |
| botname | string | yes | Name of the bot. |
| file-kind | string | yes | Specify the type of file being retrieved: pdefaults, properties |

### Upload a bot file (pdefaults, properties)
`POST https://zieapi.vercel.app/v1/ai:pandorabots/upload-file2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| app_id | string | yes | Your Application ID |
| botname | string | yes | Your bot's name |
| file-kind | string | yes | Specify the type of file being uploaded: pdefaults, properties |
| body | string | yes | XML request body (string) |

### Delete a bot file (pdefaults, properties)
`POST https://zieapi.vercel.app/v1/ai:pandorabots/delete-bot-file2` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| app_id | string | yes | Your Application ID |
| botname | string | yes | Name of the bot. |
| file-kind | string | yes | Specify the type of file being deleted: pdefaults, properties |

### Retrieve a bot file (AIML, set, map, substitution)
`GET https://zieapi.vercel.app/v1/ai:pandorabots/get-bot-file1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| app_id | string | yes | Your Application ID |
| botname | string | yes | Name of the bot. |
| file-kind | string | yes | Specify the type of file being retrieved: file (for AIML files), map, substitution, set |
| filename | string | yes | Filename to retrieve. Note: for non-AIML files, do not include the file extension in the path. |

### Upload a bot file (AIML, set, substitution, map)
`POST https://zieapi.vercel.app/v1/ai:pandorabots/upload-file1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| app_id | string | yes | Your Application ID |
| botname | string | yes | Your bot's name |
| file-kind | string | yes | Specify the type of file being uploaded: file (for AIML files), map, substitution, set |
| filename | string | yes | Filename to upload, must be named with only lowercase letters and numbers. Note: for non-AIML files, do not include the file extension in… |
| body | string | yes | XML request body (string) |

### Delete a bot file (AIML, set, map, substitution)
`POST https://zieapi.vercel.app/v1/ai:pandorabots/delete-bot-file1` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| app_id | string | yes | Your Application ID |
| botname | string | yes | Name of the bot. |
| file-kind | string | yes | Specify the type of file being deleted: file (for AIML files), map, substitution, set |
| filename | string | yes | Filename to delete. Note: for non-AIML files, do not include the file extension in the path. |

### Debug a bot conversation
`POST https://zieapi.vercel.app/v1/ai:pandorabots/debug-bot` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| app_id | string | yes | Your Application ID |
| botname | string | yes | The name of the bot. Format required is 3-64 characters in length and only numbers or lower-case letters [0-9][a-z] |
| input | string | yes | Message to be sent to the bot. This can contain multiple sentences. Currently the limit is 500 characters. |
| client_name | string | no | Identifies your application's end user. You can assign each of your end users a unique client_name. This will allow you to set predicates… |
| sessionid | string | no | Session ID generated by Pandorabots. This allows the application to group individual conversations into a collection. While testing your… |
| that | string | no | For debugging purposes, you can specify a 'that' with the input that supersedes the existing that in bot memory. |
| topic | string | no | For debugging purposes, you can specify a 'topic' with the input that supersedes the existing topic in bot memory. |
| extra | string | no | Return extra conversation information. If true, input, pattern, that, topic, filename, and template associated with the pattern matched… |
| reset | string | no | Reset the bot memory. If true, all predicate values in the bot will be discarded, and the user can talk to the bot as if it is the first… |
| trace | string | no | Include trace data in the response. If true, the system will generate AIML trace information for the input. Trace data includes pattern… |
| reload | string | no | If true, the system will force a reload of the bot into memory. This can be useful if you've recently uploaded an AIML file, recompiled… |
| recent | string | no | If true, the system will not signal an error if the bot is uncompiled, and will instead look for a previous version of the bot that is… |

## Example
```
curl "https://zieapi.vercel.app/v1/ai:pandorabots/atalk-bot" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Pandorabots AIaaS API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/ai:pandorabots/atalk-bot with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Pandorabots AIaaS API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Pandorabots AIaaS itself also needs your own key from pandorabots.com.

### Can AI agents use the Pandorabots AIaaS API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key ai:pandorabots.

### What is the status of the Pandorabots AIaaS API?
Needs your own provider key (bring your own key)