> ## Documentation Index > Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Update Visa Alias by Visa Alias ID > Use this endpoint to update a Visa Alias by its Visa Alias ID. PUT/digitalwallets/aliasdirectory/visa/aliases/\{aliasId} Use this endpoint to update a Visa Alias by its Visa Alias ID. ## Header parameter | Fields | Description | | - | - | | req-sys-id string Required | Identifier generated by the card program. These identifiers are used for troubleshooting requests between the card program and Marqeta. **Allowable Values:** 36 char max | | participant-id string Required | Visa Business Identifier (BID) that is assigned to the program. **Allowable Values:** Existing participant ID | ## URL path parameters | Fields | Description | | - | - | | aliasId string Required | Unique identifier of the Visa Alias. **Allowable Values:** Existing Visa Alias ID | ## Request body | Fields | Description | | - | - | | consent object Required | Visa Alias Directory Service (ADS) consent information. **Allowable Values:** `presenter`, `validFromDateTime`, `version`, `expiryDateTime`, `intermediaries` | | consent.**presenter** string Required | Presenter of the Visa Alias Directory Service (ADS) consent. **Allowable Values:** 1–120 chars | | consent.**validFromDateTime** datetime Required | Date and time when the validity of the Visa ADS consent begins. **Allowable Values:** 20 chars Format: YYYY-MM-DDThh:mm:ssZ | | consent.**version** string Required | Version of the Visa ADS consent. **Allowable Values:** 1–9 chars | | consent.**expiryDateTime** datetime Optional | Date and time when the validity of the Visa ADS consent ends. This field is returned if it exists in the resource. **Allowable Values:** 20 chars Format: YYYY-MM-DDThh:mm:ssZ | | consent.**intermediaries** array of strings Optional | Intermediaries of the Visa ADS consent. **Allowable Values:** 1–120 chars | | profile object Required | Alias Directory Service (ADS) profile information. **Allowable Values:** - `firstName` - `lastName` - `contactInfo` - `dateOfBirth` - `firstNameLocal` - `lastNameLocal` - `middleName` - `middleNameLocal` - `preferredName` | | profile.**firstName** string Required | First name in the Alias Directory Service (ADS) profile. **Allowable Values:** 1–35 chars | | profile.**lastName** string Required | Last name in the Alias Directory Service (ADS) profile. Participants in the CEMEA and EU regions must only use the initial of the consumer's last name followed by a period to create or modify a Visa Alias record. **Allowable Values:** 1–35 chars | | profile.**contactInfo** array of objects Optional | Contact information in the Alias Directory Service (ADS) profile. This array is returned if the Visa Alias' contact information details exist. **Allowable Values:** A valid array of contact information details | | profile.contactInfo\[].**type** string Required | Type of contact information in the Alias Directory Service (ADS) profile. **Allowable Values:** `EMAIL`, `PHONE`, `DIRECTORY_ALIASID` | | profile.contactInfo\[].**value** string Required | Contact information value, which is the email address or phone number. **Allowable Values:** 1–320 chars | | profile.**dateOfBirth** string Optional | Date of birth in the Alias Directory Service (ADS) profile. This field is returned if it exists in the resource. **Allowable Values:** 10 chars | | profile.**firstNameLocal** string Optional | First name in the Alias Directory Service (ADS) profile, expressed in the user's local language. This field is returned if it exists in the resource. **Allowable Values:** 1–35 chars | | profile.**lastNameLocal** string Optional | Last name in the Alias Directory Service (ADS) profile, expressed in the user's local language. This field is returned if it exists in the resource. **Allowable Values:** 1–35 chars | | profile.**middleName** string Optional | Middle name in the Alias Directory Service (ADS) profile. This field is returned if it exists in the resource. **Allowable Values:** 1–35 chars | | profile.**middleNameLocal** string Optional | Middle name in the Alias Directory Service (ADS) profile, expressed in the user's local language. This field is returned if it exists in the resource. **Allowable Values:** 1–35 chars | | profile.**preferredName** string Optional | Preferred name in the Alias Directory Service (ADS) profile, as provided by the user. This field is returned if it exists in the resource. **Allowable Values:** 1–35 chars | | identification object Optional | Identification of the user associated with the Visa Alias. **Allowable Values:** `type`, `value`, `verificationDetails` | | identification.**type** string Required | Type of identification provided by the user associated with the Visa Alias. **Allowable Values:** `DNI`, `CE`, `PASSPORT`, `PTP`, `FFPP`, `FFAA`, `CCD`, `COI`, `PN`, `CIE`, `CPF`, `DL`, `DPI`, `NIDN` | | identification.**value** string Required | Value of the identification provided by the user associated with the Visa Alias, which is used to validate the user. Passport number, for example. **Allowable Values:** 1–35 chars | | identification.**verificationDetails** object Optional | Verification details associated with the Visa Alias. This field is returned if it exists in the resource. **Allowable Values:** `authDateTime`, `authMethodReference`, `creationDateTime`, `verifiedEmail`, `verifiedPhone` | | identification.verificationDetails.**authDateTime** datetime Optional | Time when the user provided the credentials for verification in ISO UTC format. **Allowable Values:** format: YYYY-MM-DDThh:mm:ss.000Z | | identification.verificationDetails.**authMethodReference** string Optional | Authentication method used when the user provided the credentials for verification. **Allowable Values:** 256 char | | identification.verificationDetails.**creationDateTime** datetime Optional | Time when the user was created or enrolled in ISO UTC format. **Allowable Values:** format: YYYY-MM-DDThh:mm:ss.000Z | | identification.verificationDetails.**verifiedEmail** boolean Optional | Returns `true` if an email was verified during the verification process. This email does not need to match the Alias or contact info if an email was used. **Allowable Values:** `true`, `false` | | identification.verificationDetails.**verifiedPhone** boolean Optional | Returns `true` if a phone number was verified during the verification process. This phone number does not need to match the Alias or contact info if a phone number was used. **Allowable Values:** `true`, `false` | ## Sample request body ```json JSON expandable lines wrap theme={null} { "aliasValue": "1231231234", "aliasType": "PHONE", "profile": { "firstName": "Alex", "middleName": "Robert", "lastName": "Miller", "firstNameLocal": "Alexander", "middleNameLocal": "Roberto", "lastNameLocal": "Miller", "preferredName": "Miller's Shop", "dateOfBirth": "1980-02-01", "contactInfo": [ { "type": "PHONE", "value": "1231234321" } ] }, "consent": { "version": "1.0", "presenter": "Bank A", "validFromDateTime": "2024-12-01T10:00:00Z", "expiryDateTime": "2025-06-20T10:00:00Z", "intermediaries": [ "Client A" ] }, "identification": { "type": "PASSPORT", "value": "A123456", "verificationDetails": { "authDateTime": "2026-01-01T22:52:46Z", "verifiedEmail": true, "verifiedPhone": false, "creationDateTime": "2026-01-01T22:52:46Z", "authMethodReference": "EXTERNAL, SMS OTP, Email OTP" } }, "createdOn": "2026-01-01T22:52:46Z", "lastModifiedOn": "2026-01-01T22:52:46Z", "status": "ACTIVE" } ``` ## Related topics - [Visa Aliases Overview](https://www.marqeta.com/docs/core-api/digital-wallets-management/visa-aliases.md) - [Digital Wallets Management Overview](https://www.marqeta.com/docs/core-api/digital-wallets-management.md) - [Delete Visa Alias by Visa Alias ID](https://www.marqeta.com/docs/core-api/digital-wallets-management/visa-aliases/delete-visa-alias-by-visa-alias-id.md) - [Retrieve Visa Alias by Visa Alias ID](https://www.marqeta.com/docs/core-api/digital-wallets-management/visa-aliases/retrieve-visa-alias-by-visa-alias-id.md) - [Create a Visa Alias](https://www.marqeta.com/docs/core-api/digital-wallets-management/visa-aliases/create-visa-alias.md)