Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Quick reference for the endpoints most users hit, with SDK wrapper mappings.
—, the endpoint is REST-only (use httpx directly).
| 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 |
| 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 |
| 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 |
| 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/{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 | 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 |
| 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 |
| 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 |
| Method | Path | SDK wrapper | Description |
|---|---|---|---|
GET | /api/v1/agents | — | List agents |
| 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 (/install retired 2026-08-11 → 410) |
POST | /api/v1/registry/skills/{skill_id}/rate | — | Rate a registry skill |
| 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 |
— 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()