L'API publique et le MCP server sont live.

API REST publique

api.freelance-os.fr, versionnée en /v1. 177 opérations sur 26 domaines, en lecture et en écriture. Tu t'authentifies avec une clé X-API-Key (partenaires, scripts, mobile) ou un jeton de session (web et mobile). Avec une clé, le workspace est déduit tout seul. Sinon tu le passes dans le chemin {workspaceId}. Les réponses arrivent en { data } et chaque erreur a un code stable. Spec OpenAPI 3.1 et référence interactive : 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é : nouveaux essais, pagination, limites de débit

Pensé pour des clients mobiles sur un réseau instable. Envoie un en-tête Idempotency-Key sur tes POST, PATCH et DELETE : un nouvel essai rejoue la même réponse sans créer de doublon. Les grosses listes (contacts, entrées, inbox, appels) se paginent au curseur. Passe cursor et lis pagination.next_cursor jusqu'à ce que has_more vaille false. Limite de 120 requêtes par minute, avec les en-têtes X-RateLimit-* sur chaque réponse.

• Idempotency-Key : un nouvel essai ne crée pas de doublon, 409 si le même appel est encore en cours
• Pagination curseur keyset : { data, pagination: { next_cursor, has_more } }
• Rate-limit 120 req/min, 429 au dépassement

Serveur MCP

Un serveur MCP hébergé. Tu connectes Freelance OS à Claude Code, Cursor, ChatGPT ou Claude Desktop en une commande, depuis Réglages > MCP. Plus de 200 outils et une connexion OAuth 2.1. Les actions destructives demandent ta validation. Chaque workspace a son journal d'audit.

• 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 longue durée liées à un workspace depuis Réglages > Clés API. Format fos_sk_live_<token>, permissions (read:* / write:* / *) et expiration optionnelle. La clé ne s'affiche qu'une seule fois.

Webhooks

Prévu pour le T3 2026. Tu configures des URLs cibles par workspace et tu choisis les événements à recevoir. Chaque envoi est signé et relancé en cas d'échec. L'historique des événements sera visible dans Réglages > 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