Skip to main content
Section ID: DOC-API-MODEL-schema-oi1c4l4i8b#overview

CursorPageInfo

Opaque-cursor pagination details. A cursor is used to request the next page; arbitrary page-number seeking is not supported.

Meaning and usage​

Section ID: DOC-API-MODEL-schema-oi1c4l4i8b#meaning

See the definition above.

Usage profiles​

Section ID: DOC-API-MODEL-schema-oi1c4l4i8b#fields

UsageFields and validation
In responsesView fields

In responses​

Section ID: DOC-API-MODEL-schema-oi1c4l4i8b#response

API JSON uses JSON field names (camelCase).

FieldTypePresenceMeaning
Section ID: DOC-API-MODEL-schema-oi1c4l4i8b#field-nextcursorSection ID: DOC-API-MODEL-schema-oi1c4l4i8b#response-field-nextcursornextCursorstringOptionalPass back as the request's cursor for the next page. Empty on the last page.
Section ID: DOC-API-MODEL-schema-oi1c4l4i8b#field-limitSection ID: DOC-API-MODEL-schema-oi1c4l4i8b#response-field-limitlimitstring (int64)OptionalMaximum number of entries requested from the listing. Pattern: ^-?\d+$.
Section ID: DOC-API-MODEL-schema-oi1c4l4i8b#field-totalitemsSection ID: DOC-API-MODEL-schema-oi1c4l4i8b#response-field-totalitemstotalItemsstring (int64)Optional; explicit presenceTotal number of matching items when it can be counted exactly. Absent when the selected filters do not support an exact total. Pattern: ^-?\d+$.

Where used​

Section ID: DOC-API-MODEL-schema-oi1c4l4i8b#where-used

ReferenceRelationship
List dataset runsPOST /api/v1/evals/list-dataset-runs
List observationsPOST /api/v1/evals/list-observations
List scoresPOST /api/v1/evals/list-scores
List sessionsPOST /api/v1/evals/list-sessions
List tracesPOST /api/v1/evals/list-traces

Download the public reference contract.

Document ID: DOC-API-MODEL-schema-oi1c4l4i8b