RESOURCES · API REFERENCE

API reference

A REST API over the same tenant-scoped data your team uses in the app. Authenticate with a scoped API key; every write is audit-logged just like the UI.

Base URL

https://api.universalai.com/v1

Authentication

Create an API key in Settings → API (Professional plan and above). Pass it as a bearer token. Keys are scoped to your workspace and to the permissions of the role that issued them.

curl https://api.universalai.com/v1/crm/leads \
  -H "Authorization: Bearer sk_live_..."

Conventions

JSON everywhere

Requests and responses are JSON. Errors return an errors[] array with a code and message.

Cursor pagination

List endpoints return nextCursor; pass it back as ?cursor= to page.

Rate limits

Default 600 requests/min per workspace. Limit and remaining are returned in response headers.

Webhooks

Subscribe to events (lead.created, invoice.paid, ...) and receive signed POSTs to your endpoint.

Draft-first, from the API too

AI write actions triggered through the API follow the same rule as the UI: they land as drafts until approved, unless the agent has been granted scoped autonomy. Everything is written to the audit log.

Full endpoint docs live in the documentation. Questions: support@universalai.com.