Skip to main content
The v2 API (wastes, ingest jobs, webhooks) is described by an OpenAPI 3.1 document, generated from the code on every release, so it always matches what the API accepts and returns: openapi-v2.json It includes every path, parameter, body and response schema, the x-api-key / x-organization-id security schemes and the deprecation flags. Errors follow problem details.

Generate a client

Generated clients send the headers you configure once: x-api-key, x-organization-id, and an Idempotency-Key per bulk request (POST /v2/wastes, POST /v2/wastes/delete).

Postman / Insomnia

Import → Link → https://code.dcycle.io/openapi-v2.json. Set x-api-key and x-organization-id as collection variables.

Stability

v2 is BETA: additive changes (new fields, endpoints, error codes) ship without notice, so ignore unknown fields. Breaking changes are announced in the changelog.