Sume GET /v1/jobs: a misspelled filter returns 400, not all jobs
Sume rejects an unrecognized query parameter on GET /v1/jobs with 400 unknown_parameter, so a typo cannot return an unfiltered page. Valid filters listed.
On GET /v1/jobs, an unrecognized query parameter returns 400 unknown_parameter and not a silently unfiltered page. So ?state=processing fails loudly, where it could have returned every job and sent your sweep after the wrong set. The filter that exists is status.
The query parameters
These are the parameters in the SDK's generated types for the list call.
| Parameter | Values |
|---|---|
status | queued, processing, completed, failed, canceled |
type | A job type string |
limit | Up to 100 per page |
starting_after | The next_cursor from the previous page |
scope, thread_id, run_id | Narrow by thread or run; they never widen what a key can read |
A correct call
curl "https://api.sume.com/v1/jobs?status=processing&limit=50" \
-H "Authorization: Bearer $SUME_API_KEY"Why this is good for migrations
A ported client often carries over the old vendor's filter names. Failing on an unknown name is safer than a page that looks right and is wrong. Treat a 400 here as a bug in your request, not as something to retry.
Sources
Related posts
More in Developers
- Sume MCP tool names: tools.list or tools_list, which one to call?
Use the underscore ids from tools_list, like generate_image. Sume also accepts dotted aliases, but tools_schema wants snake_case and clients may add a prefix.
- A Sume poll returned HTML: guard the JSON parse in Python
A proxy or edge can answer a Sume poll with an HTML page. A tested stdlib Python helper that returns None for non-JSON bodies so your loop retries, not crashes.
- Sume 503 provider_capacity_exceeded: retry later, same key
provider_capacity_exceeded means Sume's provider dispatch queue is full. Retry later with the same Idempotency-Key. provider_not_configured is different.
- Sume has two 429s: rate_limited and queue_full, handled differently
rate_limited is a request window. queue_full means workspace concurrency and queue capacity are both full; wait for a job to finish or cancel one.
Written by Sume