List running jobs

October 12, 2026

Table of contents

  1. Request Headers
  2. Responses
  3. Model
  4. Examples
  5. Try It

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}
Responses
  • 200 OK

    {
      "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
        }
      }
    }
    
  • 400 Bad Request

    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
    }
    
  • 401 Unauthorized

    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())
    
Try It