Update an account link (v2)

put

https://account-links.cortextech.io/v2/admin/clients/{clientId}/account-links

Updates an existing account link identified by authId + sourceSystemId + sourceSystemUserId. Use this to change alias, metadata, secondary, or sourceSystemCreatedAt.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

clientId

string

required

Cortex client ID.

Body Params

authId

int64

required

The Cortex auth user ID to link.

sourceSystemId

string

required

External system identifier (e.g. TICKETMASTER, CRM_GUID). On v1 admin endpoints this field is ignored; the source system is derived from the X-APP-ID configuration.

sourceSystemUserId

string

required

The user's identifier in the external system.

sourceSystemCreatedAt

date-time | null

When the account was created in the external system. Optional.

alias

string | null

Optional human-readable alias for the link.

metadata

object | null

Optional free-form metadata. Use metadata.email to associate an email with the link.

secondary

boolean

Defaults to false

Mark this link as secondary (a fan may have multiple secondary links for the same source system, but only one primary).

Headers

Authorization

string

required

X-Real-IP

string

Optional. Recorded against the audit log entry for the change.

X-Forwarded-For

string

Optional. Recorded against the audit log entry for the change.

Responses

400

Validation error, or account_link_invalid if no matching link exists for the given identifiers.

401

Missing or invalid credentials.

403

Caller authenticated but lacks the required role.

500

Unexpected server error.

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Account link updated. The response body is the link after the update.