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

# Run one workflow method

> Executes a single workflow step — the same methods an automation's steps run through, with the same scoping and bounds — without creating an automation.

The project boundary is derived from the entity the spec names (its table or document), never from the body; `projectId` is required by document.create, document.find, table.createTable, notify.inApp and notify.email, which name no existing entity to derive it from.

Structural references (`rowRef`, `documentRef`) take a bare id.



## OpenAPI

````yaml post /automation/method
openapi: 3.1.0
info:
  title: HERO API
  version: current
  description: |-
    The HERO REST API.

    See https://developers.myhero.so for the rendered docs.
servers:
  - url: https://app.myhero.so
security: []
paths:
  /automation/method:
    post:
      tags:
        - Automations
      summary: Run one workflow method
      description: >-
        Executes a single workflow step — the same methods an automation's steps
        run through, with the same scoping and bounds — without creating an
        automation.


        The project boundary is derived from the entity the spec names (its
        table or document), never from the body; `projectId` is required by
        document.create, document.find, table.createTable, notify.inApp and
        notify.email, which name no existing entity to derive it from.


        Structural references (`rowRef`, `documentRef`) take a bare id.
      operationId: executeWorkflowMethod
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                projectId:
                  type: string
                  minLength: 1
                spec:
                  oneOf:
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - table.setCell
                        tableId:
                          type: string
                          minLength: 1
                        rowRef:
                          type: string
                          minLength: 1
                        columnId:
                          type: string
                          minLength: 1
                        value:
                          type: string
                      required:
                        - kind
                        - tableId
                        - rowRef
                        - columnId
                        - value
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - table.createRow
                        tableId:
                          type: string
                          minLength: 1
                        values:
                          type: array
                          items:
                            type: object
                            properties:
                              columnId:
                                type: string
                                minLength: 1
                              value:
                                type: string
                            required:
                              - columnId
                              - value
                      required:
                        - kind
                        - tableId
                        - values
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - table.updateRows
                        tableId:
                          type: string
                          minLength: 1
                        filter:
                          type: object
                          properties:
                            conjunction:
                              type: string
                              enum:
                                - and
                                - or
                            filters:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                    default: ''
                                  columnId:
                                    type: string
                                    minLength: 1
                                  op:
                                    type: string
                                    minLength: 1
                                  value: {}
                                required:
                                  - columnId
                                  - op
                          required:
                            - conjunction
                            - filters
                        acknowledgeAll:
                          type: boolean
                          default: false
                        values:
                          type: array
                          items:
                            type: object
                            properties:
                              columnId:
                                type: string
                                minLength: 1
                              value:
                                type: string
                            required:
                              - columnId
                              - value
                      required:
                        - kind
                        - tableId
                        - filter
                        - values
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - table.findRow
                        tableId:
                          type: string
                          minLength: 1
                        filter:
                          type: object
                          properties:
                            conjunction:
                              type: string
                              enum:
                                - and
                                - or
                            filters:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                    default: ''
                                  columnId:
                                    type: string
                                    minLength: 1
                                  op:
                                    type: string
                                    minLength: 1
                                  value: {}
                                required:
                                  - columnId
                                  - op
                          required:
                            - conjunction
                            - filters
                      required:
                        - kind
                        - tableId
                        - filter
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - table.createTable
                        name:
                          type: string
                          minLength: 1
                        columns:
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                type: string
                                minLength: 1
                              dataType:
                                type: string
                                minLength: 1
                            required:
                              - name
                              - dataType
                      required:
                        - kind
                        - name
                        - columns
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - table.addColumn
                        tableId:
                          type: string
                          minLength: 1
                        name:
                          type: string
                          minLength: 1
                        dataType:
                          type: string
                          minLength: 1
                      required:
                        - kind
                        - tableId
                        - name
                        - dataType
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - table.deleteRow
                        tableId:
                          type: string
                          minLength: 1
                        rowRef:
                          type: string
                          minLength: 1
                      required:
                        - kind
                        - tableId
                        - rowRef
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - table.deleteRows
                        tableId:
                          type: string
                          minLength: 1
                        filter:
                          type: object
                          properties:
                            conjunction:
                              type: string
                              enum:
                                - and
                                - or
                            filters:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                    default: ''
                                  columnId:
                                    type: string
                                    minLength: 1
                                  op:
                                    type: string
                                    minLength: 1
                                  value: {}
                                required:
                                  - columnId
                                  - op
                          required:
                            - conjunction
                            - filters
                        acknowledgeAll:
                          type: boolean
                          default: false
                      required:
                        - kind
                        - tableId
                        - filter
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - table.updateColumn
                        tableId:
                          type: string
                          minLength: 1
                        columnId:
                          type: string
                          minLength: 1
                        name:
                          type: string
                        dataType:
                          type: string
                      required:
                        - kind
                        - tableId
                        - columnId
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - document.create
                        projectId:
                          type: string
                        parentId:
                          type:
                            - string
                            - 'null'
                          default: null
                        name:
                          type: string
                          minLength: 1
                        docType:
                          type: string
                          enum:
                            - FILE
                            - FOLDER
                      required:
                        - kind
                        - name
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - document.delete
                        documentRef:
                          type: string
                          minLength: 1
                      required:
                        - kind
                        - documentRef
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - document.duplicate
                        documentRef:
                          type: string
                          minLength: 1
                        parentId:
                          type:
                            - string
                            - 'null'
                        rename:
                          type: object
                          properties:
                            from:
                              type: string
                            to:
                              type: string
                          required:
                            - to
                      required:
                        - kind
                        - documentRef
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - document.find
                        parentRef:
                          type: string
                        field:
                          type: string
                          enum:
                            - reference
                            - name
                        op:
                          type: string
                          enum:
                            - is
                            - contains
                        value:
                          type: string
                      required:
                        - kind
                        - field
                        - op
                        - value
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - document.move
                        documentRef:
                          type: string
                          minLength: 1
                        parentId:
                          type:
                            - string
                            - 'null'
                      required:
                        - kind
                        - documentRef
                        - parentId
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - document.publish
                        documentRef:
                          type: string
                          minLength: 1
                        published:
                          type: boolean
                      required:
                        - kind
                        - documentRef
                        - published
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - document.rename
                        documentRef:
                          type: string
                          minLength: 1
                        name:
                          type: string
                          minLength: 1
                      required:
                        - kind
                        - documentRef
                        - name
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - document.setIcon
                        documentRef:
                          type: string
                          minLength: 1
                        icon:
                          type:
                            - object
                            - 'null'
                          properties:
                            name:
                              type: string
                              minLength: 1
                            color:
                              type: string
                          required:
                            - name
                            - color
                      required:
                        - kind
                        - documentRef
                        - icon
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - document.setReference
                        documentRef:
                          type: string
                          minLength: 1
                        reference:
                          type: string
                      required:
                        - kind
                        - documentRef
                        - reference
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - notify.inApp
                        recipients:
                          type: array
                          items:
                            type: string
                            minLength: 1
                          minItems: 1
                        title:
                          type: string
                          minLength: 1
                        body:
                          type: string
                      required:
                        - kind
                        - recipients
                        - title
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - notify.email
                        provider:
                          type: string
                          enum:
                            - gmail
                            - outlook
                        recipients:
                          type: array
                          items:
                            type: string
                            minLength: 1
                          minItems: 1
                        subject:
                          type: string
                          minLength: 1
                        body:
                          type: string
                      required:
                        - kind
                        - recipients
                        - subject
                    - type: object
                      properties:
                        kind:
                          type: string
                          enum:
                            - signature.request
                        documentRef:
                          type: string
                          minLength: 1
                        signerEmail:
                          type: string
                          format: email
                        signerName:
                          type: string
                        message:
                          type: string
                        signatureBlock:
                          type: string
                          enum:
                            - last
                            - first
                            - all
                      required:
                        - kind
                        - documentRef
                        - signerEmail
              required:
                - spec
      responses:
        '200':
          description: 200 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      output:
                        type: object
                        additionalProperties:
                          type: string
                      tombstones:
                        type: array
                        items:
                          type: object
                          properties:
                            action:
                              type: string
                            detail:
                              type: string
                          required:
                            - action
                            - detail
                    required:
                      - output
                      - tombstones
                required:
                  - data
        '400':
          description: 400 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: |-
                      Error class name (e.g.

                      ValidationError, NotFound)
                  message:
                    type: string
                    description: Human-readable error message
                  details:
                    type: array
                    items: {}
                required:
                  - error
                  - message
        '403':
          description: 403 response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: |-
                      Error class name (e.g.

                      ValidationError, NotFound)
                  message:
                    type: string
                    description: Human-readable error message
                  details:
                    type: array
                    items: {}
                required:
                  - error
                  - message
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: HERO personal access token

````

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