---
title: "Un travail de la file audio, a soi"
method: GET
path: "/queue/{id}"
tags: ["pipeline"]
---

# Un travail de la file audio, a soi

`GET /queue/{id}`

## Request

- Base URL: `https://jam-jam.org/api/v1`
- URL: `https://jam-jam.org/api/v1/queue/{id}`
- Auth: one of:
  - HTTP bearer
  - none

Portee `queue:read`, compte requis. 404 indifferencie pour un travail inconnu ou d'un autre compte.

## Response `200`

Le travail

- AudioPipelineJob: Un travail de la file de traitement audio serveur (Lot L5). Forme stable pour l'API publique (`base_song_id`/`source_sha256` sont des noms de colonnes SQL, deliberement gardes tels quels : c'est la MEME file, la meme forme, que l'application).
  - `id` string, required
  - `base_song_id` string
  - `source_sha256` string
  - `origin` 'mobile' | 'web' | 'api'
  - `tier` 'free' | 'unlimited'
  - `status` 'queued' | 'active' | 'done' | 'failed' | 'cancelled', required
  - `stage` 'analyze' | 'align', required
  - `analyze_status` 'pending' | 'running' | 'done' | 'failed', required
  - `align_status` 'pending' | 'running' | 'done' | 'failed' | 'skipped' | 'cancelled', required
  - `stems_status` 'pending' | 'submitted' | 'done' | 'failed' | 'skipped'
  - `progress` integer, required
  - `error_code` string
  - `rank` integer: Position dans la file (queued seulement)
  - `reused` boolean: Vrai si ce depot a reutilise un travail existant (idempotence)
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `claimed_at` string, date-time
  - `started_at` string, date-time
  - `finished_at` string, date-time

## Other responses

- `401`: Toute erreur de cette API, quel que soit le code HTTP, est un `application/problem+json` (RFC 9457) avec ce meme schema : `code` est la valeur stable a tester par un client (le `status` HTTP peut varier legerement selon le contexte, `code` non). `quota` est renseigne pour les erreurs liees au quota (`quota-exhausted`, `anon-quota-exhausted`, `client-quota`).
- `403`: Toute erreur de cette API, quel que soit le code HTTP, est un `application/problem+json` (RFC 9457) avec ce meme schema : `code` est la valeur stable a tester par un client (le `status` HTTP peut varier legerement selon le contexte, `code` non). `quota` est renseigne pour les erreurs liees au quota (`quota-exhausted`, `anon-quota-exhausted`, `client-quota`).
- `404`: Toute erreur de cette API, quel que soit le code HTTP, est un `application/problem+json` (RFC 9457) avec ce meme schema : `code` est la valeur stable a tester par un client (le `status` HTTP peut varier legerement selon le contexte, `code` non). `quota` est renseigne pour les erreurs liees au quota (`quota-exhausted`, `anon-quota-exhausted`, `client-quota`).

---

[API](https://skmtc.dev/jam-jam/apis/jam-jam-convert-api.md) · [All operations](https://skmtc.dev/jam-jam/apis/jam-jam-convert-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jam-jam/apis/jam-jam-convert-api/revisions/64cd41a46e4e?raw)