/v1 OpenAPI projection. Field lists, required flags, and response unions
come from the same schemas the service validates.
Host and auth
X-API-Key: ndi_sk_… on every call. See Authentication.
Jobs
Any operation that can outlast a request returns aJob. Pass
?wait_seconds= (0–300) as a query parameter to hold the response open.
Idempotency-Key is an HTTP header. Strict bodies reject those names if
you put them in JSON.
See Jobs and idempotency.
Errors
Failures use one envelope — documented on Errors and limits. Generated pages show the success body (200/202) and a singledefault
error example. They do not repeat 400/401/402/… on every operation; HTTP
status is a consequence of error.code.
SDKs
Application code should use the Python or TypeScript client. Method pages there document signatures, parameters, and returns. Generated pages in this tab show curl only. Device-code CLI and console playground routes are not listed here — see MCP and CLI and Playground.Local preview
Generate the spec beforemintlify dev: