tenzro-xyz Datasets API
The Datasets API from tenzro-xyz — 9 operation(s) for datasets.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/tenzro-xyz:tenzro-xyz-datasets-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Tenzro Labs Platform Datasets API
version: 1.0.0
description: Browse the curated catalogue; manage credits, billing, keys, plans and rentals; place and pay orders; run Datasets, Fieldwork, Voices and Forecasts. Chat, embeddings, images, speech and the model list keep the OpenAI-compatible /v1 paths.
servers:
- url: https://api.tenzro.xyz
security:
- apiKey: []
tags:
- name: Datasets
paths:
/datasets:
get:
tags:
- Datasets
summary: List datasets with item counts
description: Needs a key with the `datasets:read` permission.
operationId: getDatasets
x-tenzro-scope: datasets:read
parameters:
- name: source
in: query
required: false
description: fieldwork, voices, vision, time or upload
schema:
type: string
- name: kind
in: query
required: false
description: audio, image, video, text or timeseries
schema:
type: string
responses:
'200':
description: OK
content:
application/json: {}
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
post:
tags:
- Datasets
summary: Create a dataset
description: Needs a key with the `datasets:write` permission.
operationId: postDatasets
x-tenzro-scope: datasets:write
responses:
'200':
description: OK
content:
application/json: {}
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/datasets/{id}:
get:
tags:
- Datasets
summary: Get a dataset with counts and bytes
description: Needs a key with the `datasets:read` permission.
operationId: getDatasetsById
x-tenzro-scope: datasets:read
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json: {}
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
delete:
tags:
- Datasets
summary: Delete a dataset, its files and its version exports
description: Needs a key with the `datasets:write` permission.
operationId: deleteDatasetsById
x-tenzro-scope: datasets:write
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json: {}
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/datasets/{id}/items:
get:
tags:
- Datasets
summary: List items
description: Needs a key with the `datasets:read` permission.
operationId: getDatasetsByIdItems
x-tenzro-scope: datasets:read
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: status
in: query
required: false
description: pending, accepted, rejected or withdrawn
schema:
type: string
- name: limit
in: query
required: false
description: Page size
schema:
type: string
- name: offset
in: query
required: false
description: Items to skip
schema:
type: string
responses:
'200':
description: OK
content:
application/json: {}
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
post:
tags:
- Datasets
summary: Record an item for an object already stored under the dataset
description: Needs a key with the `datasets:write` permission.
operationId: postDatasetsByIdItems
x-tenzro-scope: datasets:write
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json: {}
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/datasets/{id}/items/upload:
post:
tags:
- Datasets
summary: Upload a file as a new item (the body is the file; Content-Type and…
description: Needs a key with the `datasets:write` permission.
operationId: postDatasetsByIdItemsUpload
x-tenzro-scope: datasets:write
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: filename
in: query
required: false
description: File name to keep
schema:
type: string
- name: duration_ms
in: query
required: false
description: Audio or video length
schema:
type: string
- name: meta
in: query
required: false
description: JSON object stored with the item
schema:
type: string
- name: people
in: query
required: false
description: 'Images and video: true or false, whether people appear'
schema:
type: string
- name: consent_ref
in: query
required: false
description: 'Images or video of people: the Fieldwork consent they were collected under'
schema:
type: string
requestBody:
required: true
content:
application/octet-stream:
schema:
type: string
format: binary
responses:
'200':
description: OK
content:
application/json: {}
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/datasets/{id}/items/{itemId}:
get:
tags:
- Datasets
summary: Get an item
description: Needs a key with the `datasets:read` permission.
operationId: getDatasetsByIdItemsByItemId
x-tenzro-scope: datasets:read
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: itemId
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json: {}
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
patch:
tags:
- Datasets
summary: Accept, reject or reopen an item
description: Needs a key with the `datasets:write` permission.
operationId: patchDatasetsByIdItemsByItemId
x-tenzro-scope: datasets:write
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: itemId
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json: {}
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/datasets/{id}/items/{itemId}/download:
get:
tags:
- Datasets
summary: Download the item's file (byte ranges supported)
description: Needs a key with the `datasets:read` permission.
operationId: getDatasetsByIdItemsByItemIdDownload
x-tenzro-scope: datasets:read
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: itemId
in: path
required: true
schema:
type: string
- name: inline
in: query
required: false
description: 1 to play in place instead of downloading
schema:
type: string
responses:
'200':
description: OK
content:
application/octet-stream:
schema:
type: string
format: binary
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/datasets/{id}/versions:
get:
tags:
- Datasets
summary: List versions
description: Needs a key with the `datasets:read` permission.
operationId: getDatasetsByIdVersions
x-tenzro-scope: datasets:read
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json: {}
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
post:
tags:
- Datasets
summary: Freeze the current items as the next version
description: Needs a key with the `datasets:write` permission.
operationId: postDatasetsByIdVersions
x-tenzro-scope: datasets:write
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json: {}
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/datasets/{id}/versions/{version}:
get:
tags:
- Datasets
summary: Get a version
description: Needs a key with the `datasets:read` permission.
operationId: getDatasetsByIdVersionsByVersion
x-tenzro-scope: datasets:read
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: version
in: path
required: true
schema:
type: string
responses:
'200':
description: OK
content:
application/json: {}
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/datasets/{id}/versions/{version}/export:
get:
tags:
- Datasets
summary: Download a version's manifest (JSONL) or Croissant metadata
description: Needs a key with the `datasets:read` permission.
operationId: getDatasetsByIdVersionsByVersionExport
x-tenzro-scope: datasets:read
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: version
in: path
required: true
schema:
type: string
- name: file
in: query
required: true
description: manifest or croissant
schema:
type: string
responses:
'200':
description: OK
content:
application/octet-stream:
schema:
type: string
format: binary
default:
description: Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
scope:
type: string
description: 'On a 403: the permission the key lacks.'
securitySchemes:
apiKey:
type: http
scheme: bearer
description: A Tenzro Labs API key (tzl_…).
ingestKey:
type: http
scheme: bearer
description: 'A Fieldwork ingest key (tzi_…): bound to one project and the origins listed on it, able only to run the participant flow. Safe in a browser. Create it with POST /fieldwork/projects/{id}/ingest-keys.'
serviceAssertion:
type: http
scheme: bearer
bearerFormat: JWT
description: 'A Tenzro Labs service''s ES256 assertion: header kid = the RFC 7638 thumbprint of a key in the service''s published JWKS; iss = sub = the service; aud = this endpoint; exp at most 60 s after iat; jti used once.'