> ## Documentation Index > Fetch the complete documentation index at: https://docs.sqwish.ai/llms.txt > Use this file to discover all available pages before exploring further. # List dataset versions > A dataset's versions, newest first: when each was made, the rows it added, the dataset's counts and split at it, how its rows came (`added_via`: api, jsonl, csv or labeling) and the family whose page added them (`added_from`), or null. ## OpenAPI ````yaml /openapi.json get /v1/datasets/{dataset_id}/versions openapi: 3.1.0 info: title: DecisionOne workbench description: >- Native decisions, versioned datasets, adaptation and shared-base deployment. Authenticate with `Authorization: Bearer d1_sk_...` when accounts are on. A short guide for coding agents is at /llms.txt. Hosted account APIs accept a Bearer API key or a browser session. An API key reads its account but can't change it: keys, billing and settings change in the console. Browser mutations require the configured Origin and X-CSRF-Token from /auth/session. Account recovery and history remain available to blocked accounts. Waitlisted accounts can read their account summary and model catalogue and request early access; private member APIs require admission. Money fields ending in _usd are exact decimal strings; never interpret them as integer cents. Authenticated customer reads and existing-operation replays share read_rpm, and other customer writes except decisions and estimates share write_rpm. Exhausted budgets return 429 with Retry-After; unavailable admission storage returns 503. version: 0.1.0 servers: - url: https://console.sqwish.ai security: [] tags: - name: Decisions description: Probabilities for questions with fixed outcomes. - name: Models description: Base models, adapters and named models with versions. - name: Families description: >- Lines of models trained on one dataset, and the switches that let them answer calls. - name: Datasets description: >- Validated training examples. A dataset grows in versions, and a version never changes. - name: Evaluations description: Reusable model results on a dataset's fixed evaluation rows. - name: Fine-tuning description: Training jobs, their events and held-out results. - name: Prompt tuning description: Better wording for a decision, tested on your rows. Words, not weights. - name: Labeling description: Teacher labels for real queries, reviewed by you. - name: Accounts description: Email OTP sign-in, revocable sessions, security and API keys. - name: Billing description: Exact USD balances, purchases, automatic top-ups and referrals. - name: Integrations description: Endpoints other tools call, such as Claude Code. - name: System description: Health and discovery. paths: /v1/datasets/{dataset_id}/versions: get: tags: - Datasets summary: List dataset versions description: >- A dataset's versions, newest first: when each was made, the rows it added, the dataset's counts and split at it, how its rows came (`added_via`: api, jsonl, csv or labeling) and the family whose page added them (`added_from`), or null. operationId: listDatasetVersions parameters: - name: dataset_id in: path required: true schema: type: string title: Dataset Id responses: '200': description: Successful Response content: application/json: schema: properties: data: items: $ref: '#/components/schemas/DatasetVersion' title: Data type: array required: - data title: Items type: object 4XX: description: >- Client error. On a 422, `error.details` lists each field that failed. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' 5XX: description: Server error. A 503 names what is not running on this server. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - BearerAuth: [] components: schemas: DatasetVersion: properties: version: type: integer title: Version created_at: type: number title: Created At sha256: type: string title: Sha256 description: >- Names every row of this version: the first version's file digest, each later one's chained on. rows: type: integer title: Rows description: The dataset's rows at this version. added: type: integer title: Added description: The rows this version added. contexts: type: integer title: Contexts split: additionalProperties: type: integer type: object title: Split added_via: type: string enum: - api - jsonl - csv - labeling title: Added Via description: >- How this version's rows came: the JSON API, a JSONL or CSV upload, or the labelling job that made the dataset, for its first version only. added_from: anyOf: - type: string - type: 'null' title: Added From description: >- The family whose page added these rows, or null. Only a later version has one. type: object required: - version - created_at - sha256 - rows - added - contexts - split - added_via - added_from title: DatasetVersion ErrorResponse: description: >- The body of every error. app.failure() builds it; this model documents it. properties: error: $ref: '#/components/schemas/ErrorBody' required: - error title: ErrorResponse type: object ErrorBody: properties: code: description: A stable code to branch on, such as invalid_request. title: Code type: string message: description: What went wrong and what to change, in plain words. title: Message type: string retryable: description: >- True when another attempt may succeed; it does not prove that no work was done. Respect Retry-After when present. Only operations that support Idempotency-Key replay a prior result, including /v1/decide for 24 hours. title: Retryable type: boolean request_id: description: Also sent as X-Request-ID. Quote it in bug reports. title: Request Id type: string details: anyOf: - items: $ref: '#/components/schemas/ErrorDetail' type: array - type: 'null' default: null description: On validation errors, one entry for each field that failed. title: Details required: - code - message - retryable - request_id title: ErrorBody type: object ErrorDetail: properties: path: description: Where the problem is, such as ["body", "decisions", 0, "outcomes"]. items: anyOf: - type: string - type: integer title: Path type: array message: title: Message type: string type: anyOf: - type: string - type: 'null' default: null title: Type required: - path - message title: ErrorDetail type: object securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: d1_sk_... description: Create an API key in the console. Required when accounts are enabled. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.