Identity

Create/update a workspace with visitor identity; returns the session UUID to enter the workspace

post/api/workspace/join

Request

  • Base URL: https://www.capepartners.fr
  • URL: https://www.capepartners.fr/api/workspace/join
  • Auth: none required

Request body

uuidstring uuid required
namestring required
emailstring email required
companystring required
exchange_keystring

TIER-2 GATE. Required when an AGENT (no verified Turnstile token) is issued a NEW workspace UUID: the msgid from an ACCEPTED manifest, or its answer_key. The handshake precedes the UUID — without it the join is refused (403) and the agent keeps the tier-1 exchange inbox. A human-verified join and an existing workspace are exempt.

turnstileTokenstring

Optional Cloudflare Turnstile token from a human solving the widget on the Join form. If provided it must verify or the join is refused (403). An agent POSTing directly sends none and stays classified as an agent by the NDA email actor-gate.

Response

OK

session_idstring
uuidstring
namestring
emailstring
companystring
identity_recordedstring

human-verified | agent-declared and UNVERIFIED | delegate (the workspace keeps its human-bound principal)

delegatedboolean

True when the caller was recognised as the workspace principal's DISCLOSED DELEGATE and inherited the existing uuid

delegate_ofstring nullable

The principal address the delegation was proven against — an accepted manifest that names BOTH the address this workspace already carries AND (since the entity gate) an entity that is this workspace's own party, because one address can identify several workspaces

inherited_uuidboolean

True when this join adopted the existing workspace rather than being issued a new one

principalstring

Whether the principal is bound to this workspace, and by what

Changes

No recorded changes to this operation across all 1 revision of this API.