{"openapi":"3.1.0","info":{"title":"SlideVids Public API","version":"1.0.0","description":"Public API for programmatic timeline, render, and asset workflows."},"servers":[{"url":"https://api.slidevids.com/v1"},{"url":"http://localhost:4010/v1"}],"tags":[{"name":"account"},{"name":"renders"},{"name":"templates"},{"name":"timelines"},{"name":"slides"},{"name":"audio"},{"name":"webhooks"}],"components":{"schemas":{},"parameters":{},"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"},"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/me":{"get":{"operationId":"getMe","tags":["account"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}}},"/entitlements":{"get":{"operationId":"getEntitlements","tags":["account"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}}},"/renders":{"get":{"operationId":"listRenders","tags":["renders"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}},"post":{"operationId":"createRender","tags":["renders"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}},"callbacks":{"renderEvents":{"{$request.body#/webhook_url}":{"post":{"description":"Inline webhook callback for render events","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"string","enum":["render.completed","render.failed","render.progress"]},"event_id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object","additionalProperties":true}},"required":["event","event_id","created_at","data"]}}}},"responses":{"2XX":{"description":"Consumer accepted callback"}}}}}}}},"/renders/{id}":{"get":{"operationId":"getRender","tags":["renders"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}},"delete":{"operationId":"cancelRender","tags":["renders"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}}},"/templates":{"get":{"operationId":"listTemplates","tags":["templates"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}}},"/templates/{id}":{"get":{"operationId":"getTemplate","tags":["templates"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}}},"/timelines":{"get":{"operationId":"listTimelines","tags":["timelines"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}},"post":{"operationId":"createTimeline","tags":["timelines"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}}},"/timelines/{id}":{"get":{"operationId":"getTimeline","tags":["timelines"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}},"put":{"operationId":"updateTimeline","tags":["timelines"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}},"delete":{"operationId":"deleteTimeline","tags":["timelines"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}}},"/timelines/{id}/slides":{"get":{"operationId":"listSlides","tags":["slides"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}},"post":{"operationId":"createSlide","tags":["slides"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}}},"/timelines/{id}/slides/reorder":{"patch":{"operationId":"reorderSlides","tags":["slides"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}}},"/timelines/{id}/slides/{sid}":{"put":{"operationId":"updateSlide","tags":["slides"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"sid","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}},"delete":{"operationId":"deleteSlide","tags":["slides"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"sid","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}}},"/timelines/{id}/slides/{sid}/images":{"post":{"operationId":"uploadSlideImage","tags":["slides"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"sid","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}},"delete":{"operationId":"deleteSlideImage","tags":["slides"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"sid","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}}},"/timelines/{id}/slides/{sid}/audio":{"get":{"operationId":"getSlideAudio","tags":["audio"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"sid","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}},"post":{"operationId":"generateSlideAudio","tags":["audio"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string"},"required":true,"name":"sid","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}}},"/webhooks":{"get":{"operationId":"listWebhooks","tags":["webhooks"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}},"post":{"operationId":"createWebhook","tags":["webhooks"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}}},"/webhooks/{id}":{"get":{"operationId":"getWebhook","tags":["webhooks"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}},"delete":{"operationId":"deleteWebhook","tags":["webhooks"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}}},"/webhooks/{id}/test":{"post":{"operationId":"testWebhook","tags":["webhooks"],"parameters":[{"schema":{"type":"string"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"default":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string"},"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["type","code","message"]}},"required":["error"]}}}}}}}},"webhooks":{"render.completed":{"post":{"tags":["webhooks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"string","enum":["render.completed","render.failed","render.progress"]},"event_id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object","additionalProperties":true}},"required":["event","event_id","created_at","data"]}}}},"responses":{"2XX":{"description":"Consumer accepted webhook"}},"operationId":"renderCompletedWebhook"}},"render.failed":{"post":{"tags":["webhooks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"string","enum":["render.completed","render.failed","render.progress"]},"event_id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object","additionalProperties":true}},"required":["event","event_id","created_at","data"]}}}},"responses":{"2XX":{"description":"Consumer accepted webhook"}},"operationId":"renderFailedWebhook"}},"render.progress":{"post":{"tags":["webhooks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event":{"type":"string","enum":["render.completed","render.failed","render.progress"]},"event_id":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"data":{"type":"object","additionalProperties":true}},"required":["event","event_id","created_at","data"]}}}},"responses":{"2XX":{"description":"Consumer accepted webhook"}},"operationId":"renderProgressWebhook"}}},"security":[{"apiKeyAuth":[]},{"bearerAuth":[]}]}