{"openapi":"3.1.0","info":{"title":"Little Emperors studio — photograph descriptions","version":"2.0.0","description":"Read photographs and edit their name, short and long descriptions and tags. Changes belong to the member who issued the access key. The key cannot publish, schedule or change anything else."},"servers":[{"url":"https://studio.littleemperors.com"}],"security":[{"accessKey":[]}],"components":{"securitySchemes":{"accessKey":{"type":"http","scheme":"bearer"}},"schemas":{"Photo":{"type":"object","properties":{"id":{"type":"string"},"hotel":{"type":"string"},"src":{"type":"string","format":"uri"},"caption":{"type":"string"},"visualTags":{"type":"array","items":{"type":"string"}},"name":{"type":"string","maxLength":180},"short":{"type":"string","maxLength":300},"long":{"type":"string","maxLength":4000},"tags":{"type":"array","maxItems":40,"items":{"type":"string","minLength":1,"maxLength":80}}}}}},"paths":{"/api/v1/photos":{"get":{"operationId":"listPhotos","summary":"List photographs with their current descriptions","parameters":[{"in":"query","name":"cursor","description":"nextCursor from the previous page; omit for the first page","schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":50}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"photos":{"type":"array","items":{"$ref":"#/components/schemas/Photo"}},"nextCursor":{"type":["string","null"]}}}}}},"401":{"description":"Missing, expired or revoked access key"}}}},"/api/v1/photos/{id}":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"get":{"operationId":"getPhoto","summary":"Read one photograph","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Photo"}}}},"401":{"description":"Missing, expired or revoked access key"}}},"patch":{"operationId":"editPhoto","summary":"Save revised descriptions or tags","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","minProperties":1,"additionalProperties":false,"properties":{"name":{"type":"string","maxLength":180},"short":{"type":"string","maxLength":300},"long":{"type":"string","maxLength":4000},"tags":{"type":"array","maxItems":40,"items":{"type":"string","minLength":1,"maxLength":80}}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Photo"}}}},"401":{"description":"Missing, expired or revoked access key"}}}}}}