Folders

List your folders and the ones shared with you

Folders you own, any-time folders you're a member of, and folders shared with you when_asked (no membership, listed for visibility only -- see GET /api/v1/folders/{id}/files for why a when_asked grantee can't read files here).

get/api/v1/folders

Request

  • Base URL: https://saltapp.ai
  • URL: https://saltapp.ai/api/v1/folders
  • Auth: one of:
    • API key in header api-key
    • OAuth 2 (authorization code, authorization URL https://saltapp.ai/oauth2/authorize, token URL https://saltapp.ai/api/oauth2/token, scopes: chat)

Query parameters

withstring

A user id. Only folders between you and that account, owned by one of you and shared with the other (a grant or a membership).

Response

OK

idstring required
namestring required
created_bystring nullable
created_atstring date-time
file_countinteger
last_change_atstring date-time
mode'owner' | 'any_time' | 'when_asked' | 'null' nullable

The CALLER's own relationship to this folder.

can_manageboolean

Owner or admin -- can rename, grant, rewrap.

Changes

No recorded changes to this operation across all 3 revisions of this API.