# Update a contact `PATCH / PUT /api/v1/lists/{list_id}/contacts/{contact_id}` Replaces the details of a contact in the list. ## Permissions Send your API key in `X-API-Key`. Required permissions are **Lists → Write**. ## Headers - `X-Sport-Id` (integer, required) — The sport ID from [List sports](/api/sports/list.md). Use the sport the record belongs to. ## Path parameters - `list_id` (integer, required) — ID of the contact list. - `contact_id` (integer, required) — ID of a contact in this list. ## Body parameters - `firstname` (string or null) — Given name, up to 100 characters. Alias name. - `surname` (string or null) — Family name, up to 100 characters. - `company` (string or null) — Company or club name, up to 191 characters. - `email` (string or null) — Email address, up to 191 characters. Stored in lowercase. - `phone` (string or null) — Phone number, up to 32 characters. - `communication_consent` (boolean) — Whether the contact opted in. Defaults to false. Alias consent. - `is_active` (boolean) — Whether the contact is active. Defaults to true. Alias active. Send all the values you want to keep. The request clears omitted contact details and applies the defaults for activation and consent. ## Request (PATCH) Set ASDINCLOUD_API_KEY and any variables named in the example before running it. ```sh curl --request PATCH \ --url "https://api.asdincloud.com/api/v1/lists/${LIST_ID:?Set LIST_ID}/contacts/${CONTACT_ID:?Set CONTACT_ID}" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --header "X-Sport-Id: ${SPORT_ID:?Set SPORT_ID}" \ --header "Content-Type: application/json" \ --data '{"firstname":"Alex","surname":"Example","email":"alex@example.com","communication_consent":false,"company":"Example Juniors","is_active":true}' ``` ## Request (PUT) Set ASDINCLOUD_API_KEY and any variables named in the example before running it. ```sh curl --request PUT \ --url "https://api.asdincloud.com/api/v1/lists/${LIST_ID:?Set LIST_ID}/contacts/${CONTACT_ID:?Set CONTACT_ID}" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --header "X-Sport-Id: ${SPORT_ID:?Set SPORT_ID}" \ --header "Content-Type: application/json" \ --data '{"firstname":"Alex","surname":"Example","email":"alex@example.com","communication_consent":false,"company":"Example Juniors","is_active":true}' ``` ## Response **200 OK** Returns the update confirmation. Example with fictional data and selected fields. ```json { "message_key": "entities.list_contact.messages.updated" } ``` ## Errors - `401` — The API key is missing or invalid. - `403` — The API key lacks the required permission. - `400` — Send the body as a JSON object. - `404` — The requested record was not found. - `422` — One or more fields failed validation.