Créer une politique

POST

/relation-tiers/v1/retention-policies

curl --request POST \
  --url https://example.com/relation-tiers/v1/retention-policies \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example' \
  --data '{ "categoryCode": "example", "legalBasis": "example", "retentionDuration": "example", "litigationHold": true, "pseudonymizationRule": "example", "validFrom": "2026-04-15T12:00:00Z" }'

Autorisations

• authentification
  relation-tiers:administration

Paramètres

Paramètres (header)

X-Tenant-Id

string

Facultatif — le tenant fait foi dans le jeton ; s’il est fourni, il doit être identique.

X-Correlation-Id

string

Idempotency-Key

required

string

Corps de la requête^required

Media typeapplication/json

object

categoryCode

required

string

legalBasis

required

string

retentionDuration

required

string

litigationHold

boolean

pseudonymizationRule

string

validFrom

string format: date-time

Example^generated

{
  "categoryCode": "example",
  "legalBasis": "example",
  "retentionDuration": "example",
  "litigationHold": true,
  "pseudonymizationRule": "example",
  "validFrom": "2026-04-15T12:00:00Z"
}

Réponses

201

La politique est créée.

Media typeapplication/json

object

id

required

string

aggregateVersion

integer

status

required

string

Example^generated

{
  "id": "example",
  "aggregateVersion": 1,
  "status": "example"
}

401

Aucune identité présentée (401).

403

L’identité présentée n’a pas la famille d’accès relation-tiers:administration (403).

409

Version obsolète, chevauchement ou clé d’idempotence réutilisée.

Media typeapplication/json

object

type

required

string

title

required

string

status

required

integer

code

required

string

detail

string

instance

string

correlationId

required

string

retryable

boolean

violations

Array<object>

object

field

string

reason

string

ruleId

string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "instance": "example",
  "correlationId": "example",
  "retryable": true,
  "violations": [
    {
      "field": "example",
      "reason": "example",
      "ruleId": "example"
    }
  ]
}

422

Donnée comprise mais non admissible — règle identifiée.

Media typeapplication/json

object

type

required

string

title

required

string

status

required

integer

code

required

string

detail

string

instance

string

correlationId

required

string

retryable

boolean

violations

Array<object>

object

field

string

reason

string

ruleId

string

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "code": "example",
  "detail": "example",
  "instance": "example",
  "correlationId": "example",
  "retryable": true,
  "violations": [
    {
      "field": "example",
      "reason": "example",
      "ruleId": "example"
    }
  ]
}