Sign in
Files

List all files

Returns a list of the files that your account has access to. orq.ai sorts and returns the files by their creation dates, placing the most recently created files at the top.

get/v2/files

Query parameters

limitinteger

Page size. Unset uses the server default.

starting_afterstring

Cursor for forward pagination. Set to the file_id of the last item from the previous page.

ending_beforestring

Cursor for backward pagination. Set to the file_id of the first item from the previous page.

project_idstring
purposestring

Restrict results to files declared with this purpose. Accepts a purpose alias (retrieval, knowledge_datasource, batch, code_interpreter) or canonical FILE_PURPOSE_* name case-insensitively. Omit to list files of every purpose.

Response

OK

objectstring required

Object discriminator for list responses; always list.

has_moreboolean required

Whether more files are available in the selected pagination direction.

Changes

Changed in 8 of the 254 revisions of this API.44

  • a6dba2e590b51See the full diff
    • ○

      added the new optional query request parameter purpose

      new-optional-request-parameter

  • 2f27caf6888c1See the full diff
    • ●

      added the new FILE_PURPOSE_CODE_INTERPRETER enum value to the data/items/purpose response property for the response status 200

      response-property-enum-value-added

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

  • bee257c5b2481See the full diff
    • ○

      removed the FILE_PURPOSE_CODE_INTERPRETER enum value from the data/items/purpose response property for the response status 200

      response-property-enum-value-removed

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

  • 801f61a5a0561See the full diff
    • ●

      added the new FILE_PURPOSE_CODE_INTERPRETER enum value to the data/items/purpose response property for the response status 200

      response-property-enum-value-added

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

  • 42d5d20625271See the full diff
    • ○

      removed the FILE_PURPOSE_CODE_INTERPRETER enum value from the data/items/purpose response property for the response status 200

      response-property-enum-value-removed

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

  • 8ecb8a66eb1d1See the full diff
    • ●

      added the new FILE_PURPOSE_CODE_INTERPRETER enum value to the data/items/purpose response property for the response status 200

      response-property-enum-value-added

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

  • 5f95063ab4fd1See the full diff
    • ○

      removed the FILE_PURPOSE_CODE_INTERPRETER enum value from the data/items/purpose response property for the response status 200

      response-property-enum-value-removed

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

  • 320d42e024f21See the full diff
    • ●

      added the new FILE_PURPOSE_CODE_INTERPRETER enum value to the data/items/purpose response property for the response status 200

      response-property-enum-value-added

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

Of the 254 revisions, 71 have no diff computed.