> ## Documentation Index > Fetch the complete documentation index at: https://docs.anpord.com/llms.txt > Use this file to discover all available pages before exploring further. # List suites > Most recently active first. Pass the `next` cursor from a response to read the page after it; a null `next` means there are no more. ## OpenAPI ````yaml /openapi.json post /v1/evals.suites.list openapi: 3.1.0 info: title: Anpord API version: 1.0.0 description: >- Run agent evals and manage prompts. Every endpoint takes a JSON body over POST and authenticates with a bearer API key. servers: - description: Production url: https://api.anpord.com security: [] tags: - name: Connectors description: >- Connect the credentials an eval run needs: a harness to drive, a sandbox to run in, and a model to play a case's human. - name: Batches description: Runs started together, such as every case of a suite on every variant. - name: Suites description: >- A prompt and workspace shared by many cases. List its cases with `evals.cases.list` and its `suite` filter. - name: Cases description: One eval each, belonging to a suite, run on one or more variants. - name: Runs description: One case run on one variant, with its trials. - name: Models description: The models a variant can name. - name: Prompts description: >- Read and write prompts. Content is versioned, so writes append rather than overwrite, and channels decide which version callers receive. paths: /v1/evals.suites.list: post: tags: - Suites summary: List suites description: >- Most recently active first. Pass the `next` cursor from a response to read the page after it; a null `next` means there are no more. operationId: suites.list parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/ListSuitesRequest' required: true responses: '200': description: Suites, most recently active first. content: application/json: schema: $ref: '#/components/schemas/EvalSuitePage' '400': description: The request did not match the expected schema content: application/json: schema: anyOf: - $ref: '#/components/schemas/HttpApiDecodeError' - $ref: '#/components/schemas/BadRequest' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Forbidden' '404': description: NotFound content: application/json: schema: $ref: '#/components/schemas/NotFound' '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/Conflict' security: - bearer: [] components: schemas: ListSuitesRequest: type: object required: [] properties: cursor: anyOf: - type: object required: - id - startedAtMillis properties: id: type: string name: type: string startedAtMillis: $ref: '#/components/schemas/Int' additionalProperties: false - type: 'null' limit: $ref: '#/components/schemas/Int' additionalProperties: false description: Where to read from, and how much. EvalSuitePage: type: object required: - next - suites properties: next: anyOf: - type: object required: - id - startedAtMillis properties: id: type: string name: type: string startedAtMillis: $ref: '#/components/schemas/Int' additionalProperties: false - type: 'null' suites: type: array items: $ref: '#/components/schemas/EvalSuiteSummary' additionalProperties: false description: Suites, most recently active first. HttpApiDecodeError: type: object required: - issues - message - _tag properties: issues: type: array items: $ref: '#/components/schemas/Issue' message: type: string _tag: type: string enum: - HttpApiDecodeError additionalProperties: false description: The request did not match the expected schema BadRequest: type: object required: - message - _tag properties: message: type: string _tag: type: string enum: - BadRequest additionalProperties: false Unauthorized: type: object required: - message - _tag properties: message: type: string _tag: type: string enum: - Unauthorized additionalProperties: false Forbidden: type: object required: - message - _tag properties: message: type: string _tag: type: string enum: - Forbidden additionalProperties: false NotFound: type: object required: - message - _tag properties: message: type: string _tag: type: string enum: - NotFound additionalProperties: false Conflict: type: object required: - message - _tag properties: message: type: string _tag: type: string enum: - Conflict additionalProperties: false Int: type: integer description: an integer title: int EvalSuiteSummary: type: object required: - cases - id - lastRunAt - name - tally - variants properties: cases: $ref: '#/components/schemas/Int' id: $ref: '#/components/schemas/EvalSuiteId' lastRunAt: anyOf: - $ref: '#/components/schemas/EvalTimestamp' - type: 'null' name: type: string tally: $ref: '#/components/schemas/EvalTally' variants: $ref: '#/components/schemas/Int' additionalProperties: false description: A suite as the list shows it, counted across the cases it holds. Issue: type: object required: - _tag - path - message properties: _tag: type: string enum: - Pointer - Unexpected - Missing - Composite - Refinement - Transformation - Type - Forbidden description: The tag identifying the type of parse issue path: type: array items: $ref: '#/components/schemas/PropertyKey' description: The path to the property where the issue occurred message: type: string description: A descriptive message explaining the issue additionalProperties: false description: >- Represents an error encountered while parsing a value to match the schema EvalSuiteId: type: string description: The stable handle an author gives a suite. title: maxLength(100) minLength: 1 maxLength: 100 pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$ EvalTimestamp: type: string description: An ISO-8601 timestamp in UTC. format: date-time EvalTally: type: object required: - passed - scored properties: passed: $ref: '#/components/schemas/Int' scored: $ref: '#/components/schemas/Int' additionalProperties: false description: How many trials were scored across a group, and how many passed. PropertyKey: anyOf: - type: string - type: number - type: object required: - _tag - key properties: _tag: type: string enum: - symbol key: type: string additionalProperties: false description: an object to be decoded into a globally shared symbol securitySchemes: bearer: type: http scheme: bearer ````