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.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/everyn-ai:everyn-ai-datasets-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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: 3.2.0
info:
description: 'everyn self-serve API for dataset upload sessions, job specs, managed runs, run inspection, retry lineage, exports, alerts, webhooks, model catalog reads, usage and managed-AI balance reads, and organization administration.
API routes use the `/v1` prefix. API-key product calls use `Authorization: Bearer sk-everyn-...` and derive organization context from the key. Job creation, editing and forking require a human browser session and CSRF protection; product API keys may read and run saved jobs but cannot author them. Browser-admin organization routes use bearer credentials and organization IDs in the route. Successful list responses use `{ "data": [], "nextCursor": null }`, and every response includes `X-Request-Id`.'
title: everyn Public Datasets API
version: 1.0.0
servers:
- description: Production API
url: https://api.everyn.ai
- description: Local development API
url: http://localhost:8000
tags:
- description: Dataset reads and creation from run results. Use /v1/dataset-uploads for CSV intake.
name: Datasets
paths:
/v1/datasets:
get:
description: 'List Datasets. Authenticated Everyn public API operation. Send the request to the selected server from this document with a product API key (Authorization: Bearer sk-everyn-...). Parameters and responses are typed in this document.'
operationId: list_datasets_v1_datasets_get
parameters:
- description: Maximum number of items to return in this page.
in: query
name: limit
required: false
schema:
default: 50
title: Limit
type: integer
- description: Opaque pagination cursor from the previous page.
in: query
name: cursor
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Cursor
- description: query for this Everyn API operation.
in: query
name: query
required: false
schema:
anyOf:
- maxLength: 200
type: string
- type: 'null'
title: Query
- description: sort for this Everyn API operation.
in: query
name: sort
required: false
schema:
default: createdAt
enum:
- createdAt
- sourceName
- rowCount
title: Sort
type: string
- description: direction for this Everyn API operation.
in: query
name: direction
required: false
schema:
default: desc
enum:
- asc
- desc
title: Direction
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/CountedBidirectionalPage_DatasetReadResponse_'
description: Successful Response
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Malformed request, header, cursor, or multipart form field.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Missing, malformed, unknown, revoked, or expired credential.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Authenticated principal lacks the required scope or role.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Resource not found, including cross-organization resources.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Idempotency conflict or invalid resource state.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Public error
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Rate limit exceeded.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
security:
- BearerAuth: []
summary: List Datasets
tags:
- Datasets
/v1/datasets/{dataset_id}:
get:
description: 'Get Dataset. Authenticated Everyn public API operation. Send the request to the selected server from this document with a product API key (Authorization: Bearer sk-everyn-...). Parameters and responses are typed in this document.'
operationId: get_dataset_v1_datasets__dataset_id__get
parameters:
- description: Identifier of the dataset.
in: path
name: dataset_id
required: true
schema:
title: Dataset Id
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/DatasetReadResponse'
description: Successful Response
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Malformed request, header, cursor, or multipart form field.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Missing, malformed, unknown, revoked, or expired credential.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Authenticated principal lacks the required scope or role.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Resource not found, including cross-organization resources.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Idempotency conflict or invalid resource state.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Public error
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Rate limit exceeded.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
security:
- BearerAuth: []
summary: Get Dataset
tags:
- Datasets
/v1/datasets/{dataset_id}/profile:
get:
description: 'Get Dataset Profile. Authenticated Everyn public API operation. Send the request to the selected server from this document with a product API key (Authorization: Bearer sk-everyn-...). Parameters and responses are typed in this document.'
operationId: get_dataset_profile_v1_datasets__dataset_id__profile_get
parameters:
- description: Identifier of the dataset.
in: path
name: dataset_id
required: true
schema:
title: Dataset Id
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/DatasetProfileResponse'
description: Successful Response
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Malformed request, header, cursor, or multipart form field.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Missing, malformed, unknown, revoked, or expired credential.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Authenticated principal lacks the required scope or role.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Resource not found, including cross-organization resources.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Idempotency conflict or invalid resource state.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Public error
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Rate limit exceeded.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
security:
- BearerAuth: []
summary: Get Dataset Profile
tags:
- Datasets
/v1/datasets/{dataset_id}/rows:
get:
description: 'List Dataset Rows. Authenticated Everyn public API operation. Send the request to the selected server from this document with a product API key (Authorization: Bearer sk-everyn-...). Parameters and responses are typed in this document.'
operationId: list_dataset_rows_v1_datasets__dataset_id__rows_get
parameters:
- description: Identifier of the dataset.
in: path
name: dataset_id
required: true
schema:
title: Dataset Id
type: string
- description: Maximum number of items to return in this page.
in: query
name: limit
required: false
schema:
default: 50
title: Limit
type: integer
- description: Opaque pagination cursor from the previous page.
in: query
name: cursor
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Cursor
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/Page_DatasetRowResponse_'
description: Successful Response
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Malformed request, header, cursor, or multipart form field.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Missing, malformed, unknown, revoked, or expired credential.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Authenticated principal lacks the required scope or role.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Resource not found, including cross-organization resources.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Idempotency conflict or invalid resource state.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Public error
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Rate limit exceeded.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
security:
- BearerAuth: []
summary: List Dataset Rows
tags:
- Datasets
/v1/runs/{run_id}/datasets:
post:
description: Save the full terminal retry lineage as an immutable dataset. Select successful results (default) or all rows with source, status, and error context. Requires runs:read, datasets:write, and Idempotency-Key. Limited to 200,000 source/result rows and 25 MiB serialized CSV. Does not start a run.
operationId: create_run_dataset_v1_runs__run_id__datasets_post
parameters:
- description: Identifier of the run.
in: path
name: run_id
required: true
schema:
title: Run Id
type: string
- description: Caller-supplied key that makes this write retry-safe.
in: header
name: Idempotency-Key
required: true
schema:
anyOf:
- type: string
- type: 'null'
title: Idempotency-Key
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/RunDatasetCreateRequest'
required: true
responses:
'201':
content:
application/json:
schema:
$ref: '#/components/schemas/DatasetReadResponse'
description: Successful Response
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'400':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Malformed request, header, cursor, or multipart form field.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Missing, malformed, unknown, revoked, or expired credential.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Authenticated principal lacks the required scope or role.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Resource not found, including cross-organization resources.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Idempotency conflict or invalid resource state.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Public error
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/PublicErrorEnvelope'
description: Rate limit exceeded.
headers:
X-Request-Id:
description: Canonical everyn request ID generated by the API.
schema:
examples:
- req_abc123
type: string
security:
- BearerAuth: []
summary: Create dataset from run results
tags:
- Datasets
components:
schemas:
DatasetRowResponse:
additionalProperties: false
properties:
datasetId:
minLength: 1
title: Datasetid
type: string
id:
minLength: 1
title: Id
type: string
rowIndex:
minimum: 0.0
title: Rowindex
type: integer
values:
additionalProperties: true
title: Values
type: object
required:
- id
- datasetId
- rowIndex
- values
title: DatasetRowResponse
type: object
PublicError:
additionalProperties: false
properties:
code:
type: string
details:
additionalProperties: true
type: object
docsUrl:
format: uri
type: string
fieldErrors:
items:
$ref: '#/components/schemas/PublicFieldError'
type: array
message:
type: string
requestId:
type: string
status:
type: integer
required:
- status
- code
- message
- requestId
- docsUrl
- fieldErrors
type: object
DatasetReadResponse:
additionalProperties: false
properties:
columns:
additionalProperties: true
title: Columns
type: object
createdAt:
description: UTC RFC 3339 timestamp string.
examples:
- '2026-06-12T12:00:00Z'
title: Createdat
type: string
id:
minLength: 1
title: Id
type: string
mcpCreation:
anyOf:
- $ref: '#/components/schemas/McpCreationResponse'
- type: 'null'
orgId:
minLength: 1
title: Orgid
type: string
profile:
additionalProperties: true
title: Profile
type: object
rowCount:
minimum: 0.0
title: Rowcount
type: integer
sampleRows:
items:
additionalProperties: true
type: object
title: Samplerows
type: array
sourceName:
maxLength: 512
title: Sourcename
type: string
sourceType:
title: Sourcetype
type: string
required:
- id
- orgId
- sourceName
- sourceType
- rowCount
- columns
- sampleRows
- profile
- createdAt
title: DatasetReadResponse
type: object
McpCreationResponse:
additionalProperties: false
description: 'Smallest safe MCP attribution for product reads.
Server-derived only. Omits grant id, actor id, organization id, role,
scopes, tokens, and raw OAuth identifiers.'
properties:
channel:
const: mcp
title: Channel
type: string
clientId:
anyOf:
- type: string
- type: 'null'
title: Clientid
principalType:
enum:
- workos_jwt
- api_key
title: Principaltype
type: string
required:
- channel
- principalType
title: McpCreationResponse
type: object
DatasetProfileResponse:
additionalProperties: false
properties:
columns:
additionalProperties: true
title: Columns
type: object
datasetId:
minLength: 1
title: Datasetid
type: string
profile:
additionalProperties: true
title: Profile
type: object
rowCount:
minimum: 0.0
title: Rowcount
type: integer
sampleRows:
items:
additionalProperties: true
type: object
title: Samplerows
type: array
required:
- datasetId
- rowCount
- columns
- sampleRows
- profile
title: DatasetProfileResponse
type: object
RunDatasetCreateRequest:
additionalProperties: false
properties:
resultSelection:
default: successful
enum:
- successful
- all
title: Resultselection
type: string
sourceName:
maxLength: 512
minLength: 1
title: Sourcename
type: string
required:
- sourceName
title: RunDatasetCreateRequest
type: object
Page_DatasetRowResponse_:
additionalProperties: false
properties:
data:
items:
$ref: '#/components/schemas/DatasetRowResponse'
title: Data
type: array
nextCursor:
anyOf:
- type: string
- type: 'null'
title: Nextcursor
required:
- data
title: Page[DatasetRowResponse]
type: object
PublicErrorEnvelope:
additionalProperties: false
properties:
error:
$ref: '#/components/schemas/PublicError'
required:
- error
type: object
PublicFieldError:
additionalProperties: false
properties:
actual: {}
code:
type: string
expected: {}
message:
type: string
source:
$ref: '#/components/schemas/PublicFieldErrorSource'
required:
- source
- code
- message
type: object
PublicFieldErrorSource:
additionalProperties: false
minProperties: 1
properties:
formField:
type: string
header:
type: string
parameter:
type: string
pointer:
type: string
type: object
CountedBidirectionalPage_DatasetReadResponse_:
additionalProperties: false
properties:
data:
items:
$ref: '#/components/schemas/DatasetReadResponse'
title: Data
type: array
nextCursor:
anyOf:
- type: string
- type: 'null'
title: Nextcursor
previousCursor:
anyOf:
- type: string
- type: 'null'
title: Previouscursor
totalCount:
minimum: 0.0
title: Totalcount
type: integer
required:
- data
- totalCount
title: CountedBidirectionalPage[DatasetReadResponse]
type: object
securitySchemes:
BearerAuth:
scheme: bearer
type: http
BrowserCsrf:
description: csrfToken returned by GET /v1/auth/session for the same authenticated browser session.
in: header
name: X-CSRF-Token
type: apiKey
BrowserSession:
description: HttpOnly session cookie issued by browser login; deployment may configure its name.
in: cookie
name: everyn_session
type: apiKey