List generation jobs
Returns paginated generation jobs owned by the caller, newest first. Use to track recent activity or find a specific job. Filter by status or mascot. No credit cost.
Select Masko-API-Version: 2026-09-26 (or api_version=2026-09-26) for the canonical mascot contract shown first. Existing unversioned clients keep legacy collection fields. A mascot_id query filter also selects the canonical contract. Mixing identifier names returns 400.
Request
- Base URL: https://api.masko.ai
- URL: https://api.masko.ai/v1/jobs
- Auth: HTTP bearer
Query parameters
Page size. 1 to 100. Defaults to 50.
Number of records to skip. Defaults to 0.
Opaque next_cursor from the previous page. Use instead of offset.
Filter transitions by the variant of the starting pose.
Filter transitions by the variant of the ending pose.
Filter jobs by their single variant. Cross-variant transitions have no single variant; use from_variant_id or to_variant_id.
Filter by status: pending, processing, completed, failed.
Filter to jobs for a mascot in the credential workspace. A mascot outside that workspace returns 404.
Filter by job type. Values: item_generation, image_generation, logo, animation, video_edit, reverse, size_variant, size_variant_batch, export_animation, scene_generation, interactive_generation, sticker_generation, svg_generation.
Equivalent to the version header, for polling URLs and clients that accept only relative paths. Header and query must agree.
Filter to jobs for a mascot in the credential workspace. A mascot outside that workspace returns 404.
Legacy-only filter. Use mascot_id for new clients; never send both.
Headers
Use 2026-09-26 for mascot_id resource fields. Unversioned shared routes retain the legacy contract.
Response
List of jobs
Changes
No recorded changes to this operation across all 1 revision of this API.