API Reference

Full reference for every endpoint in the Masko API. All requests require an Authorization: Bearer masko_YOUR_API_KEY header.

Base URL: https://api.masko.ai/v1

Tip

Download the OpenAPI spec (JSON) to import into Postman, Insomnia, or any OpenAPI-compatible tool.

Projects

POST/v1/projectsCreate a project

GET/v1/projectsList your projects

Collections

POST/v1/collectionsCreate a collection

GET/v1/collectionsList collections

GET/v1/collections/:idGet collection details

PATCH/v1/collections/:idUpdate a collection

PATCH/v1/collections/:id/settingsUpdate collection settings

GET/v1/collections/:id/cdn-statusCDN publish status

PATCH/v1/collections/:id/cdn-slugSet CDN slug

GET/v1/collections/:id/urlsGet signed URLs for collection assets

Items

GET/v1/collections/:id/itemsList items in a collection

GET/v1/collections/:id/items/:itemIdGet item details

PATCH/v1/collections/:id/items/:itemIdUpdate an item

Assets

GET/v1/collections/:id/assetsList assets in a collection

References

POST/v1/collections/:id/referencesAdd reference image

DELETE/v1/collections/:id/referencesRemove reference image

Generation

POST/v1/collections/:id/generate1-21Generate image, animation, edit, or logo

POST/v1/collections/:id/generate-batchBatch generate multiple items

POST/v1/generate/preview1Preview generation without saving

Canvas

POST/v1/collections/:id/canvasesCreate a canvas

GET/v1/collections/:id/canvases/:canvasIdGet canvas details

POST/v1/collections/:id/canvases/:canvasId/from-templateApply a template

POST/v1/collections/:id/canvases/:canvasId/generate-allGenerate all animations

GET/v1/collections/:id/canvases/:canvasId/statusCheck generation progress

GET/v1/collections/:id/canvases/:canvasId/exportExport MaskoAnimationConfig

Canvas Templates

GET/v1/canvas-templatesList available templates

GET/v1/canvas-templates/:idGet template details

Jobs

GET/v1/jobsList recent jobs

GET/v1/jobs/:idGet job status (supports ?wait=true)

Analysis

POST/v1/analyze-imageAnalyze an image with AI

POST/v1/analyze-urlAnalyze a website URL

POST/v1/collections/:id/suggest-actionsGet AI-suggested next actions

Uploads

POST/v1/uploadUpload an image file

Styles

GET/v1/stylesList available generation styles

Credits

GET/v1/creditsCheck your credit balance

Webhooks

GET/v1/webhooksList your webhooks

POST/v1/webhooksCreate a webhook

DELETE/v1/webhooks/:idDelete a webhook