← Back to docs

API Reference

The DiagramIQ REST API allows you to programmatically manage diagrams, trigger scans, query drift and anomaly data, and integrate DiagramIQ into your own toolchain.

Authentication
Base URL
Rate limits
Errors
Pagination
Webhooks
REST Endpoints
GraphQL API

Authentication

All API requests must include your API key in the Authorization header.

Authorization: Bearer diq_live_xxxxxxxxxxxxxxxxxxx

API keys can be generated in Settings → API Keys. Keep your key secret — it has full access to your workspace.

Base URL

https://api.diagramiq.io

Rate limits

Free60 requests / minute
Pro600 requests / minute
EnterpriseCustom — contact sales

REST Endpoints

GET/v1/diagramsList all architecture diagrams in the workspace
POST/v1/diagramsCreate a new architecture diagram
GET/v1/diagrams/{id}Get a specific diagram by ID
PUT/v1/diagrams/{id}Update diagram metadata or content
DELETE/v1/diagrams/{id}Delete a diagram
GET/v1/resourcesList discovered cloud resources
POST/v1/scanTrigger an on-demand cloud scan
GET/v1/driftList current drift events
GET/v1/anomaliesList detected anomalies
GET/v1/policy/resultsGet policy validation results
POST/v1/policy/validateValidate a diagram against policy rules
GET/v1/costs/estimateGet cost estimate for a diagram
GET/v1/workspaceGet workspace details and usage
GET/v1/integrationsList configured integrations

GraphQL API

A GraphQL API with full schema introspection is available at https://api.diagramiq.io/graphql. It supports the same authentication and rate limits as the REST API. An interactive playground is available in the DiagramIQ dashboard under Developer Tools → API Playground.