---
title: "Retrieve automation by id"
url: "https://earlyaccess.developers.bynder.com/apis/automations-api-1/versions/c7c13882-9e51-4554-bcb8-9517eda44741/operations/getApi1AutomationAutomationsAutomationid"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/automations-api-1/versions/c7c13882-9e51-4554-bcb8-9517eda44741.md

# Retrieve automation by id

`GET` `/api/1/automation/automations/{automationId}`

Operation ID: `getApi1AutomationAutomationsAutomationid`

Retrieve a single automation by its unique id.

## Path parameters

- `automationId` (string, uuid, required)

## Header parameters

- `x-api-correlation-id` (string, optional)

## Responses

- `200`
- `401`
- `404`

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Automations API
  version: "1.0"
servers:
  - url: https://{your-bynder-domain}/
paths:
  /api/1/automation/automations/{automationId}:
    get:
      description: Retrieve a single automation by its unique id.
      operationId: getApi1AutomationAutomationsAutomationid
      parameters:
        - in: header
          name: x-api-correlation-id
          required: false
          schema:
            type: string
        - in: path
          name: automationId
          required: true
          schema:
            format: uuid
            type: string
      responses:
        "200":
          content:
            application/json:
              examples:
                AutomationExample:
                  description: "This automation describes the following: If the 'Image' option
                    from 'Asset' metaproperty is selected, then show the
                    'Marketing' option from 'Asset Sub-Type' metaproperty."
                  summary: An example of an automation response
                  value:
                    actionType: SHOW_OPTION
                    actionsOn:
                      - metapropertyId: 7bed26c4-e39d-4051-8197-69bed161bda8
                        metapropertyName: Asset Sub-Type
                        metapropertyType: single-select
                        options:
                          - optionId: 183e852d-a1b0-4f62-bfbd-2a093df03a6a
                            optionName: Marketing
                        value: ""
                    automationId: 00000000-0000-0000-0000-000000000000
                    conditionType: ANY
                    triggerType: SELECTED
                    triggersOn:
                      - metapropertyId: ccea2875-868c-4a75-9354-53150d2db055
                        metapropertyName: Asset
                        metapropertyType: single-select
                        options:
                          - optionId: 677c5b4d-1eb2-4e87-9bd8-5f2825522b3a
                            optionName: Image
                        value: ""
              schema:
                properties:
                  actionType:
                    enum:
                      - SHOW_OPTION
                      - SHOW_METAPROPERTY
                      - PREFILL
                      - EMPTY
                      - SELECT
                      - DESELECT
                    type: string
                  actionsOn:
                    items:
                      properties:
                        metapropertyId:
                          type: string
                        metapropertyName:
                          type: string
                        metapropertyType:
                          type: string
                        options:
                          items:
                            properties:
                              optionId:
                                type: string
                              optionName:
                                type: string
                            required:
                              - optionId
                              - optionName
                            type: object
                          type: array
                        value:
                          type: string
                      type: object
                    type: array
                  automationId:
                    type: string
                  conditionType:
                    enum:
                      - ALL
                      - ANY
                      - ANY_OPTION
                    type: string
                  triggerType:
                    enum:
                      - SELECTED
                    type: string
                  triggersOn:
                    items:
                      properties:
                        metapropertyId:
                          type: string
                        metapropertyName:
                          type: string
                        metapropertyType:
                          type: string
                        options:
                          items:
                            properties:
                              optionId:
                                type: string
                              optionName:
                                type: string
                            required:
                              - optionId
                              - optionName
                            type: object
                          type: array
                        value:
                          type: string
                      type: object
                    type: array
                required:
                  - automationId
                  - actionType
                  - conditionType
                  - triggerType
                type: object
          description: ""
        "401":
          content:
            application/json:
              schema:
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                required:
                  - errorCode
                  - message
                type: object
          description: ""
        "404":
          content:
            application/json:
              examples:
                AutomationNotFoundOutput:
                  summary: Response when automation was not found
                  value:
                    errorCode: automation-not-found
                    message: The automation was not found
              schema:
                properties:
                  errorCode:
                    type: string
                  message:
                    type: string
                required:
                  - errorCode
                  - message
                type: object
          description: ""
      security:
        - httpAuth: []
      summary: Retrieve automation by id
      tags:
        - Automations - New taxonomy API
security:
  - httpAuth: []
components:
  securitySchemes:
    httpAuth:
      scheme: bearer
      type: http
```