# gt: General Translation CLI tool: gt project status
URL: https://generaltranslation.com/fr/docs/cli/reference/commands/project-status.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Vérifiez l'état actuel d'un job de traduction ou de génération de contexte de projet. Référence API de la commande gt project status.

Utilisez `gt project status` pour inspecter un job renvoyé par un workflow de traduction ou par [`setupProject`](/docs/platform/core/reference/gt-class-methods/translation/setup-project). La création d&#39;un projet s&#39;effectue de manière synchrone et ne renvoie pas de job ID.

## Aperçu [#overview]

```bash
npx gt project status <job-id> [options]
```

La commande effectue une seule requête d&#39;état et affiche l&#39;état renvoyé par l&#39;API.

## Fonctionnement [#how-it-works]

1. Résout le project ID ainsi que la [connexion enregistrée ou la clé d&#39;outillage explicite](/docs/cli/guides/configuring#credentials).
2. Interroge l&#39;état actuel de la tâche de traduction ou de génération de contexte fournie.
3. Affiche l&#39;état renvoyé, ou `unknown` si la réponse ne contient aucun état.

La commande se termine avec le code 1 si les credentials sont manquants ou si l&#39;API rejette la requête. Si l&#39;API ne renvoie aucune tâche correspondante, la commande affiche `unknown` et se termine avec succès ; de même, l&#39;affichage d&#39;un état de tâche `failed` ne fait pas échouer la commande.

## Arguments et flags [#arguments-flags]

| Parameter             | Description                                                       | Type     | Facultatif | Default                                       |
| --------------------- | ----------------------------------------------------------------- | -------- | ---------- | --------------------------------------------- |
| `<job-id>`            | ID de la tâche de traduction ou de génération de contexte à inspecter. | `string` | Non        | —                                             |
| `-c, --config <path>` | Chemin vers `gt.config.json`.                                     | `string` | Oui        | Résolu automatiquement                        |
| `--api-key <key>`     | Remplace explicitement la clé d&#39;outillage.                    | `string` | Oui        | `GT_API_KEY`, sinon identifiants de connexion |
| `--project-id <id>`   | Remplace le project ID.                                           | `string` | Oui        | Config ou `GT_PROJECT_ID`                     |

## Exemple [#example]

```bash
npx gt project status job_123
```

## Autres remarques [#notes]

* `gt project status` est disponible à partir de `gt` 2.20.0.
* La commande nécessite un project ID ainsi qu&#39;une authentification disposant des autorisations nécessaires pour consulter ses tâches.
* **Structure des réponses :** [Récupérer l&#39;état d&#39;une tâche de translation](/docs/platform/openapi/reference/translation/job-status).

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.
