Aller au contenu

Clôturer le rattachement

POST
/relation-tiers/v1/contact-assignments/{assignmentId}:close
curl --request POST \
--url https://example.com/relation-tiers/v1/contact-assignments/example:close \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: example' \
--header 'If-Match: example' \
--data '{ "reasonCode": "example", "effectiveAt": "2026-04-15T12:00:00Z", "comment": "example" }'
assignmentId
required
string
X-Tenant-Id
string

Facultatif — le tenant fait foi dans le jeton ; s’il est fourni, il doit être identique, et le corps ne peut jamais le choisir.

X-Correlation-Id
string
Idempotency-Key
required
string

La clé d’idempotence de la commande — liée à l’intention métier, pas à la tentative réseau ; même clé et même contenu rejouent le résultat initial, même clé et contenu différent font 409 IDEMPOTENCY_CONFLICT.

If-Match
required
string

La version d’agrégat attendue — 409 CONCURRENT_MODIFICATION sinon.

Media typeapplication/json
object
reasonCode
required
string
effectiveAt
string format: date-time
comment
string
Examplegenerated
{
"reasonCode": "example",
"effectiveAt": "2026-04-15T12:00:00Z",
"comment": "example"
}

Le rattachement est clôturé.

Media typeapplication/json
object
id
required
string
aggregateVersion
required
integer
status
required
string
Examplegenerated
{
"id": "example",
"aggregateVersion": 1,
"status": "example"
}

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

L’identité présentée n’a pas la famille d’accès requise (403). Les 403 croisés entre familles sont prouvés par les tests d’assemblage. Un écart de tenant ne produit jamais ce code sur une ressource — il produit 404 (ne rien révéler).

Ressource absente ou invisible — y compris une ressource d’un autre tenant : le régime de la muraille ne révèle pas l’existence (404, jamais 403).

Media typeapplication/json

L’enveloppe d’erreur du catalogue (Problem Details) — le texte n’expose ni l’existence d’un objet d’un autre tenant, ni une donnée sensible.

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
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"code": "example",
"detail": "example",
"instance": "example",
"correlationId": "example",
"retryable": true,
"violations": [
{
"field": "example",
"reason": "example",
"ruleId": "example"
}
]
}

Version obsolète (CONCURRENT_MODIFICATION), chevauchement interdit (PERIOD_OVERLAP) ou clé d’idempotence réutilisée avec un contenu différent (IDEMPOTENCY_CONFLICT).

Media typeapplication/json

L’enveloppe d’erreur du catalogue (Problem Details) — le texte n’expose ni l’existence d’un objet d’un autre tenant, ni une donnée sensible.

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
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"code": "example",
"detail": "example",
"instance": "example",
"correlationId": "example",
"retryable": true,
"violations": [
{
"field": "example",
"reason": "example",
"ruleId": "example"
}
]
}

Donnée comprise mais non admissible — règle identifiée (BUSINESS_RULE_VIOLATION), référence externe non résolue (REFERENCE_UNRESOLVED) ou preuve insuffisante (CAPACITY_INDETERMINATE).

Media typeapplication/json

L’enveloppe d’erreur du catalogue (Problem Details) — le texte n’expose ni l’existence d’un objet d’un autre tenant, ni une donnée sensible.

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
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"code": "example",
"detail": "example",
"instance": "example",
"correlationId": "example",
"retryable": true,
"violations": [
{
"field": "example",
"reason": "example",
"ruleId": "example"
}
]
}