Pular para o conteúdo principal
PUT
Criar ou atualizar um mapeamento de ator

Autorizações

Authorization
string
header
obrigatório

Autenticação por Bearer token (formato: "Bearer {token}")

Cabeçalhos

X-Request-Id
string

A unique identifier for tracing the request across services.

X-Idempotency-Key
string

Chave de idempotência opcional para novas tentativas seguras. Também aceita Idempotency-Key como nome alternativo do cabeçalho. Se a mesma chave for enviada novamente e a requisição original já tiver sido processada, a resposta em cache é retornada com X-Idempotency-Replayed: true.

Consulte Novas tentativas e idempotência para mais detalhes.

Parâmetros de caminho

actorId
string
obrigatório

The actor identifier to map.

Corpo

application/json

Payload de mapeamento de ator

Payload da requisição para criar ou atualizar um mapeamento de ator

displayName
string

Nome de exibição legível para o ator

Exemplo:

"John Doe"

email
string<email>

Endereço de e-mail associado ao ator

Exemplo:

"john.doe@company.com"

Resposta

Mapeamento de ator criado ou atualizado.

A resposta inclui o cabeçalho X-Idempotency-Replayed.

Se o valor for false, a requisição acabou de ser processada. Se o valor for true, a resposta é uma repetição de uma requisição processada anteriormente.

Consulte Retentativas e idempotência para mais detalhes.

Um mapeamento de ator que associa um identificador de sistema a informações de exibição

actorId
string

O identificador do ator

Exemplo:

"user-abc-123"

displayName
string

Nome de exibição legível

Exemplo:

"John Doe"

email
string

Endereço de e-mail

Exemplo:

"john.doe@company.com"

createdAt
string<date-time>

Timestamp de criação do mapeamento

updatedAt
string<date-time>

Timestamp da última atualização do mapeamento