Déplacer ou renommer une ressource DAM

alpha

Déplace ou renomme une ressource DAM sans modifier son objet stocké.

PATCHhttps://api2.transloadit.com/dam/assets/{assetId}

Avertissement

Ce point de terminaison est en phase alpha. Son URL, ses paramètres, ses réponses et son comportement peuvent changer considérablement et rendre les intégrations existantes inopérantes.

Avant d’appeler ce point de terminaison, obtenez les identifiants des ressources existantes dans le même Workspace que l’Auth Key utilisée pour la requête.

Pour les fichiers stockés avec /transloadit/store, récupérez leur Assembly Status et attendez ASSEMBLY_COMPLETED. Dans les tableaux results[stepName] renvoyés, conservez les valeurs workspace, asset_id, version_id et path renvoyées pour chaque fichier stocké. L’id ordinaire du fichier n’est pas son identifiant de ressource de stockage. Utilisez asset_id pour ASSET_ID ou params.asset_ids dans les exemples ci-dessous.

Utilisez asset_id pour suivre une ressource lors des déplacements et des renommages natifs. Ajoutez version_id lors de l’importation pour sélectionner les mêmes octets conservés après un écrasement. Un chemin enregistré est un emplacement modifiable, pas une référence immuable. Les règles d’accès et de conservation des versions continuent de s’appliquer.

Pour une destination autre que la racine, vous devez déjà connaître l’identifiant du dossier existant dans le même Workspace. Une réponse de déplacement ou de renommage précédemment enregistrée peut fournir cet identifiant : folder_id dans une réponse concernant une seule ressource ou assets[].folder_id dans une réponse de déplacement en masse. Ces réponses décrivent le dossier après cette opération ; elles ne constituent pas une API de découverte des dossiers.

Si vous connaissez les chemins plutôt que les identifiants des dossiers, utilisez Déplacer un fichier ou un dossier de stockage. Le dossier parent de destination doit déjà exister. Pour déplacer une ressource à la racine avec ce point de terminaison fondé sur les identifiants, utilisez destination_folder_id: null.

Incluez au moins l’un des paramètres filename ou destination_folder_id dans params. Un nom de fichier doit être un nom sans chemin de dossier.

Pour renommer une ressource dans son dossier actuel, envoyez uniquement filename dans params, comme dans l’exemple de requête ci-dessous.

Pour déplacer la ressource à la racine à la place, incluez explicitement destination_folder_id: null :

{ "destination_folder_id": null, "filename": "renamed.jpg" }

Pour un autre dossier, remplacez null par l’identifiant de ce dossier. L’omission et null correspondent à des opérations différentes.

Limites des chemins des ressources

Le chemin de destination complet (dossiers et nom de fichier) ne doit pas dépasser 512 points de code Unicode et 1024 octets UTF-8 après normalisation. Un nom de fichier qui respecte ces limites à lui seul peut néanmoins les dépasser dans un dossier imbriqué.

Exemple de requête

Attribuez à ASSET_ID la valeur de votre ressource sans l’encoder en pourcentage.

Exécutez cette requête dans un shell côté serveur avec curl et un jeton porteur approprié dans TRANSLOADIT_TOKEN. Si vous avez besoin d’un jeton, développez la section de configuration ci-dessous.

Besoin d’un jeton porteur ?

Dans un shell de confiance côté serveur disposant de curl et de jq, attribuez à TRANSLOADIT_KEY et à TRANSLOADIT_SECRET les valeurs de votre Auth Key et de votre Auth Secret. Gardez ces deux informations d’identification et le jeton obtenu secrets ; n’exécutez jamais cette configuration dans du code de navigateur.

Créez d’abord un jeton avec les portées requises par ce point de terminaison. Votre Auth Key doit déjà accorder ces portées.

if ! TOKEN_RESPONSE="$(curl --fail-with-body -sS \
  --request POST \
  --url 'https://api2.transloadit.com/token' \
  --user "${TRANSLOADIT_KEY:?Set TRANSLOADIT_KEY}:${TRANSLOADIT_SECRET:?Set TRANSLOADIT_SECRET}" \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'aud=api2' \
  --data-urlencode 'scope=dam:write')"; then
  printf '%s\n' "$TOKEN_RESPONSE" >&2
  exit 1
fi
TRANSLOADIT_TOKEN="$(printf '%s' "$TOKEN_RESPONSE" |
  jq -er '.access_token | strings | select(length > 0)')" || exit 1

Gardez ce shell ouvert et exécutez la requête ci-dessous. Réutilisez le jeton tant qu’il reste valide.

curl --fail-with-body -sS --request PATCH \
  --url "https://api2.transloadit.com/dam/assets/${ASSET_ID:?Set ASSET_ID}" \
  --header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
  --data-urlencode 'params={"filename":"renamed.jpg"}'

Authentification

Ce point de terminaison accepte des params signés ou un jeton porteur. Consultez la section Authentification pour les instructions de configuration.

Portée requise pour l’Auth Key ou le jeton porteur : dam:write.

Les requêtes signées nécessitent à la fois une signature et un horodatage params.auth.expires situé dans le futur. Les jetons porteurs ne nécessitent ni l’un ni l’autre.

Paramètres de chemin

assetId (segment de chemin), obligatoire. motif : ^[A-Za-z0-9_-]{21}[AQgw]$, longueur minimale : 22, longueur maximale : 22

Champs de formulaire

Type de contenu : application/x-www-form-urlencoded

params (Chaîne JSON), obligatoire. Un objet encodé en JSON dont les clés prises en charge sont répertoriées ci-dessous.
signature (chaîne de caractères). Obligatoire pour les requêtes signées. Omettez ce champ lorsque vous utilisez un jeton porteur.

Clés prises en charge dans le champ `params`

Les champs d’authentification de cette liste s’appliquent aux requêtes signées. Avec un jeton porteur, vous pouvez omettre params.auth et le champ distinct signature. Comparez les paramètres de requête spécifiques à l’authentification ci-dessous.

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

params: Seuls les champs répertoriés pour cet objet sont acceptés.

Champ	Type et description
`params.auth` obligatoire pour les requêtes signées ; facultatif avec un jeton porteur	`object` Contient la clé API Transloadit et les métadonnées de Signature Authentication pour une mutation DAM. `params.auth`: Seuls les champs répertoriés pour cet objet sont acceptés.
`params.auth.expires` obligatoire	`string` Horodatage d’expiration au format ISO 8601 situé dans le futur. Obligatoire lorsqu’une requête est signée ou nécessite Signature Authentication ; les requêtes authentifiées par jeton porteur peuvent l’omettre.
`params.auth.key` obligatoire	`string` Clé API Transloadit utilisée pour authentifier les requêtes
`params.destination_folder_id`	`string \| null` ID du dossier de destination. Définissez ce paramètre sur `null` pour déplacer la ressource à la racine. Omettez-le pour conserver son dossier actuel, par exemple lorsque vous ne faites que la renommer avec `filename`. N’importe lequel des schémas suivants peut s’appliquer : string `string` Identifiant DAM canonique de 22 caractères au format Base64URL, sensible à la casse. Motif de validation (expression régulière) `^[A-Za-z0-9_-]{21}[AQgw]$` `null`
`params.filename`	`string` (longueur minimale : 1, longueur maximale : 255) Nouveau nom de fichier sans chemin de dossier. Les noms sont normalisés en Unicode NFC et restent sensibles à la casse. Les noms composés uniquement de caractères d’espacement et les noms `.` ou `..` sont rejetés, de même que les barres obliques, les barres obliques inverses, les caractères de contrôle et les séquences Unicode non valides. Les autres espaces en début ou en fin de nom sont conservés. La combinaison du dossier de destination et du nom de fichier doit également respecter les limites des chemins des ressources.
`params.nonce`	`string \| integer` Valeur unique et aléatoire incluse dans les paramètres de la requête signée pour rendre chaque signature unique et empêcher la réutilisation accidentelle d’une signature.

Paramètres de requête par méthode d’authentification

Avec des paramètres signés

Incluez votre Auth Key dans params.auth.key. Lors de la signature de la requête, incluez un horodatage futur dans params.auth.expires et envoyez la signature dans le champ distinct signature. Les définitions des champs ci-dessous utilisent des chemins à l’intérieur de params.

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

params: Seuls les champs répertoriés pour cet objet sont acceptés.

Utilise les définitions des champs ci-dessus : params.auth, params.destination_folder_id, params.filename, params.nonce

Avec un jeton porteur

Envoyez le jeton porteur dans l’en-tête Authorization. Vous pouvez omettre params.auth et le champ distinct signature. Les autres paramètres obligatoires restent requis. Les définitions des champs ci-dessous utilisent des chemins à l’intérieur de params.

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

params: Seuls les champs répertoriés pour cet objet sont acceptés.

Utilise les définitions des champs ci-dessus : params.destination_folder_id, params.filename, params.nonce

Champ	Type et description
`params.auth`	`object` Contient la clé API Transloadit et les métadonnées de Signature Authentication pour une mutation DAM. `params.auth`: Seuls les champs répertoriés pour cet objet sont acceptés.
`params.auth.expires`	`string` Horodatage d’expiration au format ISO 8601 situé dans le futur. Obligatoire lorsqu’une requête est signée ou nécessite Signature Authentication ; les requêtes authentifiées par jeton porteur peuvent l’omettre.
`params.auth.key`	`string` Clé API Transloadit utilisée pour authentifier les requêtes

Réponse

Voici un exemple de corps de réponse :

{
  "asset": {
    "asset_id": "AAAAAAAAAAAAAAAAAAAAAA",
    "height": 600,
    "mime": "image/jpeg",
    "path": "renamed.jpg",
    "size": 12345,
    "version_id": "AAAAAAAAAAAAAAAAAAAAAQ",
    "width": 800,
    "workspace": "example-workspace"
  },
  "asset_id": "AAAAAAAAAAAAAAAAAAAAAA",
  "deleted_at": null,
  "filename": "renamed.jpg",
  "folder_id": null,
  "message": "The DAM asset was successfully moved.",
  "ok": "DAM_ASSET_MOVED",
  "path": "renamed.jpg",
  "updated_at": "2026-09-12T10:00:00.000Z"
}

Succès 2xx

Corps de la réponse JSON. application/json text/plain; charset=utf-8

Schéma du corps de la réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

La réponse contient uniquement les champs répertoriés pour cet objet.

Champ	Type et description
`asset` obligatoire	`object` `asset`: La réponse peut contenir des champs supplémentaires.
`asset.asset_id` obligatoire	`string` Identifiant stable de la ressource. Il reste inchangé lors des déplacements et renommages natifs ; utilisez-le sans version pour sélectionner les octets actuels. Motif de validation (expression régulière) `^[A-Za-z0-9_-]{21}[AQgw]$`
`asset.has_alpha`	`boolean` Indique si l’image possède un canal alpha, même si tous ses pixels sont opaques. Présent lorsque l’extraction ThumbHash réussit ; son absence signifie que l’information est inconnue.
`asset.height`	`integer` (minimum exclusif : 0, maximum : 9007199254740991) Hauteur d’affichage en pixels, après application de l’orientation EXIF, lorsqu’elle est connue.
`asset.md5hash`	`string` Somme de contrôle MD5 en minuscules des octets stockés, lorsqu’elle est disponible. Motif de validation (expression régulière) `^[a-f0-9]{32}$`
`asset.mime` obligatoire	`null \| string` Type MIME des octets stockés, ou null si ce type est inconnu.
`asset.path` obligatoire	`string` (longueur minimale : 1) Emplacement actuel modifiable, relatif au Workspace. Un renommage rend le chemin précédent obsolète ; un écrasement peut modifier les octets à ce chemin.
`asset.sha256`	`string` Somme de contrôle SHA-256 en minuscules des octets stockés, lorsqu’elle est disponible. Motif de validation (expression régulière) `^[a-f0-9]{64}$`
`asset.size` obligatoire	`integer` (minimum : 0, maximum : 9007199254740991) Taille du fichier stocké en octets.
`asset.thumbhash`	`string` ThumbHash encodé en Base64 des pixels affichés de cette version, lorsqu’il est demandé avec output_meta.thumbhash sur le Step qui l’a produite. Il s’agit de données d’image : appliquez les mêmes contrôles d’accès que pour l’original. Motif de validation (expression régulière) `^(?:[A-Za-z0-9+/]{4}){1,15}(?:[A-Za-z0-9+/]{4}\|[A-Za-z0-9+/]{2}==\|[A-Za-z0-9+/]{3}=)$`
`asset.version_id` obligatoire	`string` Version exacte et immuable de cette ressource. Associez-la à asset_id pour sélectionner les octets conservés ; une version manquante n’entraîne jamais de repli vers la version actuelle. Motif de validation (expression régulière) `^[A-Za-z0-9_-]{21}[AQgw]$`
`asset.width`	`integer` (minimum exclusif : 0, maximum : 9007199254740991) Largeur d’affichage en pixels, après application de l’orientation EXIF, lorsqu’elle est connue.
`asset.workspace` obligatoire	`string` (longueur minimale : 1) Slug du Workspace propriétaire de cette ressource. Authentifiez-vous pour ce même Workspace lorsque vous la consultez ou la gérez.
`asset_id` obligatoire	`string` Identifiant DAM canonique de 22 caractères au format Base64URL, sensible à la casse. Motif de validation (expression régulière) `^[A-Za-z0-9_-]{21}[AQgw]$`
`deleted_at` obligatoire	`string \| null` Motif de validation (expression régulière) `^(([0-9][0-9][2468][048]\|[0-9][0-9][13579][26]\|[0-9][0-9]0[48]\|[02468][048]00\|[13579][26]00)-02-29\|[0-9]{4}-((0[13578]\|1[02])-(0[1-9]\|[12][0-9]\|3[01])\|(0[469]\|11)-(0[1-9]\|[12][0-9]\|30)\|(02)-(0[1-9]\|1[0-9]\|2[0-8])))T([01][0-9]\|2[0-3]):[0-5][0-9](:[0-5][0-9](\.[0-9]+)?)?(Z)$`
`filename` obligatoire	`string` (longueur minimale : 1)
`folder_id` obligatoire	`string \| null` Identifiant DAM canonique de 22 caractères au format Base64URL, sensible à la casse. Motif de validation (expression régulière) `^[A-Za-z0-9_-]{21}[AQgw]$`
`message` obligatoire	`string` (longueur minimale : 1)
`ok` obligatoire	`string` (toujours : "DAM_ASSET_MOVED")
`path` obligatoire	`string` (longueur minimale : 1)
`updated_at` obligatoire	`string` Motif de validation (expression régulière) `^(([0-9][0-9][2468][048]\|[0-9][0-9][13579][26]\|[0-9][0-9]0[48]\|[02468][048]00\|[13579][26]00)-02-29\|[0-9]{4}-((0[13578]\|1[02])-(0[1-9]\|[12][0-9]\|3[01])\|(0[469]\|11)-(0[1-9]\|[12][0-9]\|30)\|(02)-(0[1-9]\|1[0-9]\|2[0-8])))T([01][0-9]\|2[0-3]):[0-5][0-9](:[0-5][0-9](\.[0-9]+)?)?(Z)$`

Réponse d’erreur

Corps de la réponse JSON. application/json text/plain; charset=utf-8

Schéma du corps de la réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Au moins une de ces propriétés est requise : error, message, reason

La réponse peut contenir des champs supplémentaires.

Champ	Type et description
`assembly_id`	`string`
`error`	`string` (longueur minimale : 1)
`http_code`	`number \| string` `number` `string` Motif de validation (expression régulière) ^[\x09-\x0D\x20\xA0\u1680\u2000\u2001\u2002\u2003\u2004\u2005\u2006\u2007\u2008\u2009\u200a\u2028\u2029\u202f\u205f\u3000\ufeff][+-]?0(?:0(?:[^0-9]\|$)\|(?:[1-9][0-9]{0,307}\|1(?:(?:[0-6][0-9]{7}\|7[0-8][0-9]{6}\|79[0-6][0-9]{5}\|797[0-5][0-9]{4}\|7976[0-8][0-9]{3}\|79769[0-2][0-9]{2}\|7976930[0-9]{1}\|7976931[0-2])[0-9]{300}\|79769313(?:(?:[0-3][0-9]{7}\|4[0-7][0-9]{6}\|48[0-5][0-9]{5}\|486[0-1][0-9]{4}\|4862[0-2][0-9]{3}\|486230[0-9]{2}\|486231[0-4][0-9]{1}\|4862315[0-7])[0-9]{292}\|48623158(?:(?:0[0-6][0-9]{6}\|07[0-8][0-9]{5}\|079[0-2][0-9]{4}\|0793[0-6][0-9]{3}\|07937[0-1][0-9]{2}\|079372[0-7][0-9]{1}\|0793728[0-8])[0-9]{284}\|07937289(?:(?:[0-6][0-9]{7}\|70[0-9]{6}\|71[0-3][0-9]{5}\|7140[0-4][0-9]{3}\|71405[0-2][0-9]{2}\|7140530[0-2])[0-9]{276}\|71405303(?:(?:[0-3][0-9]{7}\|40[0-9]{6}\|41[0-4][0-9]{5}\|4150[0-6][0-9]{3}\|41507[0-8][0-9]{2}\|415079[0-8][0-9]{1}\|4150799[0-2])[0-9]{268}\|41507993(?:(?:[0-3][0-9]{7}\|40[0-9]{6}\|41[0-2][0-9]{5}\|413[0-1][0-9]{4}\|4132[0-6][0-9]{3}\|413270[0-9]{2})[0-9]{260}\|41327100(?:(?:[0-2][0-9]{7}\|3[0-6][0-9]{6}\|37[0-7][0-9]{5}\|378[0-1][0-9]{4}\|3782[0-5][0-9]{3}\|37826[0-8][0-9]{2}\|378269[0-2][0-9]{1}\|3782693[0-5])[0-9]{252}\|37826936(?:(?:0[0-9]{7}\|1[0-6][0-9]{6}\|17[0-2][0-9]{5}\|173[0-6][0-9]{4}\|1737[0-6][0-9]{3}\|17377[0-7][0-9]{2}\|173778[0-8][0-9]{1}\|1737789[0-7])[0-9]{244}\|17377898(?:(?:0[0-3][0-9]{6}\|04[0-3][0-9]{5}\|044[0-3][0-9]{4}\|0444[0-8][0-9]{3}\|04449[0-5][0-9]{2}\|044496[0-7][0-9]{1}\|0444968[0-1])[0-9]{236}\|04449682(?:(?:[0-8][0-9]{7}\|9[0-1][0-9]{6}\|92[0-6][0-9]{5}\|927[0-5][0-9]{4}\|9276[0-3][0-9]{3}\|92764[0-6][0-9]{2}\|927647[0-4][0-9]{1})[0-9]{228}\|92764750(?:(?:[0-8][0-9]{7}\|9[0-3][0-9]{6}\|94[0-5][0-9]{5}\|946[0-5][0-9]{4}\|9466[0-3][0-9]{3}\|94664[0-8][0-9]{2}\|94664900)[0-9]{220}\|94664901(?:(?:[0-6][0-9]{7}\|7[0-8][0-9]{6}\|79[0-6][0-9]{5}\|797[0-6][0-9]{4}\|7977[0-4][0-9]{3}\|79775[0-7][0-9]{2}\|797758[0-6][0-9]{1}\|7977587[0-1])[0-9]{212}\|79775872(?:(?:0[0-6][0-9]{6}\|070[0-8][0-9]{4}\|0709[0-5][0-9]{3}\|07096[0-2][0-9]{2}\|070963[0-2][0-9]{1})[0-9]{204}\|07096330(?:(?:[0-1][0-9]{7}\|2[0-7][0-9]{6}\|28[0-5][0-9]{5}\|286[0-3][0-9]{4}\|28640[0-9]{3}\|28641[0-5][0-9]{2}\|286416[0-5][0-9]{1}\|2864166[0-8])[0-9]{196}\|28641669(?:(?:[0-1][0-9]{7}\|2[0-7][0-9]{6}\|28[0-7][0-9]{5}\|288[0-6][0-9]{4}\|2887[0-8][0-9]{3}\|288790[0-9]{2}\|2887910[0-8])[0-9]{188}\|28879109(?:(?:[0-3][0-9]{7}\|4[0-5][0-9]{6}\|46[0-4][0-9]{5}\|465[0-4][0-9]{4}\|4655[0-4][0-9]{3}\|46555[0-4][0-9]{2}\|465555[0-3][0-9]{1}\|4655554[0-6])[0-9]{180}\|46555547(?:(?:[0-7][0-9]{7}\|8[0-4][0-9]{6}\|850[0-9]{5}\|851[0-8][0-9]{4}\|8519[0-3][0-9]{3}\|851940[0-3][0-9]{1})[0-9]{172}\|85194040(?:(?:[0-1][0-9]{7}\|2[0-5][0-9]{6}\|26[0-2][0-9]{5}\|2630[0-5][0-9]{3}\|26306[0-4][0-9]{2}\|263065[0-6][0-9]{1}\|2630657[0-3])[0-9]{164}\|26306574(?:(?:[0-7][0-9]{7}\|8[0-7][0-9]{6}\|88[0-5][0-9]{5}\|886[0-6][0-9]{4}\|88670[0-9]{3}\|88671[0-4][0-9]{2}\|8867150[0-4])[0-9]{156}\|88671505(?:(?:[0-7][0-9]{7}\|8[0-1][0-9]{6}\|820[0-5][0-9]{4}\|8206[0-7][0-9]{3}\|820680[0-9]{2}\|820681[0-8][0-9]{1})[0-9]{148}\|82068190(?:(?:[0-7][0-9]{7}\|8[0-8][0-9]{6}\|890[0-1][0-9]{4}\|8902000[0-6])[0-9]{140}\|89020007(?:(?:0[0-7][0-9]{6}\|08[0-2][0-9]{5}\|083[0-7][0-9]{4}\|0838[0-2][0-9]{3}\|08383[0-5][0-9]{2}\|083836[0-6][0-9]{1}\|0838367[0-5])[0-9]{132}\|08383676(?:(?:[0-1][0-9]{7}\|2[0-6][0-9]{6}\|27[0-2][0-9]{5}\|273[0-7][0-9]{4}\|2738[0-4][0-9]{3}\|27385[0-3][0-9]{2}\|273854[0-7][0-9]{1}\|2738548[0-3])[0-9]{124}\|27385484(?:(?:[0-4][0-9]{7}\|5[0-7][0-9]{6}\|580[0-9]{5}\|581[0-6][0-9]{4}\|5817[0-6][0-9]{3}\|581770[0-9]{2}\|5817710[0-9]{1}\|5817711[0-4])[0-9]{116}\|58177115(?:(?:[0-2][0-9]{7}\|30[0-9]{6}\|31[0-6][0-9]{5}\|317[0-5][0-9]{4}\|3176[0-3][0-9]{3}\|31764[0-3][0-9]{2}\|317644[0-6][0-9]{1}\|3176447[0-4])[0-9]{108}\|31764475(?:(?:[0-6][0-9]{7}\|7[0-2][0-9]{6}\|730[0-1][0-9]{4}\|7302[0-6][0-9]{3}\|7302700[0-5])[0-9]{100}\|73027006(?:(?:[0-8][0-9]{7}\|9[0-7][0-9]{6}\|98[0-4][0-9]{5}\|985[0-4][0-9]{4}\|9855[0-4][0-9]{3}\|98555[0-6][0-9]{2}\|9855570[0-9]{1}\|9855571[0-2])[0-9]{92}\|98555713(?:(?:[0-5][0-9]{7}\|6[0-5][0-9]{6}\|66[0-8][0-9]{5}\|669[0-4][0-9]{4}\|6695[0-8][0-9]{3}\|66959[0-5][0-9]{2}\|669596[0-1][0-9]{1}\|6695962[0-1])[0-9]{84}\|66959622(?:(?:[0-7][0-9]{7}\|8[0-3][0-9]{6}\|84[0-1][0-9]{5}\|842[0-8][0-9]{4}\|84290[0-9]{3}\|84291[0-3][0-9]{2}\|842914[0-7][0-9]{1}\|84291480)[0-9]{76}\|84291481(?:(?:[0-8][0-9]{7}\|9[0-7][0-9]{6}\|98[0-5][0-9]{5}\|9860[0-7][0-9]{3}\|98608[0-2][0-9]{2}\|986083[0-3][0-9]{1}\|9860834[0-8])[0-9]{68}\|98608349(?:(?:[0-2][0-9]{7}\|3[0-5][0-9]{6}\|36[0-3][0-9]{5}\|364[0-6][0-9]{4}\|3647[0-4][0-9]{3}\|36475[0-1][0-9]{2}\|364752[0-8][0-9]{1}\|3647529[0-1])[0-9]{60}\|36475292(?:(?:[0-6][0-9]{7}\|70[0-9]{6}\|71[0-8][0-9]{5}\|7190[0-6][0-9]{3}\|71907[0-3][0-9]{2}\|7190740[0-9]{1}\|7190741[0-5])[0-9]{52}\|71907416(?:(?:[0-7][0-9]{7}\|8[0-3][0-9]{6}\|84[0-3][0-9]{5}\|844[0-3][0-9]{4}\|8444[0-2][0-9]{3}\|84443[0-5][0-9]{2}\|844436[0-4][0-9]{1}\|8444365[0-4])[0-9]{44}\|84443655(?:(?:0[0-9]{7}\|10[0-6][0-9]{5}\|1070[0-3][0-9]{3}\|10704[0-2][0-9]{2}\|107043[0-3][0-9]{1}\|1070434[0-1])[0-9]{36}\|10704342(?:(?:[0-6][0-9]{7}\|70[0-9]{6}\|710[0-9]{5}\|711[0-4][0-9]{4}\|7115[0-4][0-9]{3}\|71155[0-8][0-9]{2}\|711559[0-5][0-9]{1}\|7115596[0-8])[0-9]{28}\|71155969(?:(?:[0-8][0-9]{7}\|9[0-4][0-9]{6}\|950[0-7][0-9]{4}\|95080[0-8][0-9]{2}\|950809[0-2][0-9]{1})[0-9]{20}\|95080930(?:(?:[0-3][0-9]{7}\|4[0-1][0-9]{6}\|42[0-7][0-9]{5}\|428[0-7][0-9]{4}\|428800[0-9]{2}\|428801[0-6][0-9]{1}\|4288017[0-6])[0-9]{12}\|42880177(?:(?:[0-8][0-9]{7}\|90[0-3][0-9]{5}\|9040[0-9]{4}\|9041[0-6][0-9]{3}\|90417[0-3][0-9]{2}\|904174[0-3][0-9]{1}\|9041744[0-8])[0-9]{4}\|90417449(?:(?:[0-6][0-9]{3}\|7[0-6][0-9]{2}\|77[0-8][0-9]{1}\|7790)\|7791))))))))))))))))))))))))))))))))))))))))(?:[^0-9]\|$))
`message`	`string` Explication de l’erreur destinée à être lue par un humain. Sa formulation peut varier ; utilisez le code `error` pour gérer un échec spécifique.
`reason`	`null \| string \| number \| boolean \| Array<n’importe quelle valeur> \| object` N’importe lequel des schémas suivants peut s’appliquer : `null` `string` `number` `boolean` Array<n’importe quelle valeur> `Array<n’importe quelle valeur>` Schéma d’un élément de tableau `n’importe quelle valeur` object `object` Schéma de la propriété supplémentaire `n’importe quelle valeur`

HTTP 400

Corps de la réponse JSON. application/json text/plain; charset=utf-8

Schéma du corps de la réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Erreurs nommées et format général des erreurs

error: "DAM_INVALID_REQUEST"

Les paramètres de la requête de stockage ne sont pas valides.

La réponse peut contenir des champs supplémentaires.

Champ	Type et description
`error` obligatoire	`string` (toujours : "DAM_INVALID_REQUEST")
`http_code`	`number` (toujours : 400)
`message`	`string` Explication de l’erreur destinée à être lue par un humain. Sa formulation peut varier ; utilisez le code `error` pour gérer un échec spécifique.

Format général des erreurs

Consultez les champs généraux des réponses d’erreur.

HTTP 404

Corps de la réponse JSON. application/json text/plain; charset=utf-8

Schéma du corps de la réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Erreurs nommées et format général des erreurs

error: "DAM_RESOURCE_NOT_FOUND"

La ressource DAM demandée n’a pas été trouvée.

La réponse peut contenir des champs supplémentaires.

Champ	Type et description
`error` obligatoire	`string` (toujours : "DAM_RESOURCE_NOT_FOUND")
`http_code`	`number` (toujours : 404)
`message`	`string` Explication de l’erreur destinée à être lue par un humain. Sa formulation peut varier ; utilisez le code `error` pour gérer un échec spécifique.

Format général des erreurs

Consultez les champs généraux des réponses d’erreur.

HTTP 409

Corps de la réponse JSON. application/json text/plain; charset=utf-8

Schéma du corps de la réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Erreurs nommées et format général des erreurs

error: "DAM_MUTATION_CONFLICT"

La mutation DAM entre en conflit avec une ressource existante.

La réponse peut contenir des champs supplémentaires.

Champ	Type et description
`error` obligatoire	`string` (toujours : "DAM_MUTATION_CONFLICT")
`http_code`	`number` (toujours : 409)
`message`	`string` Explication de l’erreur destinée à être lue par un humain. Sa formulation peut varier ; utilisez le code `error` pour gérer un échec spécifique.

Format général des erreurs

Consultez les champs généraux des réponses d’erreur.

HTTP 500

Corps de la réponse JSON. application/json text/plain; charset=utf-8

Schéma du corps de la réponse

Schéma JSON complet

Ouvrir le JSON dans un nouvel onglet

Erreurs nommées et format général des erreurs

error: "DAM_MUTATION_FAILED"

La modification du DAM n’a pas pu être effectuée. Veuillez réessayer.

La réponse peut contenir des champs supplémentaires.

Champ	Type et description
`error` obligatoire	`string` (toujours : "DAM_MUTATION_FAILED")
`http_code`	`number` (toujours : 500)
`message`	`string` Explication de l’erreur destinée à être lue par un humain. Sa formulation peut varier ; utilisez le code `error` pour gérer un échec spécifique.

Format général des erreurs

Consultez les champs généraux des réponses d’erreur.

Déplacer ou renommer une ressource DAM

Limites des chemins des ressources

Exemple de requête

Authentification

Paramètres de chemin

Champs de formulaire

Clés prises en charge dans le champ params

Paramètres de requête par méthode d’authentification

Réponse

Succès 2xx

Réponse d’erreur

HTTP 400

HTTP 404

HTTP 409

HTTP 500

Clés prises en charge dans le champ `params`