> ## Documentation Index > Fetch the complete documentation index at: https://developers.kit.com/llms.txt > Use this file to discover all available pages before exploring further. # Update a sequence > Updates any sequence settings — `name`, `email_address`, schedule (`send_days`, `send_hour`, `time_zone`), `email_template_id`, `exclude_subscriber_sources`, or the `active` / `repeat` / `hold` flags. Only fields included in the request body change; everything else is preserved. Some changes have user-visible side effects on subscribers already in the sequence: **Note:** flipping `active` from `false` to `true` resumes delivery for queued subscribers. Flipping it back to `false` pauses the sequence — subscribers stay in their current position but no new emails are sent until it's reactivated. **Note:** changing the schedule (`send_days`, `send_hour`, or `time_zone`) only affects future sends. It does not retroactively reschedule emails already queued for delivery. **Warning:** turning off `repeat` while subscribers are mid-sequence does not stop them from finishing — but they won't be re-eligible to start over after completing. See [Create a sequence](/api-reference/sequences/create-a-sequence) for the full sequence model and what each field controls. ## OpenAPI ````yaml /api-reference/v4.json put /v4/sequences/{id} openapi: 3.0.3 info: title: Kit API version: '4.0' servers: - url: https://api.kit.com security: [] paths: /v4/sequences/{id}: put: tags: - Sequences summary: Update a sequence description: >- Updates any sequence settings — `name`, `email_address`, schedule (`send_days`, `send_hour`, `time_zone`), `email_template_id`, `exclude_subscriber_sources`, or the `active` / `repeat` / `hold` flags. Only fields included in the request body change; everything else is preserved. Some changes have user-visible side effects on subscribers already in the sequence: **Note:** flipping `active` from `false` to `true` resumes delivery for queued subscribers. Flipping it back to `false` pauses the sequence — subscribers stay in their current position but no new emails are sent until it's reactivated. **Note:** changing the schedule (`send_days`, `send_hour`, or `time_zone`) only affects future sends. It does not retroactively reschedule emails already queued for delivery. **Warning:** turning off `repeat` while subscribers are mid-sequence does not stop them from finishing — but they won't be re-eligible to start over after completing. See [Create a sequence](/api-reference/sequences/create-a-sequence) for the full sequence model and what each field controls. parameters: - name: id in: path required: true schema: type: integer example: 59 requestBody: content: application/json: schema: type: object properties: name: type: string description: The name of the sequence. email_address: type: string description: >- The sending email address to use. Uses the account's sending email address if not provided. email_template_id: type: integer description: Id of the email template to use. send_days: type: array items: type: string description: >- The days of the week to send the sequence on. Must be one of: `monday`, `tuesday`, `wednesday`, `thursday`, `friday`, `saturday`, `sunday`. send_hour: type: integer description: >- The hour of the day to send the sequence at. Must be an integer between 0 and 23. time_zone: type: string description: >- The timezone to use for the sequence. Must be a valid IANA timezone string. active: type: boolean description: '`true` to activate the sequence, `false` to deactivate it.' repeat: type: boolean description: >- When `true`, subscribers can restart the sequence multiple times. hold: type: boolean description: >- When `true`, subscribers added via Visual Automations stay in the sequence after receiving the last email. exclude_subscriber_sources: type: array description: The subscriber sources to exclude from the sequence. items: type: object properties: type: type: string description: >- The type of subscriber source to exclude. Must be one of: `tag`, `sequence`, `form`, `segment`. ids: type: array items: type: integer description: The ids of the subscriber sources to exclude. required: - type - ids example: name: New Name email_address: joe956@ck.lol email_template_id: 12 send_days: - tuesday - thursday send_hour: 14 time_zone: America/Chicago active: false repeat: true hold: true exclude_subscriber_sources: - type: tag ids: - 3 - type: sequence ids: - 48 responses: '200': description: Updates the sequence and returns its details content: application/json: schema: type: object properties: sequence: type: object properties: id: type: integer name: type: string hold: type: boolean repeat: type: boolean created_at: type: string updated_at: type: string email_address: type: string email_template_id: type: integer send_days: type: array items: type: string send_hour: type: integer time_zone: type: string active: type: boolean exclude_subscriber_sources: type: array items: type: object properties: type: type: string ids: type: array items: type: integer required: - type - ids required: - id - name - hold - repeat - created_at - updated_at - email_address - email_template_id - send_days - send_hour - time_zone - active - exclude_subscriber_sources required: - sequence example: sequence: id: 49 name: New Name hold: true repeat: true created_at: '2026-05-08T14:40:31Z' updated_at: '2026-05-08T14:40:31Z' email_address: joe956@ck.lol email_template_id: 12 send_days: - tuesday - thursday send_hour: 14 time_zone: America/Chicago active: false exclude_subscriber_sources: - type: sequence ids: - 48 - type: tag ids: - 3 '401': description: Returns a 401 if the token and/or account cannot be authenticated content: application/json: schema: type: object properties: errors: type: array items: type: string required: - errors example: errors: - The access token is invalid '404': description: Returns a 404 when the provided id does not exist content: application/json: schema: type: object properties: errors: type: array items: type: string required: - errors example: errors: - Not Found '422': description: >- Returns a 422 with an error message when one or more of the parameters were invalid content: application/json: schema: type: object properties: errors: type: array items: type: string required: - errors example: errors: - name can't be blank security: - API Key: [] - OAuth2: [] components: securitySchemes: API Key: description: Authenticate API requests via an API Key type: apiKey in: header name: X-Kit-Api-Key OAuth2: description: Authenticate API requests via an OAuth token type: oauth2 flows: authorizationCode: authorizationUrl: https://api.kit.com/v4/oauth/authorize tokenUrl: https://api.kit.com/v4/oauth/token refreshUrl: https://api.kit.com/v4/oauth/token scopes: read: Read access to Kit API v4 write: Write access to Kit API v4 ````