Assistants

List runs

Returns a list of runs belonging to a thread.

get/threads/{thread_id}/runs

Path parameters

thread_idstring required

The ID of the thread the run belongs to.

Query parameters

limitinteger

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

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.

beforestring

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

Response

objectstring required

first_idstring required

last_idstring required

has_moreboolean required

Example response

{
  "object": "list",
  "first_id": "run_abc123",
  "last_id": "run_abc456"
}

Changes

Changed in 10 of the 163 revisions of this API.21226

Sep 3, 20269430b00d75b41See the full diff
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Aug 14, 20266ac2618eefd71See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
May 13, 202674cbcf73838f83See the full diff
- ▲
  response property data/items/metadata list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/response_format/oneOf[subschema #4: JSON schema]/json_schema/strict list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/tools/items/oneOf[subschema #3: Function tool]/function/strict list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property data/items/truncation_strategy/allOf[subschema #1: Thread Truncation Controls]/last_messages list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  the // response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ○
  added subschema #1 subschema #2 to the // response property anyOf list for the response status
  response-property-any-of-added
- ○
  the response's property default value false was removed for the status
  response-property-default-value-removed
- ○
  the response's property default value false was removed for the status
  response-property-default-value-removed
This revision also has 40 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 11, 20256ab43fe7798e21See the full diff
- ▲
  the response property // became nullable for the status
  response-property-became-nullable
- ▲
  added subschema #1 to the // response property oneOf list for the response status
  response-property-one-of-added
- ○
  removed subschema #2 from the // response property allOf list for the response status
  response-property-all-of-removed
Jan 31, 2025fc164a27fdb9215See the full diff
- ▲
  the // response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ○
  added subschema #2 to the // response property allOf list for the response status
  response-property-all-of-added
- ○
  added subschema #2 to the // response property allOf list for the response status
  response-property-all-of-added
- ○
  added subschema #2 to the // response property allOf list for the response status
  response-property-all-of-added
- ○
  removed subschema #1 from the // response property oneOf list for the response status
  response-property-one-of-removed
- ○
  removed subschema #1 from the // response property oneOf list for the response status
  response-property-one-of-removed
Jan 31, 202515156e46769c65See the full diff
- ▲
  the response property // became nullable for the status
  response-property-became-nullable
- ▲
  the response property // became nullable for the status
  response-property-became-nullable
- ▲
  the response property // became nullable for the status
  response-property-became-nullable
- ▲
  added subschema #1 to the // response property oneOf list for the response status
  response-property-one-of-added
- ▲
  added subschema #1 to the // response property oneOf list for the response status
  response-property-one-of-added
- ▲
  the // response's property type changed from no type to object for status
  response-property-type-changed
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  removed subschema #2 from the // response property allOf list for the response status
  response-property-all-of-removed
- ○
  removed subschema #2 from the // response property allOf list for the response status
  response-property-all-of-removed
- ○
  removed subschema #2 from the // response property allOf list for the response status
  response-property-all-of-removed
- ○
  added the required property /// to the response with the status
  response-required-property-added
Jan 22, 2025bdebcdfcbbde215See the full diff
- ▲
  the // response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  removed the required property /// from the response with the status
  response-required-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ○
  added subschema #2 to the // response property allOf list for the response status
  response-property-all-of-added
- ○
  added subschema #2 to the // response property allOf list for the response status
  response-property-all-of-added
- ○
  added subschema #2 to the // response property allOf list for the response status
  response-property-all-of-added
- ○
  removed subschema #1 from the // response property oneOf list for the response status
  response-property-one-of-removed
- ○
  removed subschema #1 from the // response property oneOf list for the response status
  response-property-one-of-removed
Sep 13, 20244c9e3967c7071See the full diff
- ○
  the response property /////// became required for the status
  response-property-became-required
Aug 23, 20245856f8b0c8501See the full diff
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
Aug 6, 20248eca3b09b70513See the full diff
- ▲
  added to the // response property oneOf list for the response status
  response-property-one-of-added
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
- ○
  removed the none enum value from the /// response property for the response status
  response-property-enum-value-removed
- ○
  removed from the // response property oneOf list for the response status
  response-property-one-of-removed
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history