user

Get Current User Workspaces

Retrieve the list of workspaces associated with the current authenticated user. Includes wrapped_key, stats (conversation/document counts with shared/private breakdown), and users for each workspace. All data is fetched efficiently using batch queries to avoid N+1 problems. Leverages RLS to enforce access control.

get/api/user/workspaces

Response

Successful Response

external_idstring required
namestring required
descriptionstring nullable required
is_publicboolean required
created_by_ext_idstring required
updated_by_ext_idstring nullable
created_atstring date-time required
updated_atstring date-time required
wrapped_keystring nullable
shared_conversation_countinteger
private_conversation_countinteger
shared_document_countinteger
private_document_countinteger
user_files_mbnumber

Changes

Changed in 5 of the 34 revisions of this API.9118

  • b91e4b449d56515See the full diff
    • removed the required property items/users/items/email from the response with the 200 status

      response-required-property-removed

    • removed the required property items/users/items/encryption_public_key from the response with the 200 status

      response-required-property-removed

    • removed the required property items/users/items/external_id from the response with the 200 status

      response-required-property-removed

    • removed the required property items/users/items/family_name from the response with the 200 status

      response-required-property-removed

    • removed the required property items/users/items/given_name from the response with the 200 status

      response-required-property-removed

    • removed the optional property items/users/items/picture from the response with the 200 status

      response-optional-property-removed

    • added the optional property items/users/items/conversation_count to the response with the 200 status

      response-optional-property-added

    • added the optional property items/users/items/document_count to the response with the 200 status

      response-optional-property-added

    • added the required property items/users/items/joined_at to the response with the 200 status

      response-required-property-added

    • added the required property items/users/items/role to the response with the 200 status

      response-required-property-added

    • added the required property items/users/items/user to the response with the 200 status

      response-required-property-added

    This revision also has 8 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • aa4b06f8dede45See the full diff
    • the response property items/updated_by_ext_id became optional for the status 200

      response-property-became-optional

    • removed the required property items/users/items/last_name from the response with the 200 status

      response-required-property-removed

    • removed the required property items/users/items/name from the response with the 200 status

      response-required-property-removed

    • removed the required property items/users/items/user_ext_id from the response with the 200 status

      response-required-property-removed

    • added the optional property items/users/items/picture to the response with the 200 status

      response-optional-property-added

    • added the required property items/users/items/encryption_public_key to the response with the 200 status

      response-required-property-added

    • added the required property items/users/items/external_id to the response with the 200 status

      response-required-property-added

    • added the required property items/users/items/family_name to the response with the 200 status

      response-required-property-added

    • added the required property items/users/items/given_name to the response with the 200 status

      response-required-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the optional property items/user_files_mb to the response with the 200 status

      response-optional-property-added

    • added the optional property items/private_conversation_count to the response with the 200 status

      response-optional-property-added

    • added the optional property items/private_document_count to the response with the 200 status

      response-optional-property-added

    • added the optional property items/shared_conversation_count to the response with the 200 status

      response-optional-property-added

    • added the optional property items/shared_document_count to the response with the 200 status

      response-optional-property-added

    • added the optional property items/users to the response with the 200 status

      response-optional-property-added

    • added the optional property items/wrapped_key to the response with the 200 status

      response-optional-property-added

    This revision also has 8 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the required property items/is_public to the response with the 200 status

      response-required-property-added