---
title: "Run an Act turn"
method: POST
path: "/api/v1/conversations/act"
tags: ["Conversations"]
---

# Run an Act turn

`POST /api/v1/conversations/act`

## Request body

- object
  - `accessToken` string
  - `userId` string
  - `conversationId` string
  - `conversationClientId` string
  - `projectId` string
  - `askModelIds` string[]
  - `messages` unknown[]
    - unknown
  - `prompt` string
  - `systemPrompt` string
  - `turnId` string
  - `modelId` string
  - `indexedFileNames` string[]
  - `indexedAttachments` unknown
  - `attachmentNames` string[]
  - `replyContextForModel` string
  - `historyBaseModelId` string
  - `mode` 'chat' | 'automate'
  - `personalChatMode` 'chat' | 'work'
  - `automationMode` boolean
  - `automationExecution` boolean
  - `automationId` string
  - `mediaToolIntent` 'image' | 'video', nullable
  - `requestedToolIds` unknown
  - `memoryEnabled` boolean
  - `actAbortTimeoutMs` number
  - `mentions` object[]
    - `type` string, required
    - `id` string, required
    - `name` string, required
    - `fileIds` string[]
  - `multiModelSlotIndex` integer
  - `multiModelTotal` integer
  - `reasoning` 'provider-default' | 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh'

## Response `200`

Successful response. Stable response schemas are documented in workflow guides when available.

- unknown

## Other responses

- `400` — Invalid request.
- `401` — Missing or invalid authentication.
- `500` — Unexpected server error.

---

[API](https://skmtc.dev/layernorm/apis/overlay-web-api.md) · [All operations](https://skmtc.dev/layernorm/apis/overlay-web-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/layernorm/overlay-web-api/revisions/a64546f5bde3/schema)