REST API
The `/v1` reference, generated from the running server.
The machine-readable spec
OpenAPI
https://api.askdeck.ai/v1/openapi.jsonThis is generated from the running server, so it can never describe an endpoint we do not serve. Point your client generator at it.
The shape of every call
- Base URL
https://api.askdeck.ai/v1. Authorization: Bearer <your key>on every request.- JSON in, JSON out. Errors are RFC 9457 problem+json.
- Creation endpoints answer
202with a task envelope; reads answer200.
The task envelope
Every deck and video operation answers with the same envelope, so one parser handles all of them.
| Field | Meaning |
|---|---|
| taskId | Opaque handle. Do not parse it; it is not a database id. |
| status | One of working, input_required, completed, failed, cancelled. |
| statusMessage | A human-readable line safe to show a user. |
| pollIntervalMs | How often to poll. 5000. |
| ttlMs | How long the handle stays valid. 86400000. |
| ai.askdeck/* | Our extensions — download URL, error, resume URL. Fields may be added; existing ones are never removed without notice on the changelog. |