Saltar al contenido principal
PUT
Crear o actualizar un mapeo de actor

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer (formato: "Bearer {token}")

Encabezados

X-Request-Id
string

A unique identifier for tracing the request across services.

X-Idempotency-Key
string

Clave de idempotencia opcional para reintentos seguros. También acepta Idempotency-Key como nombre de encabezado alternativo. Si se envía la misma clave nuevamente y la solicitud original ya fue procesada, se devuelve la respuesta en caché con X-Idempotency-Replayed: true.

Consulte Reintentos e idempotencia para más detalles.

Parámetros de ruta

actorId
string
requerido

The actor identifier to map.

Cuerpo

application/json

Payload del mapeo de actor

Carga útil de la solicitud para crear o actualizar un mapeo de actor

displayName
string

Nombre de visualización legible para el actor

Ejemplo:

"John Doe"

email
string<email>

Dirección de correo electrónico asociada al actor

Ejemplo:

"john.doe@company.com"

Respuesta

Mapeo de actor creado o actualizado.

La respuesta incluye el encabezado X-Idempotency-Replayed.

Si el valor es false, la solicitud acaba de procesarse. Si el valor es true, la respuesta es una repetición de una solicitud procesada anteriormente.

Consulte Reintentos e idempotencia para más detalles.

Un mapeo de actor que asocia un identificador de sistema con información de visualización

actorId
string

El identificador del actor

Ejemplo:

"user-abc-123"

displayName
string

Nombre de visualización legible

Ejemplo:

"John Doe"

email
string

Dirección de correo electrónico

Ejemplo:

"john.doe@company.com"

createdAt
string<date-time>

Marca de tiempo de cuando se creó el mapeo

updatedAt
string<date-time>

Marca de tiempo de la última actualización del mapeo