Async operations & versions - Diagrams.so

Re-layout (async)

Re-arranging a complex diagram runs as a background job. POST /diagrams/{id}/relayout is billable. It starts the job and returns a job_id. GET /diagrams/{id}/relayout/{job_id} is free. Poll it with the job_id until the job is done.

# start; the response includes a job_id
curl -X POST https://api.diagrams.so/api/v2/diagrams/d_1a2b3c/relayout \
  -H "Authorization: Bearer dgz_live_YOUR_API_KEY"

# poll by job_id
curl https://api.diagrams.so/api/v2/diagrams/d_1a2b3c/relayout/job_9f2a \
  -H "Authorization: Bearer dgz_live_YOUR_API_KEY"

Poll with a short backoff, for example every 1 to 2 seconds, until status is completed or failed.

Versions

Every edit and fix creates a version, so you can review history and roll back.

Endpoint	Cost	Purpose
`GET /diagrams/{id}/versions`	free	List versions, newest first (paginated).
`GET /diagrams/{id}/versions/{version_id}`	free	Read a specific version.
`POST /diagrams/{id}/revert`	free	Revert the diagram to a prior version.