Introduction to calling Domino platform APIs. Covers authentication (API proxy, PAT, service account), which host to use for which API, pagination limits, and common errors. Use before any other Domino API, SDK, app, extension, or governance automation skill.
67
81%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
View guide
Passed
No findings from the security scan
Applies to Domino 6.3 and Domino Cloud.
Read this skill first whenever you automate Domino over HTTP or the Python SDK.
Follow https://docs.domino.ai/cloud/reference/api/domino-api-authentication for every call (API proxy in-run, access token + platform host, PAT, and service account).
Legacy user API keys (X-Domino-Api-Key, DOMINO_USER_API_KEY) are described as deprecated, never recommended. Product migration docs: https://docs.domino.ai/cloud/reference/api/domino-api-authentication#authenticate-with-an-api-key-legacy
| Context | Summary (details on the auth page) |
|---|---|
| In-run | Prefer DOMINO_API_PROXY with no Authorization header when set; else Bearer from http://localhost:8899/access-token on DOMINO_USER_HOST (or DOMINO_API_HOST) |
| Outside a run | Public deployment HTTPS URL + Bearer PAT (you) or service account (automation) |
Host selection (gateway, governance 404, WebVFS, inference) is separate from auth mode: HOSTS.md.
| File | Use when |
|---|---|
| HOSTS.md | Pick base URL (gateway, WebVFS, inference, governance external URL) |
| LIMITS.md | Pagination, caps, deprecated env names |
| ERRORS.md | Retries, 502/timeouts, job status fields, datasource 500 workaround |
| SDK-MAP.md | Which plugin skill or doc covers each surface |
| API-SPECS.md | OpenAPI files and route discovery |
Use domain skills under skills/ (python-sdk, apps, governance, datasets, and others). They assume the auth and host rules above.
92a240b
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.