Diagram · OpenAPI Overlay 1.0.0

Diagram API enhancements (API Evangelist)

12 actions 12 updates documentation extends ../openapi/_original/diagram-la-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Diagram's API. It is a proposal applied on top of the contract, not a document Diagram publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

tagsdescriptionx-documented-not-in-specx-limitsx-error-format

Targets 12

$.paths['/projects'].get

$.paths['/projects'].post

$.paths['/projects/{slug}'].get

$.paths['/projects/{slug}/members'].post

$.paths['/projects/{slug}/members'].delete

$.paths['/projects/{slug}/diagrams'].get

$.paths['/projects/{slug}/diagrams'].post

$.paths['/diagrams/{id}'].get

$.paths['/diagrams/{id}'].put

$.paths['/diagrams/{id}'].delete

$.paths['/diagrams/{id}/versions'].get

OpenAPI Overlay

overlay: 1.0.0
info:
  title: Diagram API enhancements (API Evangelist)
  version: 1.0.0
  x-provenance:
    generated: '2026-11-05'
    method: generated
    source: https://diagram.la/docs/api
extends: ../openapi/_original/diagram-la-openapi.yml
actions:
- target: $
  update:
    tags:
    - name: Projects
      description: Projects group diagrams under a site-unique lowercase slug.
    - name: Members
      description: Emails given read access to a project (owner only).
    - name: Diagrams
      description: Self-contained HTML diagrams at permanent links (https://diagram.la/<id>).
    - name: Versions
      description: Every update adds a version at the same link.
    x-documented-not-in-spec:
      source: https://diagram.la/docs/api
      operations:
      - GET /orgs
      - PATCH /projects/{slug}
      - DELETE /projects/{slug}
      - PATCH /diagrams/{id}
      - POST /diagrams/{id}/restore
    x-limits:
      source: https://diagram.la/docs/api
      items:
      - 900KB of HTML per version; every version is kept.
      - Free accounts can have 5 diagrams; past that, creating a diagram returns 403.
      - 20 active API keys per account.
    x-error-format:
      source: https://diagram.la/docs/api
      body: '{ "error": "message" } (400 also carries `issues`)'
      statuses:
        '400': Body failed validation
        '401': Missing
        invalid: null
        or revoked key: null
        '403': Owner-only action or account limit reached
        '404': Project or diagram does not exist or is not visible
        '409': Project slug is taken
- target: $.paths['/projects'].get
  update:
    tags:
    - Projects
- target: $.paths['/projects'].post
  update:
    tags:
    - Projects
- target: $.paths['/projects/{slug}'].get
  update:
    tags:
    - Projects
- target: $.paths['/projects/{slug}/members'].post
  update:
    tags:
    - Members
- target: $.paths['/projects/{slug}/members'].delete
  update:
    tags:
    - Members
- target: $.paths['/projects/{slug}/diagrams'].get
  update:
    tags:
    - Diagrams
- target: $.paths['/projects/{slug}/diagrams'].post
  update:
    tags:
    - Diagrams
- target: $.paths['/diagrams/{id}'].get
  update:
    tags:
    - Diagrams
- target: $.paths['/diagrams/{id}'].put
  update:
    tags:
    - Diagrams
    description: 'Identical HTML returns changed: false and does not add a version. `project` moves the diagram (same link); `publish: true` publishes
      a draft.'
- target: $.paths['/diagrams/{id}'].delete
  update:
    tags:
    - Diagrams
    description: Moves the diagram to the owner's archive.
- target: $.paths['/diagrams/{id}/versions'].get
  update:
    tags:
    - Versions

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This overlay

curl "https://apis.io/api/v1/overlays/diagram-la-openapi-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.