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

# Update a business lead follow-up automation

> Updates an automation for current-business leads, changing triggers, message steps, routing, or active follow-up settings.



## OpenAPI

````yaml /openapi.json put /automations/{id}
openapi: 3.0.4
info:
  title: Leadping API
  description: >-
    Leadping API for lead intake, messaging, calling, automations, billing,
    business settings, and compliant lead communication workflows.
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  version: v1
servers:
  - url: https://api.leadping.ai
    description: Production
security: []
tags:
  - name: Analytics
  - name: Automations
  - name: Contact
  - name: Conversations
  - name: Dispositions
  - name: Feedback
  - name: Leads
  - name: LeadStatuses
  - name: Notifications
  - name: OutboundDelivery
  - name: Sources
  - name: Suppressions
  - name: Tags
  - name: Users
  - name: Calls
  - name: PhoneNumbers
  - name: Sms
  - name: Telephony
  - name: UserDataExports
  - name: CallEvents
  - name: Events
  - name: SmsEvents
  - name: Businesses
  - name: PaymentMethods
  - name: Transactions
  - name: Usage
  - name: Wallets
paths:
  /automations/{id}:
    put:
      tags:
        - Automations
      summary: Update a business lead follow-up automation
      description: >-
        Updates an automation for current-business leads, changing triggers,
        message steps, routing, or active follow-up settings.
      operationId: Automations_Update
      parameters:
        - name: id
          in: path
          description: The ID of the automation.
          required: true
          schema:
            type: string
      requestBody:
        description: The automation request payload for the operation.
        content:
          application/json:
            schema:
              allOf:
                - $ref: '#/components/schemas/AutomationRequest'
              description: >-
                Request schema for the Leadping API automation configuration
                request, including the fields clients can send.
          application/*+json:
            schema:
              allOf:
                - $ref: '#/components/schemas/AutomationRequest'
              description: >-
                Request schema for the Leadping API automation configuration
                request, including the fields clients can send.
        required: true
      responses:
        '200':
          description: Returns the automation response.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/AutomationResponse'
                description: >-
                  Response schema for the Leadping API automation configuration
                  response returned to authenticated clients.
        '400':
          description: The request was invalid or failed validation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: The requested resource was not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
components:
  schemas:
    AutomationRequest:
      required:
        - name
      type: object
      properties:
        description:
          type: string
          description: >-
            Human-readable description that explains this automation
            configuration request to API users.
          nullable: true
        enabled:
          type: boolean
          description: >-
            Indicates whether this automation configuration request is active
            and available in the Leadping API.
          nullable: true
        scope:
          type: string
          description: >-
            Scope that limits where this automation configuration request
            applies in Leadping.
          nullable: true
        visibility:
          type: string
          description: >-
            Visibility level that controls who can see this automation
            configuration request.
          nullable: true
        triggers:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/AutomationTrigger'
            description: Public Leadping API schema for automation trigger data.
          description: Automation triggers that can start this workflow.
        conditionGroups:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/AutomationConditionGroup'
            description: Public Leadping API schema for automation condition group data.
          description: >-
            Grouped automation conditions used to decide whether this workflow
            should run.
        actions:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/AutomationAction'
            description: Public Leadping API schema for automation action data.
          description: Automation actions configured or returned for this workflow.
        version:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            Version number for this automation configuration request schema or
            saved configuration.
          format: int32
        name:
          maxLength: 255
          minLength: 0
          type: string
          description: The display name for the entity.
        id:
          type: string
          description: >-
            The unique identifier for the entity, when updating an existing
            entity.
          nullable: true
      description: >-
        Request schema for the Leadping API automation configuration request,
        including the fields clients can send.
    AutomationResponse:
      type: object
      properties:
        description:
          type: string
          description: >-
            Human-readable description that explains this automation
            configuration response to API users.
          nullable: true
        enabled:
          type: boolean
          description: >-
            Indicates whether this automation configuration response is active
            and available in the Leadping API.
          nullable: true
        businessId:
          type: string
          description: Business ID that owns this automation.
          nullable: true
        createdByUserId:
          type: string
          description: >-
            User ID of the person who created this automation configuration
            response.
          nullable: true
        scope:
          type: string
          description: >-
            Scope that limits where this automation configuration response
            applies in Leadping.
          nullable: true
        visibility:
          type: string
          description: >-
            Visibility level that controls who can see this automation
            configuration response.
          nullable: true
        managementLevel:
          type: string
          description: >-
            Management level that controls whether Leadping or the business owns
            this automation setting.
          nullable: true
        isSystemManaged:
          type: boolean
          description: >-
            Indicates whether Leadping manages this automation configuration
            response automatically instead of a user.
        triggers:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/AutomationTrigger'
            description: Public Leadping API schema for automation trigger data.
          description: Automation triggers that can start this workflow.
        conditionGroups:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/AutomationConditionGroup'
            description: Public Leadping API schema for automation condition group data.
          description: >-
            Grouped automation conditions used to decide whether this workflow
            should run.
        actions:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/AutomationAction'
            description: Public Leadping API schema for automation action data.
          description: Automation actions configured or returned for this workflow.
        lastRunAt:
          type: string
          description: UTC timestamp when this automation last ran.
          format: date-time
          nullable: true
        lastRunStatus:
          type: string
          description: Status from the most recent automation run.
          nullable: true
        recentRuns:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/AutomationRunRecord'
            description: >-
              History record schema for Leadping API automation run record data
              exposed in automation and audit views.
          description: Recent automation runs returned for history and troubleshooting.
        version:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            Version number for this automation configuration response schema or
            saved configuration.
          format: int32
        user:
          type: object
          allOf:
            - $ref: '#/components/schemas/IdNamePair'
          description: User summary connected to this automation configuration response.
          nullable: true
        business:
          type: object
          allOf:
            - $ref: '#/components/schemas/IdNamePair'
          description: >-
            Business summary connected to this automation configuration
            response.
          nullable: true
        name:
          type: string
          description: The display name for the entity.
        id:
          type: string
          description: The unique identifier for the entity.
        createdAt:
          type: string
          description: The date and time when the entity was created.
          format: date-time
        modifiedAt:
          type: string
          description: The date and time when the entity was last modified, if applicable.
          format: date-time
          nullable: true
      description: >-
        Response schema for the Leadping API automation configuration response
        returned to authenticated clients.
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          description: URI reference that identifies the problem type.
          nullable: true
        title:
          type: string
          description: Short, human-readable summary of the problem.
          nullable: true
        status:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: HTTP status code returned for the problem.
          format: int32
          nullable: true
        detail:
          type: string
          description: >-
            Human-readable explanation specific to this occurrence of the
            problem.
          nullable: true
        instance:
          type: string
          description: >-
            URI reference that identifies this specific occurrence of the
            problem.
          nullable: true
    AutomationTrigger:
      type: object
      properties:
        id:
          type: string
          description: Unique Leadping identifier for this automation trigger.
        type:
          type: string
          description: >-
            Type classification used to route and interpret this automation
            trigger in the Leadping API.
        displayName:
          type: string
          description: Human-readable display name shown for this automation trigger.
          nullable: true
        isEnabled:
          type: boolean
          description: >-
            Indicates whether this automation trigger is active and allowed to
            run.
        settings:
          type: object
          additionalProperties:
            type: string
          description: >-
            Key-value settings that configure how this automation trigger
            behaves.
      description: Public Leadping API schema for automation trigger data.
    AutomationConditionGroup:
      type: object
      properties:
        id:
          type: string
          description: Unique Leadping identifier for this automation condition group.
        mode:
          type: string
          description: >-
            Execution mode that controls how this automation condition group is
            evaluated.
        conditions:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/AutomationCondition'
            description: Public Leadping API schema for automation condition data.
          description: Automation conditions evaluated before an action or workflow runs.
      description: Public Leadping API schema for automation condition group data.
    AutomationAction:
      type: object
      properties:
        id:
          type: string
          description: Unique Leadping identifier for this automation action.
        type:
          type: string
          description: >-
            Type classification used to route and interpret this automation
            action in the Leadping API.
        order:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: Sort order used to evaluate or display this automation action.
          format: int32
        isEnabled:
          type: boolean
          description: >-
            Indicates whether this automation action is active and allowed to
            run.
        settings:
          type: object
          additionalProperties:
            type: string
          description: >-
            Key-value settings that configure how this automation action
            behaves.
      description: Public Leadping API schema for automation action data.
    AutomationRunRecord:
      type: object
      properties:
        id:
          type: string
          description: Unique Leadping identifier for this automation run record.
        automationId:
          type: string
          description: Automation ID connected to this workflow, run, or event.
          nullable: true
        businessId:
          type: string
          description: Business ID that owns this automation run.
          nullable: true
        leadId:
          type: string
          description: >-
            Lead ID that triggered this automation run, when the run is
            lead-based.
          nullable: true
        triggerType:
          type: string
          description: Automation trigger type that starts the workflow.
          nullable: true
        status:
          type: string
          description: >-
            Current lifecycle status for this automation run record in the
            Leadping API.
        executionMode:
          type: string
          description: >-
            Execution mode used for automation preview or live workflow
            processing.
        startedAt:
          type: string
          description: >-
            UTC timestamp when processing started for this automation run
            record.
          format: date-time
        completedAt:
          type: string
          description: >-
            UTC timestamp when processing completed for this automation run
            record.
          format: date-time
          nullable: true
        processingAttempts:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            Number of processing attempts made for this workflow or delivery
            request.
          format: int32
        lastAttemptAt:
          type: string
          description: >-
            UTC timestamp when Leadping last attempted to process this
            automation run.
          format: date-time
          nullable: true
        failureCode:
          type: string
          description: >-
            Machine-readable failure code for troubleshooting this automation
            run record.
          nullable: true
        skippedReason:
          type: string
          description: >-
            Human-readable reason explaining why Leadping skipped this
            automation run.
          nullable: true
        actions:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/AutomationActionRunRecord'
            description: >-
              History record schema for Leadping API automation action run
              record data exposed in automation and audit views.
          description: Automation actions configured or returned for this workflow.
      description: >-
        History record schema for Leadping API automation run record data
        exposed in automation and audit views.
    IdNamePair:
      required:
        - id
        - name
      type: object
      properties:
        id:
          type: string
          description: The unique identifier.
        name:
          type: string
          description: The display name.
      description: >-
        A minimal Record type with an (string), (string), and maximum JSON
        compatibility. The reason for this type (over something like
        KeyValuePair, dictionary) is because of JSON serialization support.
    AutomationCondition:
      type: object
      properties:
        id:
          type: string
          description: Unique Leadping identifier for this automation condition.
        type:
          type: string
          description: >-
            Type classification used to route and interpret this automation
            condition in the Leadping API.
        operator:
          type: string
          description: Automation comparison operator used by this condition.
          nullable: true
        isEnabled:
          type: boolean
          description: >-
            Indicates whether this automation condition is active and allowed to
            run.
        settings:
          type: object
          additionalProperties:
            type: string
          description: >-
            Key-value settings that configure how this automation condition
            behaves.
      description: Public Leadping API schema for automation condition data.
    AutomationActionRunRecord:
      type: object
      properties:
        id:
          type: string
          description: Unique Leadping identifier for this automation action run record.
        automationRunId:
          type: string
          description: Automation run ID connected to this action or event record.
          nullable: true
        actionId:
          type: string
          description: >-
            Automation action ID executed or evaluated by this automation action
            run record.
          nullable: true
        actionType:
          type: string
          description: Automation action type, such as send SMS or create task.
        order:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            Sort order used to evaluate or display this automation action run
            record.
          format: int32
        status:
          type: string
          description: >-
            Current lifecycle status for this automation action run record in
            the Leadping API.
        startedAt:
          type: string
          description: >-
            UTC timestamp when processing started for this automation action run
            record.
          format: date-time
        scheduledAt:
          type: string
          description: UTC timestamp when this automation action run record was scheduled.
          format: date-time
          nullable: true
        completedAt:
          type: string
          description: >-
            UTC timestamp when processing completed for this automation action
            run record.
          format: date-time
          nullable: true
        failedAt:
          type: string
          description: >-
            UTC timestamp when processing failed for this automation action run
            record.
          format: date-time
          nullable: true
        processingAttempts:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            Number of processing attempts made for this workflow or delivery
            request.
          format: int32
        nextRetryAt:
          type: string
          description: >-
            UTC timestamp when Leadping will retry this automation action run
            record.
          format: date-time
          nullable: true
        failureCode:
          type: string
          description: >-
            Machine-readable failure code for troubleshooting this automation
            action run record.
          nullable: true
      description: >-
        History record schema for Leadping API automation action run record data
        exposed in automation and audit views.

````