@trdrs/quickcharts 1.0.0

package/dist/rest-openapi.json

@@ -0,0 +1,1664 @@
+{
+  "openapi": "3.1.0",
+  "info": {
+    "title": "Quick Charts saved resources",
+    "version": "1",
+    "description": "The service contract behind `createRestSaveLoadAdapter` from `@trdrs/quickcharts/adapters/rest`. Every path is relative to the base URL the host configures. Authorization, cookies, CORS, retries and tenancy belong to the host request function, so no path, header or field here carries a credential. Saved charts, layouts, drawing documents and templates share one revisioned rule: a read answers the ref a row stands at, a write quotes that revision in `If-Match`, and a write against a revision the service has moved past answers 409 with the ref that stands."
+  },
+  "servers": [
+    {
+      "url": "{baseUrl}",
+      "description": "The base URL the host configures. This document names no origin.",
+      "variables": {
+        "baseUrl": {
+          "default": "/",
+          "description": "Where the host mounts these routes."
+        }
+      }
+    }
+  ],
+  "tags": [
+    {
+      "name": "charts",
+      "description": "Saved charts."
+    },
+    {
+      "name": "layouts",
+      "description": "Saved multi-chart layouts."
+    },
+    {
+      "name": "drawings",
+      "description": "One drawings document per drawing-resource context."
+    },
+    {
+      "name": "templates",
+      "description": "Named appearance, indicator and drawing templates, one collection per kind."
+    }
+  ],
+  "paths": {
+    "/charts": {
+      "get": {
+        "tags": [
+          "charts"
+        ],
+        "summary": "List rows, metadata only.",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "The rows this principal may read.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ChartMetaList"
+                }
+              }
+            }
+          }
+        }
+      },
+      "post": {
+        "tags": [
+          "charts"
+        ],
+        "summary": "Store a new row. The service mints the id, so a create quotes no revision.",
+        "parameters": [],
+        "requestBody": {
+          "description": "The document to store.",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ChartBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The ref the service now holds.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ChartMetaWrite"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "A row already stands for this identity. The body carries its ref, which the caller loads instead of forking a second.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Conflict"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/charts/{id}": {
+      "get": {
+        "tags": [
+          "charts"
+        ],
+        "summary": "Read one row and the revision it stands at.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The document and its ref.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ChartBodyLoad"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "charts"
+        ],
+        "summary": "Replace the row, but only while it still stands at the quoted revision.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "If-Match",
+            "in": "header",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The revision this write believes it is replacing."
+          }
+        ],
+        "requestBody": {
+          "description": "The document to store.",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ChartBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The ref the service now holds.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ChartMetaWrite"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "The quoted revision is not the one that stands. The body carries the ref that does.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Conflict"
+                }
+              }
+            }
+          },
+          "428": {
+            "description": "The request carried no If-Match revision.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RevisionRequired"
+                }
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "charts"
+        ],
+        "summary": "Delete the row, but only while it still stands at the quoted revision.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "If-Match",
+            "in": "header",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The revision this write believes it is replacing."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The ref the service removed.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ChartMetaWrite"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "The quoted revision is not the one that stands. The body carries the ref that does.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Conflict"
+                }
+              }
+            }
+          },
+          "428": {
+            "description": "The request carried no If-Match revision.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RevisionRequired"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/layouts": {
+      "get": {
+        "tags": [
+          "layouts"
+        ],
+        "summary": "List rows, metadata only.",
+        "parameters": [],
+        "responses": {
+          "200": {
+            "description": "The rows this principal may read.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/LayoutMetaList"
+                }
+              }
+            }
+          }
+        }
+      },
+      "post": {
+        "tags": [
+          "layouts"
+        ],
+        "summary": "Store a new row. The service mints the id, so a create quotes no revision.",
+        "parameters": [],
+        "requestBody": {
+          "description": "The document to store.",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/LayoutBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The ref the service now holds.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/LayoutMetaWrite"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "A row already stands for this identity. The body carries its ref, which the caller loads instead of forking a second.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Conflict"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/layouts/{id}": {
+      "get": {
+        "tags": [
+          "layouts"
+        ],
+        "summary": "Read one row and the revision it stands at.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The document and its ref.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/LayoutBodyLoad"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "layouts"
+        ],
+        "summary": "Replace the row, but only while it still stands at the quoted revision.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "If-Match",
+            "in": "header",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The revision this write believes it is replacing."
+          }
+        ],
+        "requestBody": {
+          "description": "The document to store.",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/LayoutBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The ref the service now holds.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/LayoutMetaWrite"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "The quoted revision is not the one that stands. The body carries the ref that does.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Conflict"
+                }
+              }
+            }
+          },
+          "428": {
+            "description": "The request carried no If-Match revision.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RevisionRequired"
+                }
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "layouts"
+        ],
+        "summary": "Delete the row, but only while it still stands at the quoted revision.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "If-Match",
+            "in": "header",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The revision this write believes it is replacing."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The ref the service removed.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/LayoutMetaWrite"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "The quoted revision is not the one that stands. The body carries the ref that does.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Conflict"
+                }
+              }
+            }
+          },
+          "428": {
+            "description": "The request carried no If-Match revision.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RevisionRequired"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/drawings": {
+      "get": {
+        "tags": [
+          "drawings"
+        ],
+        "summary": "List rows, metadata only.",
+        "parameters": [
+          {
+            "name": "symbol",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The symbol the document belongs to."
+          },
+          {
+            "name": "context",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "description": "The drawing-resource context token. The service keys rows by it and never parses it."
+            },
+            "description": "The drawing-resource context token."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The rows this principal may read.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DrawingsMetaList"
+                }
+              }
+            }
+          }
+        }
+      },
+      "post": {
+        "tags": [
+          "drawings"
+        ],
+        "summary": "Store a new row. The service mints the id, so a create quotes no revision.",
+        "parameters": [
+          {
+            "name": "symbol",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The symbol the document belongs to."
+          },
+          {
+            "name": "context",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "description": "The drawing-resource context token. The service keys rows by it and never parses it."
+            },
+            "description": "The drawing-resource context token."
+          }
+        ],
+        "requestBody": {
+          "description": "The document to store.",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/DrawingsBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The ref the service now holds.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DrawingsMetaWrite"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "A row already stands for this identity. The body carries its ref, which the caller loads instead of forking a second.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Conflict"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/drawings/{id}": {
+      "get": {
+        "tags": [
+          "drawings"
+        ],
+        "summary": "Read one row and the revision it stands at.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The document and its ref.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DrawingsBodyLoad"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "drawings"
+        ],
+        "summary": "Replace the row, but only while it still stands at the quoted revision.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "If-Match",
+            "in": "header",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The revision this write believes it is replacing."
+          }
+        ],
+        "requestBody": {
+          "description": "The document to store.",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/DrawingsBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The ref the service now holds.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DrawingsMetaWrite"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "The quoted revision is not the one that stands. The body carries the ref that does.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Conflict"
+                }
+              }
+            }
+          },
+          "428": {
+            "description": "The request carried no If-Match revision.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RevisionRequired"
+                }
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "drawings"
+        ],
+        "summary": "Delete the row, but only while it still stands at the quoted revision.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "If-Match",
+            "in": "header",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The revision this write believes it is replacing."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The ref the service removed.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DrawingsMetaWrite"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "The quoted revision is not the one that stands. The body carries the ref that does.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Conflict"
+                }
+              }
+            }
+          },
+          "428": {
+            "description": "The request carried no If-Match revision.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RevisionRequired"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/templates/{kind}": {
+      "get": {
+        "tags": [
+          "templates"
+        ],
+        "summary": "List rows, metadata only.",
+        "parameters": [
+          {
+            "name": "kind",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "study",
+                "drawing",
+                "palette"
+              ]
+            },
+            "description": "Which template collection: appearance palettes, indicator studies, or drawings."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The rows this principal may read.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TemplateMetaList"
+                }
+              }
+            }
+          }
+        }
+      },
+      "post": {
+        "tags": [
+          "templates"
+        ],
+        "summary": "Store a new row. The service mints the id, so a create quotes no revision.",
+        "parameters": [
+          {
+            "name": "kind",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "study",
+                "drawing",
+                "palette"
+              ]
+            },
+            "description": "Which template collection: appearance palettes, indicator studies, or drawings."
+          }
+        ],
+        "requestBody": {
+          "description": "The document to store.",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/TemplateBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The ref the service now holds.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TemplateMetaWrite"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "A row already stands for this identity. The body carries its ref, which the caller loads instead of forking a second.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Conflict"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/templates/{kind}/{id}": {
+      "get": {
+        "tags": [
+          "templates"
+        ],
+        "summary": "Read one row and the revision it stands at.",
+        "parameters": [
+          {
+            "name": "kind",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "study",
+                "drawing",
+                "palette"
+              ]
+            },
+            "description": "Which template collection: appearance palettes, indicator studies, or drawings."
+          },
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The document and its ref.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TemplateBodyLoad"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "templates"
+        ],
+        "summary": "Replace the row, but only while it still stands at the quoted revision.",
+        "parameters": [
+          {
+            "name": "kind",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "study",
+                "drawing",
+                "palette"
+              ]
+            },
+            "description": "Which template collection: appearance palettes, indicator studies, or drawings."
+          },
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "If-Match",
+            "in": "header",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The revision this write believes it is replacing."
+          }
+        ],
+        "requestBody": {
+          "description": "The document to store.",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/TemplateBody"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The ref the service now holds.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TemplateMetaWrite"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "The quoted revision is not the one that stands. The body carries the ref that does.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Conflict"
+                }
+              }
+            }
+          },
+          "428": {
+            "description": "The request carried no If-Match revision.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RevisionRequired"
+                }
+              }
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "templates"
+        ],
+        "summary": "Delete the row, but only while it still stands at the quoted revision.",
+        "parameters": [
+          {
+            "name": "kind",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "study",
+                "drawing",
+                "palette"
+              ]
+            },
+            "description": "Which template collection: appearance palettes, indicator studies, or drawings."
+          },
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "If-Match",
+            "in": "header",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The revision this write believes it is replacing."
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The ref the service removed.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TemplateMetaWrite"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No row with that id.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/NotFound"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "The quoted revision is not the one that stands. The body carries the ref that does.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Conflict"
+                }
+              }
+            }
+          },
+          "428": {
+            "description": "The request carried no If-Match revision.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RevisionRequired"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "ResourceRef": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Stable identity, minted by the service."
+          },
+          "revision": {
+            "type": "string",
+            "description": "The version this row stands at. Opaque to the client, compared for equality alone."
+          }
+        },
+        "required": [
+          "id",
+          "revision"
+        ],
+        "additionalProperties": false
+      },
+      "Conflict": {
+        "type": "object",
+        "properties": {
+          "error": {
+            "const": "conflict"
+          },
+          "current": {
+            "$ref": "#/components/schemas/ResourceRef"
+          }
+        },
+        "required": [
+          "error",
+          "current"
+        ],
+        "additionalProperties": false
+      },
+      "NotFound": {
+        "type": "object",
+        "properties": {
+          "error": {
+            "const": "not_found"
+          }
+        },
+        "required": [
+          "error"
+        ],
+        "additionalProperties": false
+      },
+      "RevisionRequired": {
+        "type": "object",
+        "properties": {
+          "error": {
+            "const": "revision_required"
+          }
+        },
+        "required": [
+          "error"
+        ],
+        "additionalProperties": false
+      },
+      "ChartMeta": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Stable identity, minted by the service."
+          },
+          "revision": {
+            "type": "string",
+            "description": "The version this row stands at. Opaque to the client, compared for equality alone."
+          },
+          "name": {
+            "type": "string"
+          },
+          "symbol": {
+            "type": "string"
+          },
+          "timeframe": {
+            "type": "string"
+          },
+          "updatedAt": {
+            "type": "integer",
+            "description": "Last write, milliseconds since the Unix epoch, stamped by the service."
+          }
+        },
+        "required": [
+          "id",
+          "revision",
+          "name",
+          "symbol",
+          "timeframe",
+          "updatedAt"
+        ],
+        "additionalProperties": false
+      },
+      "ChartBody": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "symbol": {
+            "type": "string"
+          },
+          "timeframe": {
+            "type": "string"
+          },
+          "content": {
+            "type": "string",
+            "description": "The serialized chart state. The service stores it without parsing it."
+          }
+        },
+        "required": [
+          "name",
+          "symbol",
+          "timeframe",
+          "content"
+        ],
+        "additionalProperties": false
+      },
+      "LayoutMeta": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Stable identity, minted by the service."
+          },
+          "revision": {
+            "type": "string",
+            "description": "The version this row stands at. Opaque to the client, compared for equality alone."
+          },
+          "name": {
+            "type": "string"
+          },
+          "symbol": {
+            "type": "string"
+          },
+          "timeframe": {
+            "type": "string"
+          },
+          "updatedAt": {
+            "type": "integer",
+            "description": "Last write, milliseconds since the Unix epoch, stamped by the service."
+          }
+        },
+        "required": [
+          "id",
+          "revision",
+          "name",
+          "updatedAt"
+        ],
+        "additionalProperties": false
+      },
+      "LayoutBody": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "symbol": {
+            "type": "string"
+          },
+          "timeframe": {
+            "type": "string"
+          },
+          "content": {
+            "type": "string",
+            "description": "The serialized layout state. The service stores it without parsing it."
+          }
+        },
+        "required": [
+          "name",
+          "content"
+        ],
+        "additionalProperties": false
+      },
+      "DrawingsMeta": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Stable identity, minted by the service."
+          },
+          "revision": {
+            "type": "string",
+            "description": "The version this row stands at. Opaque to the client, compared for equality alone."
+          },
+          "updatedAt": {
+            "type": "integer",
+            "description": "Last write, milliseconds since the Unix epoch, stamped by the service."
+          }
+        },
+        "required": [
+          "id",
+          "revision",
+          "updatedAt"
+        ],
+        "additionalProperties": false
+      },
+      "DrawingsBody": {
+        "type": "object",
+        "properties": {
+          "content": {
+            "type": "string",
+            "description": "The drawings document as JSON text. The service stores it without parsing it."
+          }
+        },
+        "required": [
+          "content"
+        ],
+        "additionalProperties": false
+      },
+      "TemplateMeta": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Stable identity, minted by the service."
+          },
+          "revision": {
+            "type": "string",
+            "description": "The version this row stands at. Opaque to the client, compared for equality alone."
+          },
+          "name": {
+            "type": "string"
+          },
+          "tool": {
+            "type": "string"
+          },
+          "updatedAt": {
+            "type": "integer",
+            "description": "Last write, milliseconds since the Unix epoch, stamped by the service."
+          }
+        },
+        "required": [
+          "id",
+          "revision",
+          "name",
+          "updatedAt"
+        ],
+        "additionalProperties": false
+      },
+      "TemplateBody": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "tool": {
+            "type": "string"
+          },
+          "content": {
+            "type": "string",
+            "description": "The serialized template state. The service stores it without parsing it."
+          }
+        },
+        "required": [
+          "name",
+          "content"
+        ],
+        "additionalProperties": false
+      },
+      "ChartMetaList": {
+        "type": "object",
+        "properties": {
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ChartMeta"
+            }
+          }
+        },
+        "required": [
+          "items"
+        ],
+        "additionalProperties": false
+      },
+      "LayoutMetaList": {
+        "type": "object",
+        "properties": {
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/LayoutMeta"
+            }
+          }
+        },
+        "required": [
+          "items"
+        ],
+        "additionalProperties": false
+      },
+      "DrawingsMetaList": {
+        "type": "object",
+        "properties": {
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/DrawingsMeta"
+            }
+          }
+        },
+        "required": [
+          "items"
+        ],
+        "additionalProperties": false
+      },
+      "TemplateMetaList": {
+        "type": "object",
+        "properties": {
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TemplateMeta"
+            }
+          }
+        },
+        "required": [
+          "items"
+        ],
+        "additionalProperties": false
+      },
+      "ChartBodyLoad": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Stable identity, minted by the service."
+          },
+          "revision": {
+            "type": "string",
+            "description": "The version this row stands at. Opaque to the client, compared for equality alone."
+          },
+          "body": {
+            "$ref": "#/components/schemas/ChartBody"
+          }
+        },
+        "required": [
+          "id",
+          "revision",
+          "body"
+        ],
+        "additionalProperties": false
+      },
+      "LayoutBodyLoad": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Stable identity, minted by the service."
+          },
+          "revision": {
+            "type": "string",
+            "description": "The version this row stands at. Opaque to the client, compared for equality alone."
+          },
+          "body": {
+            "$ref": "#/components/schemas/LayoutBody"
+          }
+        },
+        "required": [
+          "id",
+          "revision",
+          "body"
+        ],
+        "additionalProperties": false
+      },
+      "DrawingsBodyLoad": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Stable identity, minted by the service."
+          },
+          "revision": {
+            "type": "string",
+            "description": "The version this row stands at. Opaque to the client, compared for equality alone."
+          },
+          "body": {
+            "$ref": "#/components/schemas/DrawingsBody"
+          }
+        },
+        "required": [
+          "id",
+          "revision",
+          "body"
+        ],
+        "additionalProperties": false
+      },
+      "TemplateBodyLoad": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Stable identity, minted by the service."
+          },
+          "revision": {
+            "type": "string",
+            "description": "The version this row stands at. Opaque to the client, compared for equality alone."
+          },
+          "body": {
+            "$ref": "#/components/schemas/TemplateBody"
+          }
+        },
+        "required": [
+          "id",
+          "revision",
+          "body"
+        ],
+        "additionalProperties": false
+      },
+      "ChartMetaWrite": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Stable identity, minted by the service."
+          },
+          "revision": {
+            "type": "string",
+            "description": "The version this row stands at. Opaque to the client, compared for equality alone."
+          },
+          "meta": {
+            "$ref": "#/components/schemas/ChartMeta"
+          }
+        },
+        "required": [
+          "id",
+          "revision"
+        ],
+        "additionalProperties": false
+      },
+      "LayoutMetaWrite": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Stable identity, minted by the service."
+          },
+          "revision": {
+            "type": "string",
+            "description": "The version this row stands at. Opaque to the client, compared for equality alone."
+          },
+          "meta": {
+            "$ref": "#/components/schemas/LayoutMeta"
+          }
+        },
+        "required": [
+          "id",
+          "revision"
+        ],
+        "additionalProperties": false
+      },
+      "DrawingsMetaWrite": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Stable identity, minted by the service."
+          },
+          "revision": {
+            "type": "string",
+            "description": "The version this row stands at. Opaque to the client, compared for equality alone."
+          },
+          "meta": {
+            "$ref": "#/components/schemas/DrawingsMeta"
+          }
+        },
+        "required": [
+          "id",
+          "revision"
+        ],
+        "additionalProperties": false
+      },
+      "TemplateMetaWrite": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Stable identity, minted by the service."
+          },
+          "revision": {
+            "type": "string",
+            "description": "The version this row stands at. Opaque to the client, compared for equality alone."
+          },
+          "meta": {
+            "$ref": "#/components/schemas/TemplateMeta"
+          }
+        },
+        "required": [
+          "id",
+          "revision"
+        ],
+        "additionalProperties": false
+      }
+    }
+  }
+}