{"openapi":"3.1.0","info":{"title":"WebYore API","version":"1.0.0","description":"Create and manage Direct Links and paid hosted images."},"servers":[{"url":"https://api.webyore.com/v1"}],"security":[{"bearerAuth":[]}],"paths":{"/links":{"post":{"summary":"Create a Direct Link","operationId":"createLink","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateLink"}}}},"responses":{"201":{"description":"Created"},"400":{"$ref":"#/components/responses/Error"}}},"get":{"summary":"List Direct Links","operationId":"listLinks","parameters":[{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"responses":{"200":{"description":"Link collection"}}}},"/links/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Get a Direct Link","operationId":"getLink","responses":{"200":{"description":"Link"}}},"patch":{"summary":"Change a Direct Link destination","operationId":"updateLink","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateLink"}}}},"responses":{"200":{"description":"Updated"}}},"delete":{"summary":"Disable a Direct Link","operationId":"deleteLink","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Disabled"}}}},"/images":{"post":{"summary":"Upload a hosted image","operationId":"createImage","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"image/jpeg":{"schema":{"type":"string","contentEncoding":"binary"}},"image/png":{"schema":{"type":"string","contentEncoding":"binary"}},"image/webp":{"schema":{"type":"string","contentEncoding":"binary"}},"image/gif":{"schema":{"type":"string","contentEncoding":"binary"}},"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"202":{"description":"Accepted for normalization"}}},"get":{"summary":"List hosted images","operationId":"listImages","responses":{"200":{"description":"Image collection"}}}},"/images/{id}":{"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Get hosted-image metadata","operationId":"getImage","responses":{"200":{"description":"Image"}}},"delete":{"summary":"Delete a hosted image","operationId":"deleteImage","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"responses":{"200":{"description":"Deleted"}}}},"/usage":{"get":{"summary":"Get account usage","operationId":"getUsage","responses":{"200":{"description":"Usage"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"WebYore API key"}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128}}},"schemas":{"CreateLink":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","maxLength":2048},"custom_slug":{"type":"string","pattern":"^[A-Za-z0-9_-]{4,32}$"}},"additionalProperties":false},"UpdateLink":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri","maxLength":2048}},"additionalProperties":false},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}}}}}},"responses":{"Error":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}