> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Hand-write one step for one person

> Hand-write one step for one person — Stores a rendered snapshot the sequence sends to this person INSTEAD of the step: email as subject + html (text derived when omitted), a…



## OpenAPI

````yaml put /sequences/{sequenceId}/contacts/{contactId}/steps/{stepIndex}/personalization
openapi: 3.1.0
info:
  title: OpenCX API
  description: >

    OpenCX is an AI-powered, all-in-one platform for customer support and
    outbound communications.


    Use this API to manage your OpenCX organization's AI agents, actions,
    conversations, contacts, and more.


    To get started, generate a new API key from the dashboard.


    ## Authentication

    All API endpoints require authentication using a Bearer token. You can
    generate an API key from your OpenCX dashboard.


    ## Rate Limiting

    API requests are rate limited to ensure fair usage. The current limits are:

    - 100 requests per minute for standard endpoints

    - 1000 requests per minute for streaming endpoints


    ## Error Handling

    The API uses standard HTTP status codes and returns detailed error messages
    in the response body.
  version: 1.0-beta
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: http://localhost:8080
    description: Development
  - url: https://api.open.cx
    description: Production
security:
  - bearerAuth: []
paths:
  /sequences/{sequenceId}/contacts/{contactId}/steps/{stepIndex}/personalization:
    put:
      summary: Hand-write one step for one person
      description: >-
        Stores a rendered snapshot the sequence sends to this person INSTEAD of
        the step: email as subject + html (text derived when omitted), a voice
        call brief, or literal slot values on the step's own WhatsApp template.
        Only for steps the person has not reached. A person parked on this step
        for missing data is released — the snapshot has no holes. Editing the
        step later never touches it; clear it to go back to the template.
      operationId: setSequenceStepPersonalization
      parameters:
        - schema:
            type: string
            format: uuid
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
          in: path
          name: sequenceId
          required: true
          description: The unique identifier of the sequence
        - schema:
            type: string
            format: uuid
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
          in: path
          name: contactId
          required: true
          description: The person's contact id (from enroll results or the people list)
        - schema:
            type: integer
            minimum: 0
            maximum: 9007199254740991
          in: path
          name: stepIndex
          required: true
          description: Zero-based position in the step list
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetSequenceStepPersonalizationDto'
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SetSequenceStepPersonalizationOutputDto'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
components:
  schemas:
    SetSequenceStepPersonalizationDto:
      $schema: https://json-schema.org/draft/2020-12/schema
      $id: '#/components/schemas/SetSequenceStepPersonalizationDtoInput'
      type: object
      properties:
        content:
          oneOf:
            - type: object
              properties:
                type:
                  type: string
                  const: email
                subject:
                  type: string
                  minLength: 1
                  maxLength: 998
                html:
                  type: string
                  minLength: 1
                  maxLength: 65536
                text:
                  description: Plain-text alternative. Derived from html when omitted.
                  type: string
                  minLength: 1
              required:
                - type
                - subject
                - html
            - type: object
              properties:
                type:
                  type: string
                  const: voice_call
                extra_instructions:
                  anyOf:
                    - type: string
                      minLength: 1
                      maxLength: 10000
                    - type: 'null'
              required:
                - type
                - extra_instructions
            - type: object
              properties:
                type:
                  type: string
                  const: whatsapp_template
                template_name:
                  type: string
                  minLength: 1
                template_language:
                  type: string
                  minLength: 1
                values:
                  type: object
                  propertyNames:
                    type: string
                    pattern: ^[A-Za-z0-9_]+$
                  additionalProperties:
                    type: string
                    minLength: 1
                    maxLength: 1024
                  description: >-
                    Literal body values keyed by positional index or exact
                    parameter name; cover every body parameter with no extras.
              required:
                - type
                - template_name
                - template_language
                - values
      required:
        - content
    SetSequenceStepPersonalizationOutputDto:
      $schema: https://json-schema.org/draft/2020-12/schema
      $id: '#/components/schemas/SetSequenceStepPersonalizationOutputDto'
      type: object
      properties:
        personalization:
          $ref: '#/components/schemas/SequenceStepPersonalizationDto'
        unparked:
          type: boolean
        armed:
          type: boolean
      required:
        - personalization
        - unparked
        - armed
      additionalProperties: false
    ErrorDto:
      type: object
      properties:
        statusCode:
          type: integer
        message:
          type: string
        error:
          type: string
    SequenceStepPersonalizationDto:
      $schema: https://json-schema.org/draft/2020-12/schema
      $id: '#/components/schemas/SequenceStepPersonalizationDto'
      type: object
      properties:
        step_index:
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        content:
          anyOf:
            - oneOf:
                - type: object
                  properties:
                    type:
                      type: string
                      const: email
                    subject:
                      type: string
                      minLength: 1
                      maxLength: 998
                    html:
                      type: string
                      minLength: 1
                      maxLength: 65536
                    text:
                      type: string
                      minLength: 1
                      maxLength: 65536
                  required:
                    - type
                    - subject
                    - html
                    - text
                  additionalProperties: false
                - type: object
                  properties:
                    type:
                      type: string
                      const: voice_call
                    extra_instructions:
                      anyOf:
                        - type: string
                          minLength: 1
                          maxLength: 10000
                        - type: 'null'
                  required:
                    - type
                    - extra_instructions
                  additionalProperties: false
                - type: object
                  properties:
                    type:
                      type: string
                      const: whatsapp_template
                    template_name:
                      type: string
                      minLength: 1
                    template_language:
                      type: string
                      minLength: 1
                    values:
                      type: object
                      propertyNames:
                        type: string
                        pattern: ^[A-Za-z0-9_]+$
                      additionalProperties:
                        type: string
                        minLength: 1
                        maxLength: 1024
                      description: >-
                        Literal body values keyed by positional index or exact
                        parameter name; cover every body parameter with no
                        extras.
                  required:
                    - type
                    - template_name
                    - template_language
                    - values
                  additionalProperties: false
            - type: 'null'
        edited_at:
          anyOf:
            - type: string
              format: date-time
              pattern: >-
                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
            - type: 'null'
        edited_by:
          anyOf:
            - type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
            - type: 'null'
        stale:
          type: boolean
        unreadable:
          type: boolean
      required:
        - step_index
        - content
        - edited_at
        - edited_by
        - stale
        - unreadable
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.