---
title: "GET /api/v1/agents/{agentId}/automations/{automationId}/runs/{runId}"
method: GET
path: "/api/v1/agents/{agentId}/automations/{automationId}/runs/{runId}"
tags: ["automations"]
---

# GET /api/v1/agents/{agentId}/automations/{automationId}/runs/{runId}

`GET /api/v1/agents/{agentId}/automations/{automationId}/runs/{runId}`

## Request

- Base URL: `https://api.clerkchat.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.clerkchat.co/api/v1/agents/{agentId}/automations/{automationId}/runs/{runId}`
- Auth: none required

## Path parameters

- `agentId` string, required
- `automationId` string, required
- `runId` string, required

## Response `200`

AutomationRunDetailResponse

- AutomationRunDetailResponseEncoded
  - `run` AutomationRunEncoded, required
    - `id` string, required
    - `organizationId` string, required
    - `agentId` string, required
    - `automationId` string, required
    - `automationRevision` integer, required
    - `sourceEventId` string, required
    - `sourceEventType` string, required
    - `sourceEventVersion` integer, required
    - `status` 'queued' | 'running' | 'succeeded' | 'retrying' | 'failed' | 'skipped', required
    - `attempts` integer, required
    - `maxAttempts` integer, required
    - `nextAttemptAt` integer, nullable, required
    - `trigger` union, required
      - object
        - `type` 'model.instruction', required
        - `version` 1, required
        - `whenToUse` string, required
        - `channels` string[], required
      - object
        - `type` 'conversation.created', required
        - `version` 1, required
      - object
        - `type` 'takeover.requested', required
        - `version` 1, required
      - object
        - `type` 'lead.submitted', required
        - `version` 1, required
    - `action` union, required
      - object
        - `type` 'suggested_messages', required
        - `version` 1, required
        - `mode` 'auto' | 'manual', required
        - `messages` string[], required
        - `disableInput` boolean, required
      - object
        - `type` 'custom_button', required
        - `version` 1, required
        - `buttonText` string, required
        - `url` string, required
        - `actionName` string, nullable
      - object
        - `type` 'collect_leads', required
        - `version` 1, required
        - `fields` object[], required
          - `key` 'name' | 'email' | 'phone', required
          - `enabled` boolean, required
          - `required` boolean, required
        - `successMessage` string, required
        - `dismissMessage` string, required
      - object
        - `type` 'collect_leads', required
        - `version` 2, required
        - `fields` object[], required
          - `id` string, required
          - `label` string, required
          - `kind` 'text' | 'email' | 'phone' | 'textarea', required
          - `required` boolean, required
          - `maxLength` integer, nullable, required
        - `successMessage` string, required
        - `dismissMessage` string, required
        - `notification` union, required
          - object
            - `kind` 'none', required
          - object
            - `kind` 'slack', required
            - `channelId` string, nullable, required
            - `template` string, nullable, required
      - object
        - `type` 'slack', required
        - `version` 1, required
        - `channelId` string, nullable, required
        - `template` string, required
      - object
        - `type` 'escalate', required
        - `version` 1, required
        - `ticketPlatform` 'intercom' | 'zendesk'
        - `stopAi` boolean, required
        - `confirmationMessage` string, required
      - object
        - `type` 'custom_action', required
        - `version` 1, required
        - `method` 'GET' | 'POST', required
        - `url` string, required
        - `headers` object, required
        - `bodyTemplate` string, nullable, required
        - `inputs` object[], required
          - `name` string, required
          - `description` string, required
          - `required` boolean, required
        - `dataAccess` 'full' | 'summary', required
      - object
        - `type` 'shopify_products', required
        - `version` 1, required
      - object
        - `type` 'shopify_get_cart', required
        - `version` 1, required
      - object
        - `type` 'shopify_update_cart', required
        - `version` 1, required
      - object
        - `type` 'stripe_get_subscription', required
        - `version` 1, required
      - object
        - `type` 'stripe_get_invoices', required
        - `version` 1, required
      - object
        - `type` 'stripe_update_customer', required
        - `version` 1, required
      - object
        - `type` 'stripe_cancel_subscription', required
        - `version` 1, required
      - object
        - `type` 'slack.notification', required
        - `version` 1, required
        - `channelId` string, nullable, required
        - `template` string, required
      - object
        - `type` 'chat.quickReplies', required
        - `version` 1, required
        - `replies` object[], required
          - `label` string, required
          - `value` union, required
            - object
              - …
            - object
              - …
          - `removeAfterSelection` boolean, required
      - object
        - `type` 'chat.customButton', required
        - `version` 1, required
        - `label` string, required
        - `url` string, required
      - object
        - `type` 'chat.leadForm', required
        - `version` 1, required
        - `fields` union[], required
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
    - `provider` string, nullable, required
    - `providerStatusCode` integer, nullable, required
    - `providerErrorCode` string, nullable, required
    - `providerMessageId` string, nullable, required
    - `failureClass` string, nullable, required
    - `failureMessage` string, nullable, required
    - `queuedAt` integer, required
    - `startedAt` integer, nullable, required
    - `completedAt` integer, nullable, required
    - `updatedAt` integer, required

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `403`: Forbidden
- `404`: NotFound
- `500`: InvalidStoredData
- `503`: PersistenceUnavailable

---

[API](https://skmtc.dev/clerkchat/apis/clerk-chat-api.md) · [All operations](https://skmtc.dev/clerkchat/apis/clerk-chat-api/llms.txt) · [OpenAPI document](https://skmtc.dev/clerkchat/apis/clerk-chat-api/revisions/cc318e39e1d0?raw)