# ReadyToTalk API — Skills Manifest

## What is ReadyToTalk?

ReadyToTalk is an AI receptionist platform that answers inbound calls for businesses.
Via this API you can manage your receptionist's configuration, knowledge base,
call history, billing, and account settings programmatically.

## Authentication

All requests (except this skills file) require a Personal Access Token:

```
Authorization: Bearer rtt_<your_token>
```

Generate a token at **Settings → API Access** in the ReadyToTalk dashboard.

> **Security warning:** This token grants full account access.  Do not share
> it publicly, commit it to source control, or include it in screenshots.

## Base URL

```
https://uat-backend.readyto.talk
```

## Endpoints

### Authentication
| Method | Path | Description |
|--------|------|-------------|
| GET DELETE | `/api/v1/auth/users/me/` | Get or delete the authenticated user's profile |

### PAT Management
| Method | Path | Description |
|--------|------|-------------|
| GET POST | `/api/v1/auth/pats/` | List or create Personal Access Tokens |
| DELETE | `/api/v1/auth/pats/{pk}/` | Revoke a Personal Access Token |

### Business
| Method | Path | Description |
|--------|------|-------------|
| GET | `/api/v1/businesses/{business_id}/dashboard/` | Dashboard stats (calls, bookings, missed) |
| POST | `/api/v1/businesses/{business_id}/assistant/` | Provision or update the AI assistant |
| GET | `/api/v1/businesses/{business_id}/assistant/prompt/` | Preview the active AI assistant prompt |
| POST | `/api/v1/businesses/{business_id}/phone-number/` | Provision a dedicated phone number |
| POST | `/api/v1/businesses/{business_id}/forward-instructions/` | Send call-forwarding instructions to carrier |
| GET PATCH | `/api/v1/businesses/{pk}/` | Business settings and receptionist config |

### Calls
| Method | Path | Description |
|--------|------|-------------|
| GET | `/api/v1/businesses/{business_id}/calls/` | List paginated call history |
| GET | `/api/v1/businesses/{business_id}/calls/{call_id}/` | Get call details and transcript |

### Knowledge Base
| Method | Path | Description |
|--------|------|-------------|
| POST | `/api/v1/businesses/analyze/` | Analyze or scrape a website for knowledge base content |
| POST | `/api/v1/businesses/analyze/files/` | Upload files to the knowledge base |

### Billing
| Method | Path | Description |
|--------|------|-------------|
| GET | `/api/v1/billing/{business_id}/subscription/` | Get subscription details |
| GET | `/api/v1/billing/{business_id}/credits/` | Get credit balance |
| GET | `/api/v1/billing/{business_id}/payment-method/` | Get the payment method on file |
| POST | `/api/v1/billing/{business_id}/portal/` | Open the Stripe billing portal |

### Reference
| Method | Path | Description |
|--------|------|-------------|
| GET | `/api/v1/master/meta-prompts/` | List available receptionist styles |
| GET | `/api/v1/master/vapi-languages/` | List supported languages |
| GET | `/api/v1/master/vapi-voices/` | List available AI voices |

## Interactive Docs

Full OpenAPI schema: `https://uat-backend.readyto.talk/api/schema/`
Swagger UI: `https://uat-backend.readyto.talk/api/docs/`