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

# Run an Act turn



## OpenAPI

````yaml /openapi/overlay-web.openapi.json post /api/v1/conversations/act
openapi: 3.0.3
info:
  title: Overlay Web API
  version: 1.0.0
  description: >-
    Generated from the overlay-web route boundary registry. This first-pass
    reference documents stable route inventory and request shapes.
servers:
  - url: https://overlay.works
    description: Hosted Overlay web app
  - url: http://localhost:3000
    description: Local development web app
security: []
tags:
  - name: Account
  - name: Agents
  - name: Automations
  - name: Billing
  - name: Bootstrap
  - name: Computers
  - name: Conversations
  - name: Files
  - name: Integrations
  - name: Knowledge
  - name: MCP Servers
  - name: Media
  - name: Memory
  - name: Model Providers
  - name: Models
  - name: Notes
  - name: Outputs
  - name: Settings
  - name: Skills
  - name: Webhooks
  - name: Workspaces
paths:
  /api/v1/conversations/act:
    post:
      tags:
        - Conversations
      summary: Run an Act turn
      operationId: postConversationsAct
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                accessToken:
                  type: string
                  minLength: 1
                userId:
                  type: string
                  minLength: 1
                conversationId:
                  type: string
                conversationClientId:
                  type: string
                  minLength: 1
                scope:
                  type: string
                  enum:
                    - personal
                    - workspace
                askModelIds:
                  type: array
                  items:
                    type: string
                messages:
                  type: array
                  items: {}
                prompt:
                  type: string
                systemPrompt:
                  type: string
                turnId:
                  type: string
                modelId:
                  type: string
                  minLength: 1
                  maxLength: 160
                indexedFileNames:
                  type: array
                  items:
                    type: string
                indexedAttachments: {}
                attachmentNames:
                  type: array
                  items:
                    type: string
                replyContextForModel:
                  type: string
                historyBaseModelId:
                  type: string
                mode:
                  type: string
                  enum:
                    - chat
                    - automate
                personalChatMode:
                  type: string
                  enum:
                    - chat
                    - work
                  description: >-
                    Deprecated compatibility field. Accepted but ignored;
                    personal chat execution is selected by backend capability.
                automationMode:
                  type: boolean
                automationExecution:
                  type: boolean
                automationId:
                  type: string
                automationName:
                  type: string
                  maxLength: 200
                mediaToolIntent:
                  type: string
                  enum:
                    - image
                    - video
                  nullable: true
                requestedToolIds: {}
                memoryEnabled:
                  type: boolean
                notebookNoteId:
                  type: string
                  minLength: 1
                  maxLength: 64
                  description: >-
                    The note open in the Notebook editor. The turn runs as a
                    normal personal chat with that note as its subject and note
                    editing tools available.
                actAbortTimeoutMs:
                  type: number
                  exclusiveMinimum: true
                  minimum: 0
                harnessBudget:
                  type: object
                  properties:
                    durationMs:
                      type: integer
                      minimum: 30000
                  additionalProperties: false
                mentions:
                  type: array
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      id:
                        type: string
                      name:
                        type: string
                      fileIds:
                        type: array
                        items:
                          type: string
                    required:
                      - type
                      - id
                      - name
                    additionalProperties: false
                reasoning:
                  type: string
                  enum:
                    - provider-default
                    - none
                    - minimal
                    - low
                    - medium
                    - high
                    - xhigh
                liveTransport:
                  type: string
                  enum:
                    - convex
                  description: >-
                    The client reads the live reply from Convex. An admitted
                    durable run then answers right after admission with its run
                    identity and source metadata instead of relaying the reply
                    over this response.
              additionalProperties: true
      responses:
        '200':
          description: >-
            Successful response. Stable response schemas are documented in
            workflow guides when available.
          content:
            application/json:
              schema:
                description: >-
                  Response shape is route-specific and may be backed by
                  @overlay/app-core contracts.
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Missing or invalid authentication.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Unexpected server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - browserSession: []
        - bearerAuth: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        code:
          type: string
      additionalProperties: true
  securitySchemes:
    browserSession:
      type: apiKey
      in: cookie
      name: overlay_session
      description: Signed httpOnly browser session cookie.
    bearerAuth:
      type: http
      scheme: bearer
      description: WorkOS bearer access token for native or service clients.

````

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