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

> ## Agent Instructions
> For account actions, read https://ohmyho.st/skills/ohmyhost-get-started/SKILL.md and use the authenticated ohmyho.st CLI, local product MCP or supported remote OAuth MCP. Read the current project source binding before choosing GitHub or managed versions. Mintlify search only reads documentation. Preserve the customer’s selected project, environment and authentication provider; keep private application values in the one-hour secret link or local stdin flow.

# Run a bound Make action

> Uses the action execution key as its bearer credential. Supply a stable idempotency key for each logical invocation. An uncertain result may mean that the action was dispatched; do not create a new invocation solely to retry it.



## OpenAPI

````yaml /openapi.json post /v1/make/actions/run
openapi: 3.1.2
info:
  title: ohmyho.st API
  version: 0.0.0
  description: >-
    Public REST API for ohmyho.st hosting, projects, domains, email, credits and
    exports.
servers:
  - url: https://app.ohmyho.st
    description: Production control API
  - url: https://dev.app.ohmyho.st
    description: Development control API
security:
  - BearerAuth: []
paths:
  /v1/make/actions/run:
    post:
      summary: Run a bound Make action
      description: >-
        Uses the action execution key as its bearer credential. Supply a stable
        idempotency key for each logical invocation. An uncertain result may
        mean that the action was dispatched; do not create a new invocation
        solely to retry it.
      operationId: runMakeAction
      parameters:
        - $ref: '#/components/parameters/IdempotencyKeyToken'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MakeActionRunRequest'
      responses:
        '200':
          description: The action completed, or the invocation had already completed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MakeActionRunSuccess'
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MakeActionInvalidRequest'
        '403':
          description: Execution denied or reconnection required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MakeActionDenied'
        '409':
          description: Idempotency conflict or execution still running.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MakeActionConflict'
        '429':
          description: Rate limited.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MakeActionRateLimited'
        '502':
          description: Dispatch outcome is uncertain.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MakeActionUncertain'
        '503':
          description: Execution service unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MakeActionUnavailable'
      security:
        - MakeActionBearer: []
components:
  parameters:
    IdempotencyKeyToken:
      name: Idempotency-Key
      in: header
      description: >-
        Identifies one mutation and its canonical request payload; only letters,
        digits and the characters . _ : - are accepted.
      required: true
      schema:
        type: string
        minLength: 1
        maxLength: 128
        pattern: ^[A-Za-z0-9._:-]+$
  schemas:
    MakeActionRunRequest:
      type: object
      additionalProperties: false
      required:
        - input
      properties:
        input:
          type: object
          additionalProperties: true
    MakeActionRunSuccess:
      oneOf:
        - type: object
          additionalProperties: false
          required:
            - state
            - output
          properties:
            state:
              const: completed
            output:
              description: Bounded JSON response envelope returned by Make.
        - type: object
          additionalProperties: false
          required:
            - state
          properties:
            state:
              const: already_completed
    MakeActionInvalidRequest:
      type: object
      additionalProperties: false
      required:
        - state
      properties:
        state:
          const: invalid_request
    MakeActionDenied:
      type: object
      additionalProperties: false
      required:
        - state
      properties:
        state:
          enum:
            - denied
            - reconnect_required
    MakeActionConflict:
      type: object
      additionalProperties: false
      required:
        - state
      properties:
        state:
          enum:
            - conflict
            - running
    MakeActionRateLimited:
      type: object
      additionalProperties: false
      required:
        - state
      properties:
        state:
          const: rate_limited
    MakeActionUncertain:
      type: object
      additionalProperties: false
      required:
        - state
      properties:
        state:
          const: uncertain
    MakeActionUnavailable:
      type: object
      additionalProperties: false
      required:
        - state
      properties:
        state:
          const: unavailable
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        WorkOS access JWT or a user-owned WorkOS API key. User keys are bound to
        one organization and restricted to their enabled product permissions.
        Session-only onboarding and session revocation require an interactive
        access JWT. No cookie session is assumed.
    MakeActionBearer:
      type: http
      scheme: bearer
      description: >-
        A secret execution key scoped to one bound Make action, prefixed
        omh_make_v1.

````

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