List jobs, newest first
Lists jobs newest first. At a deployment’s address, the jobs sent to that deployment; at the workspace address, every job in the caller’s workspace. A caller never sees another workspace’s jobs.
Filter by your own labels with metadata[<key>]=<value>, up to 3
times; a job is listed only when every pair matches exactly. A 4th
filter, a repeated key, a key outside the key rule, or a value with a
character no label may hold (a control character or a bidirectional
embedding, override or isolate, as on submit) is refused 400
invalid_metadata_filter. A filter value must be URL-encoded; a raw
; or a bad % escape answers 400 invalid_metadata_filter.
Pages: pass the response’s next_cursor back as cursor, with the
same filters, to read the next page. next_cursor is absent on the
last page. Each job appears once across the pages.
List items are a job’s stored record, not the Job object: they
carry no outputs and no urls. Read a job with
GET /api/v2/jobs/{id} for its outputs.
Only the serverless platform lists jobs today. Comfy Cloud answers
501 not_implemented.
承認
Authorization: Bearer <credential>. The credential is one of: an account-scoped API key (comfyui-…), accepted on Cloud and serverless; a Comfy Cloud session JWT; or an OAuth access token issued for the Comfy Cloud resource. Which kinds a given deployment accepts is deployment configuration — an API key always works on Cloud and serverless, and a deployment that does not accept JWT bearers answers 401 with a message saying so. Self-hosted accepts unauthenticated requests by default and can be configured with a static bearer token.
クエリパラメータ
Most jobs per page. Above 500 is read as 500; absent means 500. Not a positive integer: 422 invalid_request.
x >= 1The previous page's next_cursor, unchanged. Opaque: do not build or edit one. A cursor that is not well-formed is refused 400 invalid_cursor. Cursors are not signed, so a well-formed one is read as a position whether or not this list issued it.
Exact-match label filters, written metadata[client]=acme. Up to 3; all must match.