List running jobs
October 12, 2026
Table of contents
List the jobs running right now and, for every added account, how many of its maxJobs slots they take.
A job is listed from the moment POST /jobs/image or POST /jobs/video accepts it until it completes or fails. Each listed job takes one of its account’s slots. When all slots of an account are taken, a new job on it is refused with 429, and a job without email or inputs goes to another account that has a free slot. Uploads take no slot. Fetch a single job with GET /jobs/jobid.
This endpoint reads our own records only and never calls Muse, so it is cheap to poll.
https://api.useapi.net/v1/muse/jobs
Request Headers
Authorization: Bearer {API token}
API tokenis required, see Setup useapi.net for details.
Responses
-
{ "running": [ { "jobid": "j1012012359487240036i-u12345-email:[email protected]:bcaa91f0-24e0-4b7e-8d2c-6624bf9562e0-bot:muse", "email": "[email protected]", "created": "2026-10-12T01:23:59.487Z", "type": "image" } ], "accounts": { "[email protected]": { "running": 1, "maxJobs": 1 } } } -
No Muse account is added yet.
{ "error": "Please configure at least one account at https://useapi.net/docs/api-muse-v1/post-muse-accounts", "code": 400 } -
Invalid API token.
{ "error": "useapi.net ⁝ Unauthorized", "code": 401 }
Model
{ // TypeScript, all fields are optional
running: {
jobid: string
email: string // the account the job runs on
created: string // ISO 8601, when the job was accepted
type: 'image' | 'video'
}[]
accounts: {
[email: string]: {
running: number // jobs running on this account now
maxJobs: number // its limit, set with POST /accounts
}
}
}
Examples
-
curl "https://api.useapi.net/v1/muse/jobs" \ -H "Authorization: Bearer …" -
const token = "API token"; const apiUrl = "https://api.useapi.net/v1/muse/jobs"; const response = await fetch(apiUrl, { headers: { "Authorization": `Bearer ${token}`, }, }); const result = await response.json(); console.log("response", {response, result}); -
import requests token = "API token" apiUrl = "https://api.useapi.net/v1/muse/jobs" headers = { "Authorization" : f"Bearer {token}" } response = requests.get(apiUrl, headers=headers) print(response, response.json())