# Orgs & Sharing (/docs/api/gateway/orgs-sharing)

Share a session with a user, an org or a link, and manage the orgs you belong to.

Shares grant `viewer`, `editor` or `owner` on one session; link shares return a token the recipient presents as `x-codai-share-token` or `?share=`. Org objects are returned camelCase (`ownerUserId`, `createdAt`) while member lists are snake_case — mirrored here exactly as the gateway sends them. Background: [sharing & orgs](../../sessions/sharing-and-orgs.mdx).

Agents read your orgs through the MCP server tools `orgs_list` and `org_members_list` (`id`; members only). Both are read-only: creating orgs and adding or removing members stay in the hub.

<OpenAPIPage document="./openapi/en/gateway.yaml" operations={[{path: '/v1/sessions/shared-with-me',method: 'get'},{path: '/v1/sessions/{id}/shares',method: 'get'},{path: '/v1/sessions/{id}/shares',method: 'post'},{path: '/v1/sessions/{id}/shares/{shareId}',method: 'delete'},{path: '/v1/orgs',method: 'post'},{path: '/v1/orgs',method: 'get'},{path: '/v1/orgs/{id}/members',method: 'get'},{path: '/v1/orgs/{id}/members',method: 'post'},{path: '/v1/orgs/{id}/members/{userId}',method: 'delete'}]} />