Files

List files

Changed on

Returns a list of files.

get/files

Request

  • Base URL
    https://api.openai.com/v1
  • URL
    https://api.openai.com/v1/files
  • Auth
    HTTP bearer

Query parameters

purposestring

Only return files with the given purpose.

limitinteger

A limit on the number of objects to be returned. Limit can range between 1 and 10,000, and the default is 10,000.

order'asc' | 'desc'

Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order.

afterstring

A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.

Response

OK

objectstring required
first_idstring required
last_idstring required
has_moreboolean required

Example response

{
  "object": "list",
  "first_id": "file-abc123",
  "last_id": "file-abc456"
}

Changes

  • e2f8d8cbc41fRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • 7eddcd50e394Revision changes
    • breaking

      the response property // became nullable for the status