---
updatedAt: 2026-05-21T16:40:27.000Z
---
# Créer une nouvelle version d'un objectif existant
Utilisez cette API pour créer une nouvelle version d'un objectif existant, à l'état de projet.
Note : Cette API ne peut pas être invoquée s'il existe déjà une version provisoire de l'objectif.
Entités requises: - managePurpose (Gérer les objectifs de protection de la vie privée et le CLUF)
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"version": "1.0.0",
"description": "Data privacy & consent",
"title": "Data privacy & consent"
},
"servers": [
{
"url": "https://{tenanturl}",
"variables": {
"tenanturl": {
"default": "{tenant_url}",
"description": "URL of your IBM Security Verify tenant"
}
}
}
],
"tags": [
{
"name": "Data Privacy and Consent Management"
}
],
"paths": {
"/config/v1.0/privacy/purposes/{id}": {
"put": {
"tags": [
"Data Privacy and Consent Management"
],
"summary": "Créer une nouvelle version d'un objectif existant",
"description": "Utilisez cette API pour créer une nouvelle version d'un objectif existant, à l'état de projet.
Note : Cette API ne peut pas être invoquée s'il existe déjà une version provisoire de l'objectif.
Entités requises: - managePurpose (Gérer les objectifs de protection de la vie privée et le CLUF)
",
"operationId": "putPurposeId",
"parameters": [
{
"name": "id",
"in": "path",
"description": "ID objectif",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "restoreFromVersion",
"in": "query",
"schema": {
"maximum": 2147483647,
"type": "integer"
}
}
],
"requestBody": {
"description": "Informations sur l'objet",
"content": {
"*/*": {
"schema": {
"title": "But",
"required": [
"accessTypes",
"name"
],
"type": "object",
"properties": {
"name": {
"maxLength": 100,
"type": "string",
"description": "Nom de l'objet."
},
"tags": {
"type": "array",
"description": "Étiquettes indiquant l'objet de la collecte",
"items": {
"maxLength": 64,
"type": "string"
}
},
"defaultConsentDuration": {
"maximum": 3650,
"minimum": 1,
"type": "integer",
"description": "La validité par défaut (en jours) des consentements d'utilisateurs créés à cette fin."
},
"description": {
"maxLength": 512,
"type": "string",
"description": "Description de l'objectif."
},
"previousConsentApply": {
"type": "boolean",
"description": "Indicateur booléen qui indique si les attributs peuvent continuer à être accédés avec l'accord de la version précédente.",
"default": true
},
"accessTypes": {
"type": "array",
"description": "Types d'accès associés à cet objectif.",
"items": {
"title": "AccessType",
"type": "object",
"properties": {
"id": {
"maxLength": 64,
"type": "string"
}
}
}
},
"category": {
"maxLength": 256,
"type": "string",
"description": "La catégorie d'objet : \"eula\" ou \"default\".",
"default": "default"
},
"customAttributes": {
"type": "array",
"description": "Une liste d'attributs personnalisés à cet effet.",
"items": {
"title": "Attribut personnalisé",
"type": "object",
"properties": {
"name": {
"maxLength": 64,
"type": "string",
"description": "Nom de l'attribut personnalisé."
},
"value": {
"maxLength": 2048,
"type": "string",
"description": "Valeur de l'attribut personnalisé."
}
}
}
},
"termsOfUse": {
"type": "object",
"properties": {
"ref": {
"maxLength": 2000,
"type": "string",
"description": "La référence URI du document sur les conditions d'utilisation."
},
"external": {
"type": "boolean",
"description": "Drapeau indiquant si termsOfUse est hébergé en externe."
}
},
"description": "La documentation sur les conditions d'utilisation associée à cet objectif."
},
"attributes": {
"type": "array",
"items": {
"title": "Attribut",
"type": "object",
"properties": {
"id": {
"maxLength": 1024,
"type": "string",
"description": "ID de l'attribut, ce champ est obligatoire."
},
"accessTypes": {
"type": "array",
"description": "Une référence au type d'accès, ce champ est obligatoire.",
"items": {
"title": "AccessType",
"type": "object",
"properties": {
"id": {
"maxLength": 64,
"type": "string"
}
}
}
},
"mandatory": {
"type": "boolean",
"description": "Indique si un attribut est obligatoire dans un but spécifique.",
"default": true
},
"retentionPeriod": {
"maximum": 3650,
"minimum": 1,
"type": "integer",
"description": "Une limite (en jours) à la validité du consentement de l'utilisateur à cette fin. Est utilisé pour définir la date de fin par défaut du consentement d'un utilisateur (si elle n'est pas fournie). Nulle, positive"
}
}
}
}
}
}
}
},
"required": true
},
"responses": {
"204": {
"description": "L'opération ou les opérations se sont déroulées avec succès (Pas de contenu).",
"content": {}
},
"400": {
"description": "La demande contient des valeurs non valides. OR Integer Value is out of Range OR Missing Parameter (Paramètre manquant) ",
"content": {
"*/*": {
"schema": {
"$ref": "#/components/schemas/Error400"
}
}
}
},
"403": {
"description": "Privilèges insuffisants pour exécuter la demande.",
"content": {
"*/*": {
"schema": {
"$ref": "#/components/schemas/Error403"
}
}
}
},
"500": {
"description": "Une erreur interne du serveur s'est produite.",
"content": {
"*/*": {
"schema": {
"$ref": "#/components/schemas/Error500"
}
}
}
}
},
"x-publicAPI": "true",
"x-category": "Data privacy & consent",
"x-codegen-request-body-name": "body"
}
}
},
"components": {
"schemas": {
"Error400": {
"required": [
"messageDescription",
"messageId"
],
"type": "object",
"properties": {
"messageId": {
"type": "string",
"description": "L'identifiant de la clé de message",
"example": "CSIBTXXXXE"
},
"messageDescription": {
"type": "string",
"description": "Un message descriptif spécifique à la locale du demandeur",
"example": "String message"
}
}
},
"Error403": {
"required": [
"messageDescription",
"messageId"
],
"type": "object",
"properties": {
"messageId": {
"type": "string",
"description": "L'identifiant de la clé de message",
"example": "CSIBTXXXXE"
},
"messageDescription": {
"type": "string",
"description": "Un message descriptif spécifique à la locale du demandeur",
"example": "String message"
}
}
},
"Error500": {
"required": [
"messageDescription",
"messageId"
],
"type": "object",
"properties": {
"messageId": {
"type": "string",
"description": "L'identifiant de la clé de message",
"example": "CSIBTXXXXE"
},
"messageDescription": {
"type": "string",
"description": "Un message descriptif spécifique à la locale du demandeur",
"example": "String message"
}
}
}
}
},
"x-original-swagger-version": "2.0",
"x-explorer-enabled": false
}
```