---
title: "File de traitement audio du compte appelant"
method: GET
path: "/queue"
tags: ["pipeline"]
---

# File de traitement audio du compte appelant

`GET /queue`

## Request

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

Trois listes : `active` (en cours), `queued` (en attente, avec
`rank` = ordre de service reel), `done` (terminés/echoues/annules
des 7 derniers jours). Portee `queue:read`, compte requis.

## Response `200`

Les trois listes

- object
  - `active` AudioPipelineJob[]
    - `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
  - `queued` AudioPipelineJob[]
    - `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
  - `done` AudioPipelineJob[]
    - `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`).

---

[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)