Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.whatabot.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Introduction

The whatabot REST API lets you programmatically manage conversation sessions, flows, workspaces, sectors, and OAuth clients. All v1 endpoints are accessible through standard HTTP requests that return JSON responses.

​
Base URL

All v1 API requests are made to: 
https://api.whatabot.app/api/v1

​
Response Format

All responses are returned as JSON. Successful responses use standard HTTP status codes (200, 201, 202, 204). Error responses follow this format: 
{
  "statusCode": 400,
  "message": "Validation failed",
  "error": "Bad Request"
}

​
Pagination

List endpoints support pagination via query parameters:
ParameterTypeDefaultDescription
pageinteger0Page number (0-based)
sizeinteger10Items per page
Paginated responses include: 
{
  "content": [...],
  "totalElements": 42,
  "totalPages": 5,
  "number": 0,
  "size": 10,
  "first": true,
  "last": false
}

​
Authentication

All v1 endpoints use API Key authentication via the X-Api-Key header: 
curl -X GET "https://api.whatabot.app/api/v1/flows" \
  -H "X-Api-Key: wh_your_api_key_here"
See the Authentication page for instructions on how to create your API key.

​
Quick Reference

Authentication

API keys and iframe authentication.

Webhooks

Receive session notifications via callback.

Sessions

Create and manage conversation sessions.

Flows

Create and list conversation flows.

Workspaces

Manage workspaces.

Sectors

Manage sectors for transfers.