Actora Developers

Build on the operating system for modern work.

Connect your apps to Tasks, CRM, Calendar, Inbox, and Roxx AI with a secure, workspace-scoped REST API.

Start here

Authentication

Every request is authenticated with a workspace-scoped Bearer API key. Create keys from the Developers area in your Actora workspace.

curl "$ACTORA_API_BASE_URL/api/v1/tasks" \
  -H "Authorization: Bearer actora_live_your_key"

Keys are hashed at rest and shown only once. Never commit a key to source control; store it in an environment variable.

REST API v1

REST API Reference

Predictable JSON endpoints with pagination, filtering, search, sorting, and workspace isolation.

GET/tasks

List and filter tasks

POST/tasks

Create a task

GET/tasks/:id

Retrieve a task

POST/roxx/chat

Stream a Roxx conversation

Roxx AI

AI-native APIs

Use Roxx as an execution layer for your own products. Send context, receive structured results, and keep authorization workspace-scoped.

POST /api/v1/roxx/chat
POST /api/v1/roxx/execute
POST /api/v1/roxx/workflows

Events

Webhooks

Receive signed events when work changes in Actora. Configure delivery URLs, event subscriptions, and retry behavior from the developer portal.

task.createdtask.completedcontact.createdmeeting.createdworkflow.completedai.execution.completed

Quickstarts

SDK examples

Copy a working request in the language your team already uses.

const response = await fetch("/api/v1/tasks", {
  headers: { Authorization: `Bearer ${process.env.ACTORA_API_KEY}` }
});
const { data } = await response.json();

Try it live

API Playground

Test a read-only API request from your browser. Your key is used only for this request and is never stored.

Reliability

Rate limits and changelog

Limits are applied per API key and workspace. Responses include Retry-After when a limit is reached.

Free

5 GB storage

250 calls / month

20 requests / minute

Pro

50 GB storage

1,500 calls / month

300 requests / minute

Team

250 GB storage

5,000 calls / month

500 requests / minute

Signed-in workspace usage, API key status, and usage history are available from Workspace Usage.

Changelog · v1.0

Public API foundation: API keys, Tasks endpoints, Roxx AI entrypoint, OpenAPI 3.1, usage tracking, and plan-aware rate limits.