L'API publique et le MCP server sont live.

API REST publique

api.freelance-os.fr, versionnée /v1. 177 opérations sur 26 domaines, en lecture et en écriture. Auth par clé X-API-Key (partners, scripts, mobile) ou jeton de session JWT (web et mobile). Le workspace est scopé automatiquement sur les clés, passé dans le path {workspaceId} sinon. Réponses en { data }, erreurs typées avec un code stable. Spec OpenAPI 3.1 et référence interactive live : api.freelance-os.fr/v1/docs.

• CRM : contacts, deals, segments, vue 360, interactions
• Workbench : projets, tâches, milestones, KPIs
• Counsel : devis, contrats, factures et lignes
• Booking et calendrier agrégé : agenda du jour, vue semaine et mois
• Inbox : threads, messages, conversations
• Studio, Collections, Programme, Products, Analytics
• Email, Calls, Webinars, LinkedIn, AI Visibility, Copilot
• Identity, plans publics, gestion des clés API

Fiabilité : idempotence, pagination, rate-limit

Pensé pour des clients mobiles et natifs sur réseau instable. Envoie un header Idempotency-Key sur tes POST, PATCH et DELETE : un retry rejoue la même réponse au lieu de créer en double. Les grosses listes (contacts, entrées, inbox, appels) se paginent au curseur : passe cursor et lis pagination.next_cursor jusqu'à has_more à false. Rate-limit 120 req/min en sliding window, headers X-RateLimit-* sur chaque réponse.

• Idempotency-Key : dedup des retries, 409 si un même appel est déjà en cours
• Pagination curseur keyset : { data, pagination: { next_cursor, has_more } }
• Rate-limit 120 req/min, 429 au dépassement

Serveur MCP

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

• Recherche full-text dans tous les modules
• Création de drafts depuis l'agent
• Lecture des transcripts d'appels
• Mutation des deals et tâches
• Workflows multi-modules orchestrés

Clés API

Génère des clés long-lived workspace-scopées 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 événements à recevoir. Payload signé. Retry exponentiel. Logs d'événements visibles dans /settings/webhooks.

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

Connecter ton site

Branche n'importe quel site externe sur un formulaire Freelance OS sans refaire de back. Publie le formulaire, ajoute le domaine de ton site dans les origines autorisées du formulaire, puis copie les deux snippets depuis la page du formulaire : le POST vers /api/forms/submit (les leads tombent dans le CRM, les actions notif interne et confirmation prospect se déclenchent côté FOS) et le pixel px.js pour le tracking. Chaque formulaire est isolé par workspace, l'allowlist CORS aussi : deux workspaces ne se voient jamais.

• Origines autorisées : éditeur du formulaire, réglages, domaines
• Snippet submit + pixel : page du formulaire, à copier-coller
• GET /api/forms/schema?formId=... renvoie la forme des champs (id, label, type, options)
• Vérifie ton mapping au build de ton site pour bloquer toute dérive du formulaire

SDK

Client TypeScript auto-généré depuis la spec OpenAPI, type end-to-end. Pour les autres langages, utilise la spec OpenAPI 3.1 à api.freelance-os.fr/v1/openapi.json avec ton générateur préféré.