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

# List automations

> Lists automations, most recently changed first, with each one's last run.



## OpenAPI

````yaml /api-reference/openapi.json get /automations
openapi: 3.1.0
info:
  description: >-
    Manage a Superlog workspace's automations, runs, tag mode, model access, and
    secrets. Every request acts as the member who created the API key.
  title: Superlog management API
  version: 1.0.0
servers:
  - url: https://superlog.sh/api/v1
security:
  - bearerAuth: []
tags:
  - description: The workspace and its members.
    name: Workspace
  - description: Keys that authenticate the management API and MCP server.
    name: API keys
  - description: Connected integrations and the IDs automations and tag mode use.
    name: Integrations
  - description: Create and change automations.
    name: Automations
  - description: Start, follow, and cancel automation runs.
    name: Runs
  - description: What Superlog can use and change when someone mentions it in Slack.
    name: Tag mode
  - description: Model API keys, subscriptions, and available models.
    name: Models
  - description: Credentials agents can use without seeing them.
    name: Secrets
paths:
  /automations:
    get:
      tags:
        - Automations
      summary: List automations
      description: >-
        Lists automations, most recently changed first, with each one's last
        run.
      operationId: list_automations
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  automations:
                    type: array
                    items:
                      type: object
                      properties:
                        connectors:
                          type: array
                          items:
                            type: string
                          description: >-
                            Providers the automation uses, such as `github` and
                            `sentry`.
                        createdAt:
                          type: string
                          format: date-time
                          description: When the automation was created.
                        description:
                          type: string
                        enabled:
                          type: boolean
                        harness:
                          type: string
                          enum:
                            - codex
                            - claude_agent_sdk
                            - opencode
                        id:
                          type: string
                          format: uuid
                          description: Automation ID.
                        lastRun:
                          anyOf:
                            - type: object
                              properties:
                                createdAt:
                                  type: string
                                  format: date-time
                                  description: When the run was created.
                                status:
                                  type: string
                                  enum:
                                    - pending
                                    - running
                                    - succeeded
                                    - failed
                                    - cancelled
                              required:
                                - createdAt
                                - status
                              additionalProperties: false
                            - type: 'null'
                        model:
                          type: string
                        modelProvider:
                          type: string
                          enum:
                            - openai
                            - anthropic
                            - google
                            - xai
                            - mistral
                            - deepseek
                        name:
                          type: string
                        triggers:
                          type: array
                          items:
                            oneOf:
                              - type: object
                                properties:
                                  channelIds:
                                    minItems: 1
                                    maxItems: 50
                                    type: array
                                    items:
                                      type: string
                                      minLength: 1
                                      maxLength: 255
                                    description: Slack channel IDs, such as C0123456789.
                                  eventMode:
                                    type: string
                                    enum:
                                      - mentions
                                      - every_message
                                      - both
                                    description: >-
                                      Run when the app is mentioned, on every
                                      new message, or both.
                                  integrationAccountId:
                                    type: string
                                    format: uuid
                                  kind:
                                    type: string
                                    const: slack
                                required:
                                  - channelIds
                                  - eventMode
                                  - integrationAccountId
                                  - kind
                                additionalProperties: false
                                description: >-
                                  Runs on Slack messages in the selected
                                  channels.
                              - type: object
                                properties:
                                  eventTypes:
                                    minItems: 1
                                    maxItems: 2
                                    type: array
                                    items:
                                      type: string
                                      enum:
                                        - new_issue
                                        - regression
                                    description: Run on new issues, regressions, or both.
                                  excludedEnvironments:
                                    description: >-
                                      Issues from these environments do not
                                      start a run.
                                    maxItems: 100
                                    type: array
                                    items:
                                      type: string
                                      minLength: 1
                                      maxLength: 64
                                  integrationAccountId:
                                    type: string
                                    format: uuid
                                  kind:
                                    type: string
                                    const: sentry
                                  projectIds:
                                    minItems: 1
                                    maxItems: 100
                                    type: array
                                    items:
                                      type: string
                                      minLength: 1
                                      maxLength: 255
                                    description: Sentry project IDs.
                                required:
                                  - eventTypes
                                  - integrationAccountId
                                  - kind
                                  - projectIds
                                additionalProperties: false
                                description: >-
                                  Runs on new or regressed Sentry issues in the
                                  selected projects.
                              - type: object
                                properties:
                                  channelIds:
                                    minItems: 1
                                    maxItems: 50
                                    type: array
                                    items:
                                      type: string
                                      minLength: 1
                                      maxLength: 255
                                    description: Discord channel IDs.
                                  integrationAccountId:
                                    type: string
                                    format: uuid
                                  kind:
                                    type: string
                                    const: discord
                                required:
                                  - channelIds
                                  - integrationAccountId
                                  - kind
                                additionalProperties: false
                                description: >-
                                  Runs when someone uses `/automate` in the
                                  selected Discord channels.
                              - type: object
                                properties:
                                  frequency:
                                    type: string
                                    enum:
                                      - hourly
                                      - daily
                                      - weekly
                                  hour:
                                    type: integer
                                    minimum: 0
                                    maximum: 23
                                    description: >-
                                      Local hour for daily and weekly runs, 0 to
                                      23.
                                  kind:
                                    type: string
                                    const: schedule
                                  timezone:
                                    type: string
                                    minLength: 1
                                    maxLength: 64
                                    description: IANA time zone, such as Europe/Paris.
                                  weekday:
                                    type: integer
                                    minimum: 0
                                    maximum: 6
                                    description: Local day for weekly runs. 0 is Sunday.
                                required:
                                  - frequency
                                  - hour
                                  - kind
                                  - timezone
                                  - weekday
                                additionalProperties: false
                                description: >-
                                  Runs on the hour, or at a local time each day
                                  or week.
                        updatedAt:
                          type: string
                          format: date-time
                          description: When the automation was last changed.
                        version:
                          type: integer
                          description: Increases each time the configuration is saved.
                      required:
                        - connectors
                        - createdAt
                        - description
                        - enabled
                        - harness
                        - id
                        - lastRun
                        - model
                        - modelProvider
                        - name
                        - triggers
                        - updatedAt
                        - version
                      additionalProperties: false
                required:
                  - automations
                additionalProperties: false
          description: OK
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: The API key is missing, revoked, or its creator left the workspace.
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            The resource does not exist in this workspace, or automations are
            not enabled.
      security:
        - bearerAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        code:
          description: A stable machine-readable error code, when there is one.
          type: string
        error:
          type: string
          description: What went wrong.
        issues:
          description: Validation problems, one per invalid field.
          type: array
          items:
            type: object
            properties:
              message:
                type: string
              path:
                type: array
                items:
                  anyOf:
                    - type: string
                    - type: number
            required:
              - message
              - path
            additionalProperties: false
      required:
        - error
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      description: A workspace API key, created in Superlog under Settings → API keys.
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.