# General Translation Platform: Mettre à jour un prompt personnalisé
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/context-management/update-custom-prompt.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Met à jour un prompt à partir de son ID. Un champ absent conserve sa valeur enregistrée. null efface un champ nullable ou supprime une entrée de map ; les autres champs refusent null. Dans les lots et les importations, les éléments sont associés aux éléments enregistrés par clé naturelle, les éléments enregistrés absents du lot restent inchangés et rien d'autre n'est supprimé. Une cellule CSV vide est considérée comme absente. Renvoie 409 si un autre prompt possède déjà le nom et le paramètre régional résultants. Nécessite org:context:write. Référence de l'API pour Mettre à jour un prompt personnalisé.

{/* Ce fichier a été généré par Fumadocs. Ne le modifiez pas directement. Pour toute modification, exécutez à nouveau la commande de génération. */}

## Endpoint

`PATCH https://api.gtx.dev/v2/context-groups/{groupId}/custom-prompts/{customPromptId}`

**Operation ID:** `updateContextCustomPrompt`

**Tags:** `Context Management`

**Summary:** Update a custom prompt

Updates a prompt by ID. An absent field keeps its stored value. `null` clears a nullable field or removes a map entry; other fields reject `null`. In batches and imports, items match stored items by natural key, stored items absent from the batch are untouched, and nothing else is deleted. A blank CSV cell counts as absent. Returns 409 if another prompt already has the resulting name and locale. Requires `org:context:write`.

Authentication: required. Send an API key in the `Authorization: Bearer <key>` header when authenticating.

### Parameters

- `groupId` (path, string, required): Context group ID.
- `customPromptId` (path, string, required): Custom prompt ID.
- `gt-api-version` (header, "2025-01-01.v0" | "2025-11-03.v1" | "2026-02-18.v1" | "2026-03-06.v1", optional): API contract version. Defaults to the oldest supported version.

### Request body (required)

Body (`application/json`, object):
- `name` (string)
- `locale` (string | null): Locale the prompt applies to; null applies it to every locale.
- `value` (string)
- `description` (string | null): null clears the description.

### Responses

**200**: Custom prompt updated
Response body (`application/json`, object):
- `committed` (true, required)

**400**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**401**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**403**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**404**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**409**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**413**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**429**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

**500**: Request error
Response body (`application/json`, object):
- `error` (string, required)

Response body (`text/html`, string):

Complete OpenAPI 3.1 specification: https://generaltranslation.com/openapi.yaml

OpenAPI schema: [openapi.json](https://generaltranslation.com/openapi.json)

## Sitemap

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