L'API publique et le MCP server sont live.

API REST publique

api.freelance-os.fr, versionnee /v1. Auth par cle X-API-Key (partners, scripts, mobile) ou Bearer JWT Supabase (web). Workspace scoping automatique sur les cles, header X-Workspace-Id sur les JWT. Rate-limit 120 req/min sliding window. Reference Scalar live : api.freelance-os.fr/v1/docs.

• Contacts et lifecycle stages
• Drafts Studio (CRUD + publish)
• Pipeline CRM et activity timeline
• Devis, contrats, factures Counsel
• Taches et projets Workbench
• Bookings et event types

Serveur MCP

Un Model Context Protocol server hebergé. Tu connectes Freelance OS a Claude Code, Cursor, ChatGPT, Claude Desktop, en une commande depuis /settings/mcp. 92+ tools, OAuth 2.1 + DCR, JIT approval sur les actions destructives, audit log par workspace.

• Recherche full-text dans tous les modules
• Creation de drafts depuis l'agent
• Lecture des transcripts d'appels Fathom
• Mutation des deals et taches
• Workflows multi-modules orchestres

Cles API

Genere des cles long-lived workspace-scopees depuis /settings/api-keys. Format fos_sk_live_<token>, hashes sha256 en DB, scopes (read:* / write:* / *), expiration optionnelle. Le plaintext s'affiche une seule fois.

Webhooks

Roadmap T3 2026. Configure des URLs cibles par workspace, choisis les evenements a recevoir. Payload signe. Retry exponentiel. Logs d'evenements visibles dans /settings/webhooks.

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

SDK

Client TypeScript auto-genere depuis la spec OpenAPI (hey-api/openapi-ts), type end-to-end. Pour les autres langages, utilise la spec OpenAPI 3.1 a api.freelance-os.fr/v1/openapi.json avec ton generateur prefere.