Update an automation

PATCH

api

automations

{automationId}

{
  "error": {
    "code": "api_invalid_content_length",
    "message": "Invalid Content-Length.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unauthorized",
    "message": "Authentication required.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_plan_limit",
    "message": "The account plan does not allow this automation.",
    "correlation_id": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "api_account_not_granted",
    "message": "This credential is not authorized for the request.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_media_not_found",
    "message": "The referenced Instagram media was not found.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_version_conflict",
    "message": "The automation changed after the supplied version.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_body_too_large",
    "message": "The JSON request body exceeds 1 MiB.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unsupported_media_type",
    "message": "Content-Type must be application/json.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_follow_up_missing",
    "message": "A start_follow_up opening button requires a follow-up.",
    "correlation_id": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_committed_response_unavailable",
    "message": "The automation committed, but its response could not be verified. Do not retry automatically.",
    "correlation_id": "<string>",
    "details": {
      "committed": true,
      "retryable": false
    }
  }
}

{
  "error": {
    "code": "api_account_resolution_unavailable",
    "message": "The reachable account set could not be read.",
    "correlation_id": "<string>"
  }
}

Use this endpoint to change name, configuration, or both. Your API key needs automations:write, and the body must contain an accessible account_id and expected_updated_at. You must send at least one of name and configuration. Status changes are not accepted here. Use Activate an automation or Deactivate an automation instead.

Send the complete configuration

configuration is a complete, typed automation configuration. It is not a partial merge. When you include it, the validated object replaces the stored configuration in full. Read the automation first, modify the returned configuration locally, and send the complete result. Omitting a section does not keep its previous stored value, because all five sections are required:

Section	Purpose
`contact_filter`	Which contacts the automation is allowed to answer.
`trigger`	What starts the automation and which publication or keywords it watches.
`opening`	The first direct message, and the optional public reply.
`follow_up`	The ordered actions after the opening message, or `null`.
`extras`	Cooldown behavior between repeated triggers.

The OpenAPI document is the source of truth for every field, enum, bound, and nested action shape. Its PublicAutomationUpdateV1 schema defines the complete request body and covers:

Trigger selection through type, and the publication, story, keywords, and reactions objects that belong to it.
Opening delivery through direct_message, its delay_seconds, message text, and up to three buttons of type start_follow_up or url.
Public replies through public_reply, its messages, rotation, mention_mode, and max_per_post.
Follow-up steps through actions, including send_message, send_media, send_carousel, ask_to_follow, ask_for_email, ask_for_phone, add_contact_tag, and finish.
Repeat protection through extras.cooldown.

Fields named type, mode, match_mode, rotation, or mention_mode are enums. Use only the values that document defines. The API rejects unknown properties and invalid combinations with 422 and api_automation_invalid_configuration. Read error.details.issues for the failing path, code, and message. Use List Instagram media to find the media id for a trigger that watches one specific publication or story.

Automations created before the public contract

An automation whose stored configuration predates the public contract is returned with authoring_compatibility set to read_only_legacy and configuration set to null. You can still rename it. Sending a complete configuration replaces the legacy configuration and converts the automation to the public contract, which cannot be undone through the API.

Protect concurrent changes

Read the automation first, then send its exact updated_at value as expected_updated_at. If another request changed the automation, the API returns 409 with api_automation_version_conflict. Read the automation again and build a new update from the value it returns.

Example request

curl --request PATCH \
  --url "https://levios.app/api/v1/automations/${LEVIOS_AUTOMATION_ID}" \
  --header "Authorization: Bearer ${LEVIOS_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data @- <<JSON
{
  "account_id": "${LEVIOS_ACCOUNT_ID}",
  "expected_updated_at": "${EXPECTED_UPDATED_AT}",
  "name": "Guide request",
  "configuration": {
    "contact_filter": "anyone",
    "trigger": {
      "type": "comment",
      "publication": {
        "mode": "specific",
        "reference": {
          "type": "url",
          "value": "https://www.instagram.com/p/ABC123/"
        }
      },
      "keywords": {
        "mode": "specific",
        "match_mode": "whole_word",
        "values": ["guide"]
      }
    },
    "opening": {
      "direct_message": {
        "delay_seconds": 0,
        "message": {
          "text": "Tap below to continue.",
          "buttons": [
            {
              "type": "start_follow_up",
              "title": "Continue"
            }
          ]
        }
      },
      "public_reply": {
        "enabled": true,
        "delay_seconds": 0,
        "max_per_post": 50,
        "mention_mode": "none",
        "rotation": "random",
        "messages": ["I sent it by DM."]
      }
    },
    "follow_up": {
      "actions": [
        {
          "type": "ask_for_email",
          "delay_seconds": 0,
          "message": "What is your best email address?",
          "retry_message": "Send a valid email address.",
          "max_attempts": 3,
          "expires_in_seconds": 86400,
          "retry_exhausted_action": "stop"
        },
        {
          "type": "send_message",
          "delay_seconds": 0,
          "text": "Here is your access link.",
          "buttons": [
            {
              "type": "url",
              "title": "Open content",
              "url": "https://example.com/content"
            }
          ]
        },
        {
          "type": "finish"
        }
      ]
    },
    "extras": {
      "cooldown": {
        "mode": "fixed",
        "seconds": 21600
      }
    }
  }
}
JSON

If the API returns api_automation_committed_response_unavailable with committed: true and retryable: false, the change was applied but the API could not verify the response. Do not retry automatically. Read the current automation before deciding whether another update is needed.

Example success response

Illustrative IDs, timestamps, and content. HTTP 200.

{
  "automation": {
    "id": "00000000-0000-4000-8000-000000000002",
    "account_id": "00000000-0000-4000-8000-000000000001",
    "name": "Updated guide request",
    "status": "draft",
    "has_unpublished_changes": false,
    "draft_updated_at": null,
    "created_at": "2026-09-01T12:00:00.000000Z",
    "updated_at": "2026-09-01T12:05:00.000000Z",
    "trigger_type": "comment",
    "configuration": {
      "contact_filter": "anyone",
      "trigger": {
        "type": "comment",
        "publication": {
          "mode": "all"
        },
        "keywords": {
          "mode": "specific",
          "match_mode": "whole_word",
          "values": [
            "guide"
          ]
        }
      },
      "opening": {
        "public_reply": {
          "enabled": false
        },
        "direct_message": {
          "delay_seconds": 0,
          "message": {
            "text": "Here is the guide you asked for.",
            "buttons": [
              {
                "type": "url",
                "title": "Open the guide",
                "url": "https://example.com/guide"
              }
            ]
          }
        }
      },
      "follow_up": null,
      "extras": {
        "cooldown": {
          "mode": "none"
        }
      }
    },
    "authoring_compatibility": "public_v1"
  }
}

Authoring guides

Authorizations

Authorization

string

header

required

Levios API key sent as a Bearer token.

Path Parameters

automationId

string<uuid>

required

Body

application/json

The body is of type any.

Response

Successful response.

{
  "error": {
    "code": "api_invalid_content_length",
    "message": "Invalid Content-Length.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unauthorized",
    "message": "Authentication required.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_plan_limit",
    "message": "The account plan does not allow this automation.",
    "correlation_id": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "api_account_not_granted",
    "message": "This credential is not authorized for the request.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_media_not_found",
    "message": "The referenced Instagram media was not found.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_version_conflict",
    "message": "The automation changed after the supplied version.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_body_too_large",
    "message": "The JSON request body exceeds 1 MiB.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unsupported_media_type",
    "message": "Content-Type must be application/json.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_follow_up_missing",
    "message": "A start_follow_up opening button requires a follow-up.",
    "correlation_id": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_committed_response_unavailable",
    "message": "The automation committed, but its response could not be verified. Do not retry automatically.",
    "correlation_id": "<string>",
    "details": {
      "committed": true,
      "retryable": false
    }
  }
}

{
  "error": {
    "code": "api_account_resolution_unavailable",
    "message": "The reachable account set could not be read.",
    "correlation_id": "<string>"
  }
}

Reference

Automations

Accounts

Contacts

Contact tags

Metrics

Update an automation

Send the complete configuration

Automations created before the public contract

Protect concurrent changes

Example request

Example success response

Authoring guides

Authorizations

Path Parameters

Body

Response

​Send the complete configuration

​Automations created before the public contract

​Protect concurrent changes

​Example request

​Example success response

​Authoring guides

Authorizations

Path Parameters

Body

Response

Send the complete configuration

Automations created before the public contract

Protect concurrent changes

Example request

Example success response

Authoring guides