> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anyformat.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# List Dataset Tags
> A workflow's dataset tags, the ids the tag filters on evals and accuracy take
*Rate limit tier: **general**, 600 requests/min. See [Rate limits](/api-reference-v3/introduction#rate-limits).*
Lists every dataset tag of a workflow, ordered by name. A tag's `id` is the value `dataset_tag_ids` takes when you [launch an eval](/api-reference-v3/evals/launch) on a tagged subset. The same id names each row of `by_dataset_tag` in an [eval's accuracy](/api-reference-v3/evals/accuracy), as `dataset_tag_id`.
The list is not paginated. Tags are created and assigned to dataset documents in the app. An unknown workflow, or one that belongs to another organization, answers `404` with `error_code: NOT_FOUND`.
```bash curl theme={null}
curl 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/dataset/tags/' \
-H 'Authorization: Bearer YOUR_API_KEY'
```
```python Python (SDK) theme={null}
from anyformat.sdk import Client
client = Client(api_key="YOUR_API_KEY")
tags = client.list_dataset_tags("0686bb97-8c30-70f0-8000-97669e000eb8")
q3 = [tag.id for tag in tags if tag.name == "Q3 invoices"]
```
```typescript TypeScript (SDK) theme={null}
import { Anyformat } from "@anyformat/sdk";
const af = new Anyformat({ apiKey: "YOUR_API_KEY" });
const tags = await af.listDatasetTags("0686bb97-8c30-70f0-8000-97669e000eb8");
const q3 = tags.filter((tag) => tag.name === "Q3 invoices").map((tag) => tag.id);
```
```json Response (200 OK) theme={null}
{
"items": [
{
"id": "069dcc2c-e14c-7606-8000-2ee4fb17aaaa",
"name": "Q3 invoices",
"created_at": "2026-07-01T12:00:00Z"
}
]
}
```
## OpenAPI
````yaml GET /v3/workflows/{workflow_id}/dataset/tags/
openapi: 3.1.0
info:
title: anyformat API
description: >
Document extraction and workflow automation API.
AnyFormat lets you define extraction workflows that pull structured data
from any document — PDFs, images, scanned files, or plain text. Upload a
file, run it through a workflow, and get back structured fields with
confidence scores and source evidence.
## Quick start
See the [Quick start
guide](https://docs.anyformat.ai/api-reference-v3/introduction) for a
walkthrough.
## Authentication
All endpoints (except `/health/`) require a Bearer token in the
`Authorization` header:
```
Authorization: Bearer
```
Get your API key from
[app.anyformat.ai/api-key](https://app.anyformat.ai/api-key).
## Versioning
Endpoints are versioned by path prefix (`/v3/`). Every response under
a versioned prefix includes `X-API-Version`.
version: 3.0.0
servers:
- url: https://api.anyformat.ai
description: API server
security: []
tags:
- name: workflows
description: >-
Workflows define extraction templates — what fields to extract from
documents. Create workflows, upload files, run extractions, and fetch
results.
- name: document-packets
description: >-
Document packets group uploaded documents for a workflow. Address a packet
directly to (re-)run its workflow.
- name: runs
description: >-
Extraction runs — the first-class result entity. Each run is a single
execution of a workflow against a document packet; fetch its status and
results flat by run id.
- name: splits
description: >-
Splits — the sub-documents a splitter node carves out of a packet.
Download any one of them as a PDF, built from the source documents on
request and never stored.
- name: parse
description: >-
Parse a single document with the platform's fast lite parse — a one-call
shortcut over the workflow upload + run primitives, backed by your
organization's system parse workflow.
- name: health
description: Health check endpoints to verify API availability.
paths:
/v3/workflows/{workflow_id}/dataset/tags/:
get:
tags:
- evals
summary: List dataset tags
description: >-
List a workflow's dataset tags, ordered by name.
A tag's `id` is what `dataset_tag_ids` takes when you launch an eval,
and what
`by_dataset_tag[].dataset_tag_id` names in an eval's accuracy. Tags are
created and assigned in the app. An unknown or
cross-org workflow returns 404.
operationId: v3_list_dataset_tags
parameters:
- name: workflow_id
in: path
required: true
schema:
type: string
title: Workflow Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DatasetTagListV3'
headers:
X-RateLimit-Limit:
description: Requests allowed per window (60s).
schema:
type: integer
X-RateLimit-Remaining:
description: Requests remaining in the current window.
schema:
type: integer
X-RateLimit-Reset:
description: Seconds until the current window resets.
schema:
type: integer
'400':
description: >-
Validation failed — the request body or query parameters are
invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
examples:
VALIDATION_ERROR:
value:
error: The request failed validation.
detail: The request failed validation.
error_code: VALIDATION_ERROR
retryable: false
request_id: req_abc123
'401':
description: >-
Authentication failed — the API key is not valid (`INVALID_API_KEY`)
or the request carries none (`MISSING_API_KEY`).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
examples:
INVALID_API_KEY:
value:
error: The API key is not valid.
detail: The API key is not valid.
error_code: INVALID_API_KEY
retryable: false
request_id: req_abc123
MISSING_API_KEY:
value:
error: The request carries no API key.
detail: The request carries no API key.
error_code: MISSING_API_KEY
retryable: false
request_id: req_abc123
'403':
description: >-
Access denied — the API key lacks access to this resource or the
scope this call needs (`ACCESS_DENIED`,
`insufficient_api_key_scope`).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
examples:
ACCESS_DENIED:
value:
error: You do not have access to this resource.
detail: You do not have access to this resource.
error_code: ACCESS_DENIED
retryable: false
request_id: req_abc123
insufficient_api_key_scope:
value:
error: The API key does not carry the scope this call needs.
detail: The API key does not carry the scope this call needs.
error_code: insufficient_api_key_scope
retryable: false
request_id: req_abc123
'404':
description: >-
Resource not found — the workflow, document packet, or run ID does
not exist or is not visible to this API key.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
examples:
NOT_FOUND:
value:
error: The resource does not exist.
detail: The resource does not exist.
error_code: NOT_FOUND
retryable: false
request_id: req_abc123
'429':
description: >-
Rate limited — retry after the `Retry-After` header. Default
windows: 60 requests/minute for extraction submission, 600
requests/minute for general endpoints.
headers:
Retry-After:
description: Seconds until the next request is allowed.
schema:
type: integer
X-RateLimit-Limit:
description: Requests allowed per window (60s).
schema:
type: integer
X-RateLimit-Remaining:
description: Requests remaining in the current window.
schema:
type: integer
X-RateLimit-Reset:
description: Seconds until the current window resets.
schema:
type: integer
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
examples:
RATE_LIMITED:
value:
error: Too many requests.
detail: Too many requests.
error_code: RATE_LIMITED
retryable: true
request_id: req_abc123
'500':
description: >-
An internal error stopped the request — `retryable=true`. Retry with
backoff.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
examples:
INTERNAL_ERROR:
value:
error: An internal error stopped the request.
detail: An internal error stopped the request.
error_code: INTERNAL_ERROR
retryable: true
request_id: req_abc123
'502':
description: >-
An upstream service failed. Retry with backoff when `retryable` is
true.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
examples:
INTERNAL_ERROR:
value:
error: An internal error stopped the request.
detail: An internal error stopped the request.
error_code: INTERNAL_ERROR
retryable: true
request_id: req_abc123
'503':
description: >-
An upstream service is unavailable. Retry with backoff when
`retryable` is true.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
examples:
INTERNAL_ERROR:
value:
error: An internal error stopped the request.
detail: An internal error stopped the request.
error_code: INTERNAL_ERROR
retryable: true
request_id: req_abc123
'504':
description: An upstream service did not answer in time. Retry with backoff.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
examples:
GATEWAY_TIMEOUT:
value:
error: The upstream service did not answer in time.
detail: The upstream service did not answer in time.
error_code: GATEWAY_TIMEOUT
retryable: true
request_id: req_abc123
security:
- ApiKeyAuth: []
components:
schemas:
DatasetTagListV3:
properties:
items:
items:
$ref: '#/components/schemas/DatasetTagV3'
type: array
title: Items
description: The workflow's dataset tags, ordered by name.
type: object
required:
- items
title: DatasetTagListV3
description: Every dataset tag of a workflow, ordered by name.
ErrorEnvelope:
type: object
title: ErrorEnvelope
description: >-
Uniform error response. `retryable=true` means the same request may
succeed on retry (with backoff); `retryable=false` means the caller must
change the request before retrying.
required:
- error
- error_code
- retryable
- request_id
properties:
error:
type: string
description: Short human-readable summary.
detail:
description: >-
Machine-readable detail, any JSON value. A string for most errors, a
list of field errors for validation failures, and an object for a
structured error such as `FILENAME_CONFLICT` (`detail.conflicts`).
error_code:
type: string
enum:
- ACCESS_DENIED
- AGENTIC_MULTIFILE_UNSUPPORTED
- AUTH_FAILED
- CONCURRENT_EDIT
- DATASET_DOCUMENT_REJECTED
- DATASET_GROUND_TRUTH_SAVE_FAILED
- DATASET_INVALID_REQUEST
- EMPTY_EVAL
- ENDPOINT_RETIRED
- EXTRACT_MODE_FORBIDDEN
- EXTRACT_NODE_UNRESOLVED
- FILENAME_CONFLICT
- FILE_TOO_LARGE
- GATEWAY_TIMEOUT
- GRAPH_READBACK_FAILED
- GT_INVALID
- IDEMPOTENCY_KEY_REUSED
- IMMUTABLE_WORKFLOW
- INSUFFICIENT_CREDIT
- INTERNAL_ERROR
- INTERNAL_INCONSISTENCY
- INVALID_API_KEY
- INVALID_JSON
- INVALID_LOOKUP_FILE_ENCODING
- INVALID_VALUE
- INVALID_WORKFLOW_CONFIG
- KNOWLEDGE_NOT_ENABLED
- KNOWLEDGE_NOT_READY
- KNOWLEDGE_THREAD_MISMATCH
- KNOWLEDGE_UNSUPPORTED_SNAPSHOT_FORMAT
- LOOKUP_FIELD_WITHOUT_FILE
- METHOD_NOT_ALLOWED
- MISSING_API_KEY
- NOT_ACCEPTABLE
- NOT_FOUND
- NOT_IMPLEMENTED
- OBJECT_STORAGE_UNAVAILABLE
- OPERATOR_DEPRECATED
- OPERATOR_NOT_AVAILABLE
- PARSE_MODE_FORBIDDEN
- PAYMENT_REQUIRED
- PRECONDITION_FAILED
- RATE_LIMITED
- REQUEST_TOO_LARGE
- RUN_IN_PROGRESS
- SPLIT_HAS_NO_PAGES
- SPLIT_SOURCE_NOT_PDF
- SPLIT_WORKFLOW_DATASET_UNSUPPORTED
- TOPOLOGY_INVALID
- UNSUPPORTED_FILE_TYPE
- UNSUPPORTED_LOOKUP_FILE
- UNSUPPORTED_MEDIA_TYPE
- UPLOAD_SNIFF_BUDGET_EXCEEDED
- VALIDATION_ERROR
- WORKFLOW_CONCURRENT_EDIT
- WORKFLOW_NAME_CONFLICT
- ZERO_DATA_RETENTION_REFUSES_DATASET
- ZERO_DATA_RETENTION_REFUSES_KNOWLEDGE
- deprecated_operator_ack_required
- insufficient_api_key_scope
- terms_acceptance_required
description: >-
Stable identifier for programmatic handling. New values can be added
at any time, so a client must accept a code it does not know.
examples:
- VALIDATION_ERROR
- AUTH_FAILED
- NOT_FOUND
- PRECONDITION_FAILED
- RATE_LIMITED
- INTERNAL_ERROR
- GATEWAY_TIMEOUT
retryable:
type: boolean
description: True when the caller should retry (with backoff for 429/412/5xx).
request_id:
type: string
description: Correlates this response with server logs.
params:
type: object
additionalProperties: true
description: >-
Values specific to this occurrence of the error that a caller needs
to recover, such as `node_ids` or `required_scope`, keyed by name.
Absent when the code relays none.
doc_url:
type: string
format: uri
description: Link to the documentation of this `error_code`.
DatasetTagV3:
properties:
id:
type: string
title: Id
description: >-
The dataset tag's id (hyphenated UUID); pass it in `dataset_tag_ids`
to launch an eval on the documents carrying it.
examples:
- 069dcc2c-e14c-7606-8000-2ee4fb17aaaa
name:
type: string
title: Name
description: The tag's name, unique within the workflow.
examples:
- Q3 invoices
created_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Created At
description: Timestamp when the tag was created (ISO 8601).
type: object
required:
- id
- name
title: DatasetTagV3
description: One of a workflow's dataset tags.
securitySchemes:
ApiKeyAuth:
type: http
description: >-
API key issued from app.anyformat.ai/api-key. Send as `Authorization:
Bearer `.
scheme: bearer
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.