Update an account link

put

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

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

Requires a JWT Bearer token with the ACCOUNTLINKSADMINUPDATE role.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

clientId

string

required

The client identifier.

Body Params

Request body used for v2 administrative account link create and update operations.

authId

int64

required

The FanScore 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

Timestamp when the account was created in the external system. Optional. May be null.

alias

string | null

Optional human-readable alias for the link.

secondary

boolean

Defaults to false

Whether this link should be treated as a secondary link. A fan may have multiple secondary links for the same source system, but only one primary.

Headers

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

Language

Credentials

Bearer

JWT

URL

Loading…

Response

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

application/json

200The updated account link.

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

401Missing or invalid credentials.

403Forbidden - caller does not have the ACCOUNTLINKSADMINUPDATE role.

404The referenced user or link does not exist.

500Internal Server Error.