files

List the authenticated user's uploaded files in the request's workspace.

workspace_id narrows a master-key listing to one workspace; a keyed request is already confined to its key's own and cannot widen or move it.

Each flavor pages with its own cursor. OpenAI's after names the last file of the previous page, and has_more says whether to ask again. Anthropic's next_page is passed back as page, and ids[] reads up to 100 named files in one page. A cursor whose file has since been deleted or has expired is still a position. An after the caller never owned is a 404, and a page token this gateway did not issue is a 400.

get/api/v1/files

Request

  • The document declares no server URL.
  • Auth: one of:
    • API key in header Otari-Key
    • API key in header x-api-key

Query parameters

userstring nullable
purposestring nullable
workspace_idstring uuid nullable
limitinteger
afterstring nullable
order'asc' | 'desc'
pagestring nullable
ids[]string[] nullable

Response

Successful Response

OR

Changes

    • info

      added the optional property to the response with the status

    • breaking

      the response's body type changed from object to no type for status

    • info

      added to the response body anyOf list for the response status