Jobs

List jobs

Lists the subscription's jobs, newest first, with optional status/operation/source filters and keyset cursor pagination. The list also holds the jobs the web app records when a workspace member spends credits there (source: "web", for example edit_font, marketing_resource or wrap_cover_generate): they draw on the same credit balance. Result payloads are omitted — poll GET /api/v1/jobs/{jobId} for signed cover URLs.

get/api/v1/jobs

Request

  • Base URL: https://beyourcover.com
  • URL: https://beyourcover.com/api/v1/jobs
  • Auth: HTTP bearer

Query parameters

status'queued' | 'processing' | 'completed' | 'failed'

Filter by job status.

operation'generate' | 'variation' | 'edit_image' | 'upscale' | 'audiobook_cover' | 'remove_text' | 'generate_reference' | 'wrap' | 'wrap_extend_front' | 'generate_single' | 'edit_font' | 'convert_style' | 'layerize_text' | 'remove_text_variants' | 'audiobook_generate' | 'marketing_resource' | 'kit_regeneration' | 'brand_kit_extract' | 'series_next_book' | 'wrap_cover_generate' | 'wrap_cover_regenerate' | 'audiobook_upscale' | 'refine_cover' | 'wrap_back_cover_generate' | 'wrap_cover_export'

Filter by operation. Accepts every operation a listed job can carry: the API's, the web app's, and older web operations that nothing writes now (audiobook_upscale, refine_cover, wrap_back_cover_generate, wrap_cover_export).

source'api' | 'web'

Filter by where the job ran: api (this API or the MCP server) or web (the web app).

limitinteger

Page size (default 20, max 100).

cursorstring

Opaque cursor from a previous response's next_cursor. Omit for the first page.

Response

One page of jobs.

next_cursorstring nullable required

Pass as cursor to fetch the next page. null when there are no more results.

Changes

No recorded changes to this operation across all 1 revision of this API.