Common endpoints - DecimalAI

A curated set of the API endpoints most users will touch, grouped by surface area. The middle column shows the SDK wrapper — if it’s —, the endpoint is REST-only (use httpx directly).

This is a curated subset for quick reference, not a complete listing. The full surface is available in the API Reference tab to the left and in the underlying OpenAPI spec. For SDK wrappers, see also Frameworks.

Traces

Method	Path	SDK wrapper	Description
`POST`	`/api/v1/traces`	`decimalai.send()` (auto via `@trace`)	Ingest a trace
`POST`	`/api/v1/traces/batch`	—	Ingest a batch of traces
`GET`	`/api/v1/traces`	—	List traces
`GET`	`/api/v1/traces/{trace_id}`	—	Get a trace
`GET`	`/api/v1/traces/stats`	—	Aggregate stats across traces

Evaluations

Method	Path	SDK wrapper	Description
`POST`	`/api/v1/traces/{trace_id}/eval-scores`	`eval()` / `score()` / `push_*_scores()`	Push external evaluation scores
`GET`	`/api/v1/traces/{trace_id}/eval-scores`	—	Get all evaluation scores for a trace
`GET`	`/api/v1/traces/{trace_id}/eval-breakdown`	`get_eval_breakdown()`	Get full eval breakdown with provenance
`GET`	`/api/v1/traces/eval/stats`	—	Eval rollup stats
`POST`	`/api/v1/traces/{trace_id}/evaluate`	—	Run evaluators on a trace
`POST`	`/api/v1/traces/{trace_id}/decision`	—	Compute unified verdict for a trace
`POST`	`/api/v1/traces/batch-decision`	—	Batch compute unified verdicts

Replay

Method	Path	SDK wrapper	Description
`POST`	`/api/v1/replay/batches`	`create_replay_batch()`	Create a replay batch
`GET`	`/api/v1/replay/batches/{batch_id}`	`get_replay_batch()`	Get a replay batch
`GET`	`/api/v1/replay/export`	`get_replay_prompts()`	Export replay prompts
`POST`	`/api/v1/replay/tasks/{task_id}/submit`	`submit_replay_result()`	Submit a replay task result

Skills

Method	Path	SDK wrapper	Description
`GET`	`/api/v1/skills`	`SkillRouter.list_skills()`	List skills
`POST`	`/api/v1/skills`	`SkillRouter.create_skill()`	Create a skill
`GET`	`/api/v1/skills/{skill_name}`	`SkillRouter.get_skill()`	Get a skill by name
`PUT`	`/api/v1/skills/{skill_id}`	`SkillRouter.update_skill()`	Update a skill
`DELETE`	`/api/v1/skills/{skill_id}`	`SkillRouter.delete_skill()`	Delete a skill (soft-delete)
`GET`	`/api/v1/skills/{skill_name}/versions`	`SkillRouter.list_versions()`	List versions of a skill
`POST`	`/api/v1/skills/sync`	`SkillRouter.sync_skills()`	Bulk-upsert skills from local files
`GET`	`/api/v1/skills/menu`	`SkillRouter.get_menu()`	Get the skill menu (Free tier)
`POST`	`/api/v1/skills/route`	`SkillRouter.smart_route()`	Smart-route a query to the best skill (Free tier)
`GET`	`/api/v1/skills/export`	`SkillRouter.export_to_disk()`	Export org skills with full content
`POST`	`/api/v1/skills/{skill_name}/benchmark/run`	—	Run an A/B benchmark for a skill
`GET`	`/api/v1/skills/{skill_name}/benchmark/results`	—	Get benchmark results for a skill

Manifests

Method	Path	SDK wrapper	Description
`GET`	`/api/v1/manifests`	—	List manifests
`GET`	`/api/v1/manifests/{manifest_id}`	—	Get a manifest
`POST`	`/api/v1/manifests`	`register_manifest()`	Register a manifest

Datasets

Method	Path	SDK wrapper	Description
`GET`	`/api/v1/datasets`	—	List datasets
`POST`	`/api/v1/datasets`	—	Create a dataset
`GET`	`/api/v1/datasets/{dataset_id}`	—	Get a dataset
`POST`	`/api/v1/datasets/{dataset_id}/build`	—	Build a new dataset version from traces
`GET`	`/api/v1/datasets/{dataset_id}/versions/{version_id}/export`	`pull_dataset()` / `load_hf_dataset()`	Export a dataset version

Agents

Method	Path	SDK wrapper	Description
`GET`	`/api/v1/agents`	—	List agents

Registry

Method	Path	SDK wrapper	Description
`GET`	`/api/v1/registry/skills`	—	Browse the public skills registry
`GET`	`/api/v1/registry/skills/{skill_id}`	—	Get a registry skill
`POST`	`/api/v1/registry/skills/{skill_id}/fork`	—	Fork a registry skill into your workspace (alias: `/install`, deprecated)
`POST`	`/api/v1/registry/skills/{skill_id}/rate`	—	Rate a registry skill

Import

Method	Path	SDK wrapper	Description
`POST`	`/api/v1/traces/import-bulk`	—	Bulk-import historical traces
`POST`	`/api/v1/traces/import`	—	Import traces from a JSONL upload

REST-only helpers

Endpoints marked — don’t yet have a top-level SDK wrapper. Call them with httpx against the REST API:

import httpx

resp = httpx.get(
    "https://api.decimal.ai/api/v1/datasets",
    headers={"Authorization": "Bearer dai_sk_..."},
)
resp.raise_for_status()

See Authentication for token formats and scopes.

​Traces

​Evaluations

​Replay

​Skills

​Manifests

​Datasets

​Agents

​Registry

​Import

​REST-only helpers

Traces

Evaluations

Replay

Skills

Manifests

Datasets

Agents

Registry

Import

REST-only helpers