Agent de l'espace de travail

Posez des questions sur cet espace de travail ou prévisualisez des ajouts uniquement.

API Web

La référence officielle pour les routes API utilisées par Organigram.ai. Contrairement aux références des packages, ces points de terminaison documentent la couche d'application elle-même, y compris les routes JSON au style RPC, les uploads, les rappels d'authentification, les webhooks et les intégrations côté serveur.

Conventions

La plupart des mutations d'application sont envoyées sous forme de POST requêtes avec un corps JSON contenant un action field.
Les routes d'upload et de webhook désactivent le parseur de corps par défaut de Next.js lorsqu'elles ont besoin de corps bruts ou multipart/form-data.
L'authentification varie selon la route : certains points de terminaison sont publics, tandis que d'autres nécessitent une session NextAuth, un jeton sans portefeuille ou un secret spécifique au fournisseur.

Routes d'action

/api

Point d'entrée RPC-style hérité qui délègue une action payload vers la route d'application concrète.

Champ	Valeur
Méthodes	`POST`
Auth	Dépend de l'action déléguée
Corps	Payload JSON avec un `action` champ
Notes	Préférez le chemin concret une fois que l'endpoint cible est connu.

/api/account

Opérations sur le compte, le profil et la vie privée pour l'utilisateur connecté actuel.

Champ	Valeur
Méthodes	`POST`
Auth	Session requise
Corps	Payload JSON avec un `action` champ
Notes	Accessible également via `/api` avec le même `action` payload.

Actions

Action	Auth	Description
`getProfile`	Session requise	Charge le profil attaché à l'utilisateur actuel.
`createProfile`	Session requise	Crée un profil pour l'utilisateur actuel.
`deleteUser`	Session requise	Supprime le compte utilisateur au nom de l'utilisateur actuel.
`updateProfile`	Session requise	Met à jour les champs du profil pour l'utilisateur actuel.
`getProfilePostalAddresses`	Session requise	Loads the current user postal-address sources.
`updatePrivacySettings`	Session requise	Persiste les paramètres de confidentialité de l'utilisateur actuel.
`getUserContacts`	Session requise	Retourne les contacts liés à l'utilisateur actuel.
`getNotificationPreferences`	Session requise	Loads the notification preferences attached to the current user.
`requestNotificationEmailVerification`	Session requise	Sends a verification code before persisting the account email address.
`updateNotificationPreferences`	Session requise	Persists notification event email toggles for the current user.
`verifyNotificationEmailCode`	Session requise	Validates an account email verification code for the current user.
`unlinkGoogleWorkspaceIdentity`	Session requise	Disconnects the current user Google Workspace identity and revokes administrator proofs.

/api/workspace

Lecture et mutations d'espace de travail, y compris les changements de membreship et de propriété.

Champ	Valeur
Méthodes	`POST`
Auth	Mélangé
Corps	Payload JSON avec un `action` champ
Notes	Accessible également via `/api` avec le même `action` payload.

Actions

Action	Auth	Description
`getWorkspace`	Accès public ou session-aware	Charge un espace de travail par son identifiant lorsque l'appelant est autorisé à le voir.
`getWorkspaceBySlug`	Accès public ou session-aware	Charge un espace de travail par son slug lorsque l'appelant est autorisé à le voir.
`createWorkspace`	Session requise	Crée un nouveau espace de travail personnel ou organisationnel pour l'utilisateur actuel.
`updateWorkspace`	Session requise	Met à jour les détails de l'espace de travail.
`deleteWorkspace`	Session requise	Supprime un espace de travail.
`removeUserFromWorkspace`	Session requise	Retire un membre d'un espace de travail.
`editUserRoleInWorkspace`	Session requise	Modifie le rôle d'un membre au sein d'un espace de travail.
`getWorkspaceUserEntries`	Session requise	Lists workspace member entry identities with encrypted profile content references only.
`getWorkspaceFiles`	Session requise	Lists workspace file metadata without exposing file contents.
`inviteWorkspaceMember`	Administrator session required	Emails a single-use link inviting someone to join some organs of the workspace.
`listWorkspaceInvitations`	Administrator session required	Lists pending workspace invitations and accepted ones.
`revokeWorkspaceInvitation`	Administrator session required	Deletes a workspace invitation.
`acceptWorkspaceInvitation`	Session requise	Joins the draft organs of a workspace invitation; deployed organs wait for a proposal.
`enableGoogleWorkspaceAccessForWorkspace`	Session requise	Allows users from a verified Google Workspace tenant to access a workspace.
`disableGoogleWorkspaceAccessForWorkspace`	Session requise	Revokes Google Workspace tenant access for a workspace without removing the verified administrator proof.

/api/organigram

Mutations d'organigramme, d'organe, de procédure, d'entrée et d'actif pour les utilisateurs authentifiés.

Champ	Valeur
Méthodes	`POST`
Auth	Session requise
Corps	Payload JSON avec un `action` champ
Notes	Accessible également via `/api` avec le même `action` payload.

Actions

Action	Auth	Description
`createOrganigramFromTemplate`	Session requise	Crée un organigramme à partir de données et d'options de modèle.
`getOrganigram`	Session requise	Récupère un organigramme par son identifiant.
`updateOrganigram`	Session requise	Enregistre les modifications de l'organigramme.
`mergeOrganigramJson`	Session requise	Fusionne le JSON importé de l'organigramme dans un organigramme existant.
`deleteOrganigram`	Session requise	Supprime un organigramme.
`retainGovernanceRecords`	Session requise	Archives the meetings and register records of an organigram so it can be deleted.
`saveDeployedOrganigram`	Session requise	Stocke les résultats de déploiement pour un organigramme.
`createOrgan`	Session requise	Crée un organe.
`updateOrgan`	Session requise	Mise à jour d'un organe.
`deleteOrgan`	Session requise	Suppression d'un organe.
`createProcedure`	Session requise	Création d'une procédure et de ses autorisations ciblées.
`updateProcedure`	Session requise	Mise à jour d'une procédure et de ses autorisations ciblées.
`deleteProcedure`	Session requise	Suppression d'une procédure.
`getEntryReference`	Session requise	Resolves an entry reference for the authenticated user without profile contents.
`getPrivateReference`	Session requise	Resolves an entry reference for the authenticated user without profile contents.
`deleteEntry`	Session requise	Supprime une entrée.
`createAsset`	Session requise	Crée un actif.
`updateAsset`	Session requise	Met à jour un actif.
`getAsset`	Session requise	Récupère un actif par adresse.
`addAssetToOrganigram`	Session requise	Lie un actif à un organigramme.
`deleteAsset`	Session requise	Retire un actif d'un organigramme.
`createOrganigramLayer`	Session requise	Creates an empty shared organigram layer.
`updateOrganigramLayer`	Session requise	Updates a shared organigram layer.
`reorderOrganigramLayers`	Session requise	Reorders shared organigram layers.
`deleteOrganigramLayer`	Session requise	Deletes a shared organigram layer.

/api/organization

Recherches d'organisation plus mutations d'organisation authentifiées.

Champ	Valeur
Méthodes	`POST`
Auth	Mélangé
Corps	Payload JSON avec un `action` champ
Notes	Accessible également via `/api` avec le même `action` payload.

Actions

Action	Auth	Description
`getPublicOrganizations`	Public	Affiche les organisations publiques.
`lookupCompany`	Public	Looks up a company in the national register of its country, from its registration number.
`listCompanyTrademarks`	Public	Lists the trademarks registered by a company, when the register of its country provides them.
`getCompanyStatutesAvailability`	Session requise	Checks whether public articles of association can be downloaded from the register of the company country.
`downloadCompanyStatutes`	Session requise	Downloads the latest public articles of association of a company from the register of its country.
`createOrganization`	Session requise	Crée une organisation pour l'utilisateur actuel.
`verifyOrganizationTaxId`	Administrator session required	Confirms the registration number of the organization by matching the verified identity of the requesting administrator against the officers listed in the company register of its country.
`listOrganizationMandates`	Administrator session required	Lists the active mandates by which RNE officers let administrators act on behalf of the company.
`revokeOrganizationMandate`	Verified RNE officer session required	Revokes a mandate and removes its holder from the administrators.
`inviteOrganizationOfficer`	Administrator session required	Emails a single-use link inviting an officer to join an organization whose SIREN is not verified yet.
`getOrganizationArchiveManifest`	Administrator session required	Returns everything Organigram reads in clear about the organization, for an export before deletion.
`inviteOrganizationDelegate`	Verified RNE officer session required	Emails a single-use link to someone who will administer the company under an officer mandate.
`listPendingDelegates`	Administrator session required	Lists invited delegates waiting for an officer to sign their mandate.
`appointOrganizationDelegate`	Verified RNE officer session required	Makes an invited delegate administrator with a mandate the officer signed with their wallet.
`acceptOrganizationInvitation`	Session requise	Joins an unverified organization as administrator with an invitation link.
`attachStatutesToReferenceOrgan`	Organization-member session required	Links an uploaded articles of association file to the reference bylaws organ.
`updateOrganization`	Session requise	Met à jour les métadonnées de l'organisation.
`updateOrganizationComplianceProfile`	Session requise	Updates organization legal, tax, and default governance settings.
`getOrganizationRegisterSituation`	Administrator session required	Returns whether the organization currently employs staff and processes personal data, as tracked by its conditional registers.
`updateOrganizationRegisterSituation`	Administrator session required	Updates whether the organization employs staff and processes personal data, refreshing the applicability of its conditional registers accordingly.
`setOrganizationOfficialOrganigram`	Session requise	Sets or clears the reference organigram used by organization pages.
`getCertifiedComplianceStatus`	Session requise	Calculates the current Certified compliance status and its private proof reports.
`saveCertifiedComplianceConfiguration`	Session requise	Stores the validated component addresses for the organization compliance profile.
`activateReferenceRegisters`	Administrator session required	Adds the missing reference-register layer without deploying it.
`getCertifiedComplianceReportForExport`	Administrator session required	Returns one private Certified report for administrator export.
`validateCertifiedSensitiveProposal`	Session requise	Verifies a proposed mutation of a Certified key organ before wallet signature.
`getOrganizationById`	Session requise	Récupère une organisation par son identifiant.
`getUserOrganizations`	Session requise	Liste les organisations liées à l'utilisateur actuel.

/api/subscription

Mises à jour des abonnements et recherches de factures pour l'utilisateur actuel ou le sponsor.

Champ	Valeur
Méthodes	`POST`
Auth	Session requise
Corps	Payload JSON avec un `action` champ
Notes	Accessible également via `/api` avec le même `action` payload.

Actions

Action	Auth	Description
`authorizeOrganizationOperation`	Session requise	Checks whether the current user can run an operation that requires an active Certified Entity.
`authorizeCertifiedProcedureUse`	Session requise	Checks whether the current user can use a Certified procedure.
`quoteSponsoredTransaction`	Session requise	Quotes the euro price of a sponsored transaction from a gas estimate.
`getEntityActivation`	Session requise	Syncs a confirmed Stripe intent for an organization, then returns its Certified Entity access state.
`reconcilePersonalBilling`	Session requise	Syncs the current user’s personal storage and transaction subscriptions from a confirmed Stripe intent.
`startCryptoEntitySubscription`	Session requise	Creates a Certified Entity Stripe invoice to be paid in EURC.
`getCryptoInvoicePayment`	Session requise	Returns the authenticated billing manager’s EURC payment request for a Stripe invoice.
`declareCryptoInvoicePayer`	Session requise	Declares, with its signature, the wallet that will send the EURC transfer for a Stripe invoice.
`submitCryptoInvoiceTransaction`	Session requise	Submits and verifies an Ethereum EURC transaction for an open Stripe invoice.
`reconcileCryptoInvoicePayment`	Session requise	Rechecks the submitted EURC transaction of a Stripe invoice and records its payment once confirmed.
`getBillingAddress`	Session requise	Returns the billing address of the current user or of an organization they manage.
`updateBillingAddress`	Session requise	Saves the billing address of the current user or of an organization they manage.
`getCryptoCredit`	Session requise	Returns the prepaid credit an organization billed in EURC holds for its next invoices.
`startCryptoCreditTopUp`	Session requise	Creates the EURC payment request that brings an organization prepaid credit up to a target of at least 5 €.
`renewCryptoInvoicePayment`	Session requise	Extends an expired EURC payment request for the same open Stripe invoice.
`updateSubscription`	Session requise	Mise à jour des paramètres d'abonnement.
`getIncomingInvoice`	Session requise	Retourne la prochaine facture Stripe pour l'identifiant client fourni.
`getPastInvoices`	Session requise	Liste les factures passées pour le client Stripe de l'utilisateur actuel.
`getSponsoredTransactions`	Session requise	Lists the latest transactions sponsored by an organization, for its billing managers.
`createBillingPortalSession`	Session requise	Returns a Stripe customer portal URL for an organization billing manager.
`deleteSubscription`	Session requise	Annule ou supprime un abonnement sponsor pour l'utilisateur actuel.

/api/notification

Notification reads, sync, and read-state mutations.

Champ	Valeur
Méthodes	`POST`
Auth	Session requise
Corps	Payload JSON avec un `action` champ
Notes	Accessible également via `/api` avec le même `action` payload.

Actions

Action	Auth	Description
`listNotifications`	Session requise	Lists the current user notifications and unread count.
`markNotificationRead`	Session requise	Marks one notification as read.
`markAllNotificationsRead`	Session requise	Marks all notifications as read.
`syncWorkspaceNotifications`	Session requise	Synchronizes proposal and asset notifications for one workspace.

/api/governance

Authenticated governance-case, register, document, and workflow operations for organization workspaces.

Champ	Valeur
Méthodes	`POST`
Auth	Session requise
Corps	Payload JSON avec un `action` field and, except for `getGovernanceBundle`, a `data` object

Actions

Action	Auth	Description
`getGovernanceBundle`	Session requise	Loads governance cases, register applicability, compliance tasks, and organization settings for an organigram.
`createGovernanceCase`	Session requise	Creates a governance case with an idempotency key.
`createRecurringAssembly`	Session requise	Creates a schedule that automatically creates governance-case drafts at each due date.
`deleteGovernanceCase`	Session requise	Permanently deletes a governance case before its first convocation, provided it has no linked on-chain proposal.
`deleteRecurringAssembly`	Session requise	Deletes a recurring assembly schedule without deleting its existing drafts.
`updateRecurringAssembly`	Session requise	Updates a recurring assembly schedule without changing its existing drafts.
`updateGovernanceCase`	Session requise	Updates an editable governance case and its agenda details.
`confirmGovernanceRules`	Session requise	Confirms and freezes the governance rules that apply to a case.
`transitionGovernanceCase`	Session requise	Moves a governance case through its lifecycle and triggers applicable workflow work.
`sendGovernanceConvocationErratum`	Session requise	Sends a corrected convocation to the case participants.
`upsertGovernanceParticipant`	Session requise	Creates or updates a governance-case participant and voting rights.
`synchronizeGovernanceParticipantsFromRights`	Session requise	Synchronizes governance-case participants from the organigram rights.
`upsertGovernanceDocument`	Session requise	Creates or updates a document attached to a governance case.
`upsertGovernanceResolution`	Session requise	Creates or updates an agenda resolution for a governance case.
`deleteGovernanceResolution`	Session requise	Deletes an agenda resolution from a governance case.
`prepareGovernanceMinutes`	Session requise	Prepares the governance-case minutes document.
`signGovernanceMinutes`	Session requise	Verifies and records the signature of the governance-case minutes.
`recordGovernanceProposalCreated`	Session requise	Links an on-chain proposal to a governance-case resolution.
`recordGovernanceProposalWorkflowEvent`	Session requise	Records an on-chain proposal workflow event for a governance case.
`recordGovernanceWorkflowProposalOutput`	Session requise	Records the on-chain proposal produced by a governance workflow.
`upsertRegisterApplicability`	Session requise	Confirms or updates whether a governance register applies to an organigram.
`createRegisterRecord`	Session requise	Adds a record to an applicable governance register.
`runGovernanceAutomation`	Session requise	Runs the governance automations currently due for the signed-in user.

/api/recurringProposal

Authenticated recurring-proposal schedule and worker-prepared draft operations for organization workspaces.

Champ	Valeur
Méthodes	`POST`
Auth	Session requise
Corps	Payload JSON avec un `action` field and a `data` object
Notes	Accessible également via `/api` avec le même `action` payload.

Actions

Action	Auth	Description
`getRecurringProposalBundle`	Session requise	Lists the caller’s recurring-proposal schedules and prepared drafts for the requested category.
`createRecurringProposal`	Session requise	Creates a reusable proposal template for a deployed procedure without creating an on-chain proposal.
`disableRecurringProposal`	Session requise	Disables a recurring proposal and cancels its unsubmitted prepared drafts.
`deleteRecurringProposal`	Session requise	Deletes a recurring proposal and its prepared drafts.
`runRecurringProposalAutomation`	Session requise	Prepares drafts for recurring proposals currently due and notifies their creator; it never signs or creates an on-chain proposal.
`markPreparedRecurringProposalSubmitted`	Session requise	Links a prepared recurring-proposal draft to the on-chain proposal created by its owner.

/api/equityTransfer

Collects the seller and buyer wallet signatures for an equity transfer before its governance proposal is created.

Champ	Valeur
Méthodes	`POST`
Auth	Session wallet must be either the seller or buyer named in the request, or a workspace member for buyer lookups and invitations
Corps	JSON body with an action and action-specific data
Notes	Accessible également via `/api` avec le même `action` payload.

Actions

Action	Auth	Description
`createSignatureRequest`	Session wallet must be either the seller or buyer named in the request, or a workspace member for buyer lookups and invitations	Creates a seller-signed request for a buyer wallet signature.
`getSignatureRequest`	Session wallet must be either the seller or buyer named in the request, or a workspace member for buyer lookups and invitations	Returns the request to its seller or buyer.
`signSignatureRequest`	Session wallet must be either the seller or buyer named in the request, or a workspace member for buyer lookups and invitations	Records the buyer wallet signature.
`listSellerSignatureRequests`	Session wallet must be either the seller or buyer named in the request, or a workspace member for buyer lookups and invitations	Lists open requests that a seller can turn into proposals.
`renderSignatureRequestPdf`	Session wallet must be either the seller or buyer named in the request, or a workspace member for buyer lookups and invitations	Generates the transfer agreement PDF for a participant.
`markSignatureRequestSubmitted`	Session wallet must be either the seller or buyer named in the request, or a workspace member for buyer lookups and invitations	Anchors both wallet signatures to the on-chain proposal transaction.
`listRegister`	Session wallet must be either the seller or buyer named in the request, or a workspace member for buyer lookups and invitations	Lists settled equity movements after verifying their ProposalApplied event.
`exportRegister`	Session wallet must be either the seller or buyer named in the request, or a workspace member for buyer lookups and invitations	Generates a private CSV or PDF extract of the register.
`listEligibleBuyers`	Session wallet must be either the seller or buyer named in the request, or a workspace member for buyer lookups and invitations	Lists KYC-verified users who explicitly share their information with the workspace or its organization.
`getInvitation`	Session wallet must be either the seller or buyer named in the request, or a workspace member for buyer lookups and invitations	Names the organization a transferee invitation link points to (invited wallet only).
`createInvitation`	Session wallet must be either the seller or buyer named in the request, or a workspace member for buyer lookups and invitations	Invites a wallet to have its identity verified at the organization's expense.

Téléchargements et actifs générés

/api/ipfs/[...workspaceId]

Télécharge un fichier de workspace vers IPFS et suit l'utilisation de stockage facturable.

Champ	Valeur
Méthodes	`POST`
Auth	Session avec accès au workspace requis
Corps	`multipart/form-data`
Notes	Le parseur de corps Next.js par défaut est désactivé pour ce route.

Opérations

Opération	Déclencheur	Auth	Description
`upload`		Session avec accès au workspace requis	Télécharge le premier fichier du payload multipart et retourne son nom de fichier et son CID.

/api/certifiedProof/[...workspaceId]

Génère, signe, stocke et facture un PDF certifié de preuve pour une transaction de workspace.

Champ	Valeur
Méthodes	`POST`
Auth	Session avec accès au workspace requis
Corps	Corps JSON contenant les données de preuve de transaction

Opérations

Opération	Déclencheur	Auth	Description
`create certified proof`		Session avec accès au workspace requis	Crée une preuve certifiée, télécharge le PDF signé et enregistre l'utilisation associée.

/api/agent/[...workspaceId]

Answers questions about a workspace and can return additive organigram previews.

Champ	Valeur
Méthodes	`GET`, `POST`
Auth	Session avec accès au workspace requis
Corps	`message` ou `messages` with optional `threadId`, `source`et, `currentOrganigramId`

Opérations

Opération	Auth	Description
`ask workspace agent`	Session avec accès au workspace requis	Builds a safe workspace snapshot, persists the exchange in a workspace thread, and asks the configured inference service for a structured answer.
`list workspace agent threads`	Session avec accès au workspace requis	Lists persisted workspace agent conversations for the signed-in user across workspaces.
`record workspace agent thread`	Session avec accès au workspace requis	Stores a workspace agent conversation created by another surface, such as the home hero.

Authentification, facturation et intégrations

/api/auth/[...nextauth]

Point de terminaison NextAuth utilisé pour le sign-in SIWE, la résolution de la session et les rappels d'authentification.

Champ	Valeur
Méthodes	`GET`, `POST`
Auth	Géré par NextAuth
Corps	Paramètres de requête ou données de formulaire spécifiques au fournisseur
Notes	Appuyé par le fournisseur de credentiel SIWE dans `lib/auth/server.ts`.