---
title: "Get an action"
method: GET
path: "/actions/{action_id}"
tags: [""]
---

# Get an action

`GET /actions/{action_id}`

Retrieves metadata about an action.

## Path parameters

- `action_id` string, required

## Query parameters

- `include_assistants` boolean

## Headers

- `Authorization` string, required

## Response `200`

200

- GetActionResponse200
  - `status` string
  - `response` ActionsActionIdGetResponsesContentApplicationJsonSchemaResponse
    - `actions` ActionsActionIdGetResponsesContentApplicationJsonSchemaResponseActionsItems[]
      - `action_id` string — Action ID.
      - `action_type` 'REAL_TIME_BOOKING' | 'INFORMATION_EXTRACTOR' | 'LIVE_TRANSFER' | 'SEND_SMS' | 'INCALL_SMS' | 'INCALL_WHATSAPP' | 'CUSTOM_ACTION' | 'CUSTOM_EVAL' — Action type.
      - `name` string — Action name.
      - `description` string — Action description.
      - `assistants` string[] — Assistant IDs assigned to this action. Returned when `include_assistants=true`.
      - `input_variables` ActionsActionIdGetResponsesContentApplicationJsonSchemaResponseActionsItemsInputVariables — Input variable details for this action, including variable definitions and attached assistant IDs.
        - `values` ActionsActionIdGetResponsesContentApplicationJsonSchemaResponseActionsItemsInputVariablesValuesItems[] — Variables that the action expects as runtime input.
          - `name` string
          - `type` 'string' | 'integer' | 'number' | 'boolean'
          - `description` string
          - `example` union
            - string
            - number, double
            - boolean
        - `assistants` ActionsActionIdGetResponsesContentApplicationJsonSchemaResponseActionsItemsInputVariablesAssistantsItems[] — Assistants attached to this action, including per-assistant input variable mappings.
          - `model_id` string
          - `attachment_type` 'before' | 'during' | 'after'
          - `input_variables_mapping` ActionsActionIdGetResponsesContentApplicationJsonSchemaResponseActionsItemsInputVariablesAssistantsItemsInputVariablesMappingItems[]
            - `variable_name` string
            - `source` 'hardcoded' | 'llm' | 'system_vars' | 'prompt_variables' | 'fsm_variables' | 'action_results'
            - `hardcoded_value` string
            - `llm_config` ActionsActionIdGetResponsesContentApplicationJsonSchemaResponseActionsItemsInputVariablesAssistantsItemsInputVariablesMappingItemsLlmConfig
              - …
      - `parameters_hard_coded` ActionsActionIdGetResponsesContentApplicationJsonSchemaResponseActionsItemsParametersHardCoded
        - `sms_message_text` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/synthflow/apis/platform-api.md) · [All operations](https://skmtc.net/synthflow/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/synthflow/platform-api/versions/decb652b52e0/schema)