The public API and MCP server are live.

Public REST API

api.freelance-os.fr, versioned /v1. Auth via X-API-Key (partners, scripts, mobile) or Bearer Supabase JWT (web). Keys are workspace-scoped automatically, JWTs use X-Workspace-Id header. 120 req/min sliding window rate limit. Live Scalar reference at api.freelance-os.fr/v1/docs.

• Contacts and lifecycle stages
• Studio drafts (CRUD + publish)
• CRM pipeline and activity timeline
• Counsel quotes, contracts, invoices
• Workbench tasks and projects
• Bookings and event types

MCP server

A hosted Model Context Protocol server. Wire Freelance OS to Claude Code, Cursor, ChatGPT, Claude Desktop in one command from /settings/mcp. 92+ tools, OAuth 2.1 + DCR, JIT approval on destructive actions, per-workspace audit log.

• Full-text search across all modules
• Draft creation from the agent
• Read Fathom call transcripts
• Mutate deals and tasks
• Orchestrated multi-module workflows

API keys

Generate long-lived workspace-scoped keys from /settings/api-keys. Format fos_sk_live_<token>, sha256-hashed at rest, scopes (read:* / write:* / *), optional expiration. The plaintext shows once.

Webhooks

Roadmap Q3 2026. Set target URLs per workspace, pick the events you want. Signed payloads. Exponential retry. Event logs visible in /settings/webhooks.

• contact.lifecycle_stage_changed
• deal.stage_changed
• invoice.paid
• booking.created
• draft.published

SDK

Auto-generated TypeScript client from the OpenAPI spec (hey-api/openapi-ts), end-to-end typed. For other languages, use the OpenAPI 3.1 spec at api.freelance-os.fr/v1/openapi.json with your preferred generator.