Skip to main content
PUT
/
v1
/
governance
/
actor-mappings
/
{actorId}
Upsert an actor mapping
curl --request PUT \
  --url https://matcher.sandbox.lerian.net/v1/governance/actor-mappings/{actorId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "display_name": "John Doe",
  "email": "john.doe@company.com"
}
'
{
  "actor_id": "user-abc-123",
  "display_name": "John Doe",
  "email": "john.doe@company.com",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication (format: "Bearer {token}")

Headers

​
X-Request-Id
string

A unique identifier for tracing the request across services.

Path Parameters

​
actorId
string
required

The actor identifier to map.

Body

application/json

Actor mapping payload

Request payload for creating or updating an actor mapping

​
display_name
string

Human-readable display name for the actor

Example:

"John Doe"

​
email
string<email>

Email address associated with the actor

Example:

"john.doe@company.com"

Response

Actor mapping created or updated

An actor mapping associating a system identifier with display information

​
actor_id
string

The actor identifier

Example:

"user-abc-123"

​
display_name
string

Human-readable display name

Example:

"John Doe"

​
email
string

Email address

Example:

"john.doe@company.com"

​
created_at
string<date-time>

Timestamp when the mapping was created

​
updated_at
string<date-time>

Timestamp when the mapping was last updated