# API reference

> Reference for every public Botyard REST API endpoint, grouped by resource, with request and response schemas rendered from the OpenAPI spec.

Canonical URL: https://docs.botyard.io/docs/api

The Botyard REST API. All endpoints are versioned under `/v1` and authenticate via
[`Authorization: Bearer <api-key>`](/docs/api/authentication).

Want to try a call instead of reading about it? The
[interactive API console](/api-docs) renders the same surface from the live spec and sends
real requests straight from your browser.

- [Addons](/docs/api/addons)
- [Api keys](/docs/api/api-keys)
- [Approvals](/docs/api/approvals)
- [Audit events](/docs/api/audit-events)
- [Bot access](/docs/api/bot-access)
- [Bot apps](/docs/api/bot-apps)
- [Bot devices](/docs/api/bot-devices)
- [Bot files](/docs/api/bot-files)
- [Bot memory](/docs/api/bot-memory)
- [Bot model settings](/docs/api/bot-model-settings)
- [Bot templates](/docs/api/bot-templates)
- [Bot tool domain settings](/docs/api/bot-tool-domain-settings)
- [Bot tools](/docs/api/bot-tools)
- [Bots](/docs/api/bots)
- [Centrifugo](/docs/api/centrifugo)
- [Challenge](/docs/api/challenge)
- [Chat](/docs/api/chat)
- [Content blocks](/docs/api/content-blocks)
- [Conversations](/docs/api/conversations)
- [Credentials](/docs/api/credentials)
- [Device enrollment](/docs/api/device-enrollment)
- [External chat](/docs/api/external-chat)
- [File templates](/docs/api/file-templates)
- [Files](/docs/api/files)
- [Github](/docs/api/github)
- [Health](/docs/api/health)
- [Inbound emails](/docs/api/inbound-emails)
- [Inbox](/docs/api/inbox)
- [Inbox public](/docs/api/inbox-public)
- [Integration logins](/docs/api/integration-logins)
- [Integrations economic](/docs/api/integrations-economic)
- [Integrations github](/docs/api/integrations-github)
- [Integrations oauth](/docs/api/integrations-oauth)
- [Integrations vending](/docs/api/integrations-vending)
- [Invitations](/docs/api/invitations)
- [Managed credits](/docs/api/managed-credits)
- [Mcp catalog public](/docs/api/mcp-catalog-public)
- [Mcp servers](/docs/api/mcp-servers)
- [Me](/docs/api/me)
- [Members](/docs/api/members)
- [Notification preferences](/docs/api/notification-preferences)
- [Notifications](/docs/api/notifications)
- [Org apps](/docs/api/org-apps)
- [Org settings](/docs/api/org-settings)
- [Organizations](/docs/api/organizations)
- [Outbound emails](/docs/api/outbound-emails)
- [Pack avatars](/docs/api/pack-avatars)
- [Packs](/docs/api/packs)
- [Per user claude](/docs/api/per-user-claude)
- [Permissions](/docs/api/permissions)
- [Plans](/docs/api/plans)
- [Push registrations](/docs/api/push-registrations)
- [Questions](/docs/api/questions)
- [Realtime](/docs/api/realtime)
- [Routing](/docs/api/routing)
- [Schedules](/docs/api/schedules)
- [Secret policies](/docs/api/secret-policies)
- [Service alert](/docs/api/service-alert)
- [Skills](/docs/api/skills)
- [Spend](/docs/api/spend)
- [Sso](/docs/api/sso)
- [Stats](/docs/api/stats)
- [Subscriptions](/docs/api/subscriptions)
- [Suggestions](/docs/api/suggestions)
- [Tools](/docs/api/tools)
- [Usage](/docs/api/usage)
- [User view](/docs/api/user-view)
- [Users](/docs/api/users)
- [Vault entries](/docs/api/vault-entries)
- [Vault input requests](/docs/api/vault-input-requests)
- [Wallet](/docs/api/wallet)
- [Workforce task files](/docs/api/workforce-task-files)
- [Workforces](/docs/api/workforces)