{"openapi":"3.1.0","info":{"title":"DEV3 Kilnfront API","version":"1.0.0"},"servers":[{"url":"/api/v1"}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","bearerFormat":"n3k_…"}}},"paths":{"/me":{"get":{"summary":"The store this key belongs to","tags":["Store"],"security":[{"bearer":[]}],"x-scope":"read","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"plan":{"type":"string"},"store":{"type":"string"},"currency":{"type":"string"}},"required":["id","name","plan","store","currency"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/usage":{"get":{"summary":"Usage for the current billing period","tags":["Billing"],"security":[{"bearer":[]}],"x-scope":"read","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"plan":{"type":"string"},"rows":{"type":"array","items":{"type":"object","properties":{"metric":{"type":"string"},"used":{"type":"number"},"limit":{"type":"number"}},"required":["metric","used","limit"],"additionalProperties":false}}},"required":["plan","rows"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/products":{"get":{"summary":"List products","tags":["Catalogue"],"security":[{"bearer":[]}],"x-scope":"read","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"slug":{"type":"string"},"status":{"type":"string","enum":["draft","active","archived"]},"vendor":{"type":"string"},"type":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"variants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"sku":{"type":["string","null"]},"price":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"compareAt":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"stock":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","title","price","stock"],"additionalProperties":false}}},"required":["id","title","slug","status","vendor","type","tags","variants"],"additionalProperties":false}},"total":{"type":"number"}},"required":["data","total"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}},"post":{"summary":"Create a product","tags":["Catalogue"],"security":[{"bearer":[]}],"x-scope":"write","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":160},"status":{"default":"draft","type":"string","enum":["draft","active","archived"]},"vendor":{"default":"","type":"string","maxLength":60},"type":{"default":"","type":"string","maxLength":60},"tags":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","maxLength":40}},"description":{"default":"","type":"string","maxLength":5000},"variants":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"title":{"default":"Default","type":"string","maxLength":120},"sku":{"type":"string","maxLength":60},"price":{"type":"integer","minimum":0,"maximum":9007199254740991},"compareAt":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"stock":{"default":0,"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["title","price","stock"],"additionalProperties":false}}},"required":["title","status","vendor","type","tags","description","variants"],"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"slug":{"type":"string"},"status":{"type":"string","enum":["draft","active","archived"]},"vendor":{"type":"string"},"type":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"variants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"sku":{"type":["string","null"]},"price":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"compareAt":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"stock":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","title","price","stock"],"additionalProperties":false}}},"required":["id","title","slug","status","vendor","type","tags","variants"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/products/{id}":{"get":{"summary":"Get a product","tags":["Catalogue"],"security":[{"bearer":[]}],"x-scope":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"slug":{"type":"string"},"status":{"type":"string","enum":["draft","active","archived"]},"vendor":{"type":"string"},"type":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"variants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"sku":{"type":["string","null"]},"price":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"compareAt":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"stock":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","title","price","stock"],"additionalProperties":false}}},"required":["id","title","slug","status","vendor","type","tags","variants"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}},"patch":{"summary":"Update a product","tags":["Catalogue"],"security":[{"bearer":[]}],"x-scope":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":160},"status":{"type":"string","enum":["draft","active","archived"]},"vendor":{"type":"string","maxLength":60},"tags":{"maxItems":30,"type":"array","items":{"type":"string","maxLength":40}}},"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"slug":{"type":"string"},"status":{"type":"string","enum":["draft","active","archived"]},"vendor":{"type":"string"},"type":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"variants":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"sku":{"type":["string","null"]},"price":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"compareAt":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"stock":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["id","title","price","stock"],"additionalProperties":false}}},"required":["id","title","slug","status","vendor","type","tags","variants"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}},"delete":{"summary":"Archive a product","tags":["Catalogue"],"security":[{"bearer":[]}],"x-scope":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/variants/{id}/stock":{"patch":{"summary":"Set stock on hand for a variant","tags":["Catalogue"],"security":[{"bearer":[]}],"x-scope":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"stock":{"type":"integer","minimum":-100000,"maximum":10000000},"locationId":{"type":"string","pattern":"^[a-f0-9]{24}$"}},"required":["stock"],"additionalProperties":false}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/orders":{"get":{"summary":"List orders","tags":["Orders"],"security":[{"bearer":[]}],"x-scope":"read","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"payment","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"email":{"type":"string"},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"currency":{"type":"string"},"paymentStatus":{"type":"string"},"fulfillmentStatus":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string"}},"required":["id","number","email","total","currency","paymentStatus","fulfillmentStatus","status","createdAt"],"additionalProperties":false}},"total":{"type":"number"}},"required":["data","total"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/orders/{id}":{"get":{"summary":"Get an order with its lines","tags":["Orders"],"security":[{"bearer":[]}],"x-scope":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"number":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"email":{"type":"string"},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"currency":{"type":"string"},"paymentStatus":{"type":"string"},"fulfillmentStatus":{"type":"string"},"status":{"type":"string"},"createdAt":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"qty":{"type":"number"},"price":{"type":"number"}},"required":["title","qty","price"],"additionalProperties":false}}},"required":["id","number","email","total","currency","paymentStatus","fulfillmentStatus","status","createdAt","items"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/orders/{id}/fulfill":{"post":{"summary":"Fulfil the remaining items of an order","tags":["Orders"],"security":[{"bearer":[]}],"x-scope":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"carrier":{"type":"string","maxLength":40},"tracking":{"type":"string","maxLength":80}},"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"status":{"type":"string"}},"required":["status"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/orders/{id}/refund":{"post":{"summary":"Refund an order (amount in minor units)","tags":["Orders"],"security":[{"bearer":[]}],"x-scope":"write","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"amount":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"restock":{"default":false,"type":"boolean"},"reason":{"type":"string","maxLength":120}},"required":["amount","restock"],"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"amount":{"type":"number"},"full":{"type":"boolean"}},"required":["amount","full"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/customers":{"get":{"summary":"List customers","tags":["Customers"],"security":[{"bearer":[]}],"x-scope":"read","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"name":{"type":"string"},"orders":{"type":"number"},"spent":{"type":"number"}},"required":["id","email","name","orders","spent"],"additionalProperties":false}},"total":{"type":"number"}},"required":["data","total"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/discounts":{"get":{"summary":"List discounts","tags":["Marketing"],"security":[{"bearer":[]}],"x-scope":"read","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"code":{"type":["string","null"]},"method":{"type":"string"},"title":{"type":["string","null"]},"kind":{"type":"string"},"value":{"type":"number"},"priority":{"type":"number"},"usedCount":{"type":"number"}},"required":["id","code","kind","value","usedCount"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}},"post":{"summary":"Create a discount code","tags":["Marketing"],"security":[{"bearer":[]}],"x-scope":"write","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"code":{"type":"string","minLength":3,"maxLength":24,"pattern":"^[A-Za-z0-9_-]+$"},"kind":{"type":"string","enum":["percent","fixed","free_shipping"]},"value":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991},"usageLimit":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"minSubtotal":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["code","kind","value","minSubtotal"],"additionalProperties":false}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"code":{"type":"string"}},"required":["id","code"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/members":{"get":{"summary":"List staff members","tags":["Store"],"security":[{"bearer":[]}],"x-scope":"read","parameters":[{"name":"role","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"email":{"type":"string"},"role":{"type":"string"}},"required":["id","name","email","role"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/suppliers":{"get":{"summary":"List suppliers","tags":["Purchasing"],"security":[{"bearer":[]}],"x-scope":"read","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"code":{"type":"string"},"email":{"type":"string"},"leadTimeDays":{"type":"number"},"currency":{"type":"string"},"status":{"type":"string"}},"required":["id","name","code","email","leadTimeDays","currency","status"],"additionalProperties":false}},"total":{"type":"number"}},"required":["data","total"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/purchase-orders":{"get":{"summary":"List purchase orders","tags":["Purchasing"],"security":[{"bearer":[]}],"x-scope":"read","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"number":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"supplierId":{"type":"string"},"status":{"type":"string"},"currency":{"type":"string"},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expectedAt":{"type":["string","null"]},"createdAt":{"type":"string"}},"required":["id","number","supplierId","status","currency","total","expectedAt","createdAt"],"additionalProperties":false}},"total":{"type":"number"}},"required":["data","total"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/purchase-orders/{id}":{"get":{"summary":"Get a purchase order with its lines","tags":["Purchasing"],"security":[{"bearer":[]}],"x-scope":"read","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"number":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"supplierId":{"type":"string"},"status":{"type":"string"},"currency":{"type":"string"},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expectedAt":{"type":["string","null"]},"createdAt":{"type":"string"},"lines":{"type":"array","items":{"type":"object","properties":{"variantId":{"type":"string"},"title":{"type":"string"},"sku":{"type":"string"},"qty":{"type":"number"},"received":{"type":"number"},"cost":{"type":"number"}},"required":["variantId","title","sku","qty","received","cost"],"additionalProperties":false}}},"required":["id","number","supplierId","status","currency","total","expectedAt","createdAt","lines"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}},"/metafields":{"get":{"summary":"List custom field definitions","tags":["Catalogue"],"security":[{"bearer":[]}],"x-scope":"read","parameters":[{"name":"owner","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"ownerType":{"type":"string"},"key":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"list":{"type":"boolean"}},"required":["id","ownerType","key","name","type","list"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Missing or invalid API key"},"402":{"description":"Plan quota exceeded"},"403":{"description":"Key lacks the required scope"},"422":{"description":"Validation failed"},"429":{"description":"Rate limited"}}}}}}