# Update a notification node `PATCH / PUT /api/v1/notification_nodes/{id}` Updates a notification node by ID. ## Permissions Send your API key in `X-API-Key`. Required permissions are **Notification nodes → Write**. ## Path parameters - `id` (integer, required) — ID of the notification node. ## Body parameters - `scope` (string) — Use med for medical certificates, doc for documents, birthday for birthdays, or payments for payment reminders. - `channel` (string) — Use email or sms. SMS requires the SMS module and an SMS template. - `when_type` (string) — Unit for the notification timing. Use years, months, weeks, days, or hours. - `when_num` (integer) — Non-negative number of timing units. - `template_id` (integer) — ID of the message template. - `is_active` (boolean) — Whether this rule is active. Defaults to true when creating it. - `send_to_atleti` (boolean) — Target athletes. Alias send_to_athletes. - `send_to_genitori` (boolean) — Target parents. Alias send_to_parents. - `send_to_coach` (boolean) — Target coaches. Alias send_to_coaches. - `send_to_staff` (boolean) — Target staff. - `cc_emails` (array of strings, string, or null) — Additional email recipients. A string can separate addresses with commas or semicolons. Use null to clear. - `birthday_subject` (string) — Use athlete, coach, or staff for birthday notifications. Defaults to athlete. - `send_to_subject` (boolean) — Send a coach or staff birthday notification to that person. Defaults to true. Omitted fields and recipient switches retain their values. Provide an eligible recipient. Payment reminders require athletes or parents. For coach or staff birthdays, target the subject or provide additional addresses for email. ## 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/notification_nodes/${ID:?Set ID}" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --header "Content-Type: application/json" \ --data '{"when_num":21,"when_type":"days"}' ``` ## 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/notification_nodes/${ID:?Set ID}" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --header "Content-Type: application/json" \ --data '{"when_num":21,"when_type":"days"}' ``` ## Response **200 OK** Returns a successful update response. Example with fictional data and selected fields. ```json { "message_key": "entities.notification_node.messages.updated" } ``` ## Errors - `401` — The API key is missing or invalid. - `403` — The API key lacks the required permission. - `404` — The requested record was not found. - `400` — The request body must be a JSON object. - `409` — A change to this notification category is already in progress. Retry later. - `422` — One or more fields failed validation.