Common endpoints

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. Raw (non-SDK) ingest: register a manifest first and stamp `manifest_id` + `routing_id` on the payload — see the manifest handshake
`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). Deleting a fork its agents had also returns `agents_back_on_source` and `agents_without_skill`
`POST`	`/api/v1/agents/{agent_name}/skills/{skill_id}`	`SkillRouter.assign_skill()`	Assign a skill to one agent, optionally pinned to a version
`DELETE`	`/api/v1/agents/{agent_name}/skills/{skill_id}`	`SkillRouter.unassign_skill()`	Remove a skill’s assignment from one agent (admin key)
`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 list (Free tier)
`POST`	`/api/v1/skills/route`	`SkillRouter.smart_route()`	Smart-route a query to the best skill (Free tier)
`GET`	`/api/v1/skills/{skill_name}/body`	`SkillRouter.get_skill_body()`	Get a skill’s full body for prompt injection — the serve path behind `load_skill`
`GET`	`/api/v1/skills/export`	—	Export org skills with full content. The SDK does not call it: `decimalai skills add` and `SkillRouter.export()` use the install routes below
`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

Skills on disk

The routes behind decimalai skills. With an API key they serve what your org can install; the /registry/install/ twins take no key and serve public skills only. Fetching files for disk counts as a fetch, never as a use.

Method	Path	SDK wrapper	Description
`POST`	`/api/v1/install/resolve`	`decimalai.skillpkg.add()`, `install()`, `update()`, `migrate()`	Resolve skill refs to a version, a render and an install name: up to 100 items, one result each
`GET`	`/api/v1/install/bundles/{version_id}`	`decimalai.skillpkg.add()`, `install()`, `update()`	The exact files of one version and render, each with its sha256 and mode
`POST`	`/api/v1/registry/install/resolve`	the same, with no key	The same resolve, public skills only, up to 20 items, no auth
`GET`	`/api/v1/registry/install/bundles/{version_id}`	the same, with no key	The same files, public skills only, no auth
`GET`	`/api/v1/registry/skills/{id_or_slug}/bundle`	`decimalai skills pull`	A public skill’s files under its install name, for a loose copy
`GET`	`/api/v1/registry/skills/{id_or_slug}/skill-md`	—	A public skill’s `SKILL.md` alone, as `text/markdown`

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`	`SkillRouter.search()`	Browse the public skills registry
`GET`	`/api/v1/registry/skills/{skill_id}`	`SkillRouter.preview()`	Get a registry skill
`POST`	`/api/v1/registry/skills/{skill_id}/fork`	`SkillRouter.fork()`	Fork a registry skill into your workspace; the response names the agents moved onto the fork (`moved_agents`, `pinned_agents_kept`, `unmoved_agents`). `/install` retired 2026-08-11 → 410
`POST`	`/api/v1/registry/skills/{skill_id}/use`	`SkillRouter.use()`	Install a registry skill: a link, no copy
`DELETE`	`/api/v1/registry/skills/{skill_id}/use`	—	Uninstall: remove the link
`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.

Python SDK

Skills in your repo

CLI

REST

Traces

Evaluations

Replay

Skills

Skills on disk

Manifests

Datasets

Agents

Registry

Import

REST-only helpers

​Traces

​Evaluations

​Replay

​Skills

​Skills on disk

​Manifests

​Datasets

​Agents

​Registry

​Import

​REST-only helpers

Traces

Evaluations

Replay

Skills

Skills on disk

Manifests

Datasets

Agents

Registry

Import

REST-only helpers