> ## Documentation Index > Fetch the complete documentation index at: https://docs.worksong.ai/llms.txt > Use this file to discover all available pages before exploring further. # POST /api/conversations/{conversationId}/queue/{itemId}/steer > "Send now": hand the message to the running turn. ## OpenAPI ````yaml /api/worksong.openapi.json post /api/conversations/{conversationId}/queue/{itemId}/steer openapi: 3.1.0 info: title: Worksong API version: 042e65d5f227 description: >- The HTTP API behind the Worksong apps, generated from the code at the commit below. Request and response shapes come from the shared zod contract; an operation marked `x-gaps` has a part the generator could not resolve. x-source: worksong-ai/worksong@042e65d5f2275493f60f879c7970dcfdeceb7e0e servers: - url: https://app.worksong.ai security: - bearerAuth: [] tags: - name: Approvals - name: Audit - name: Avatar generator - name: Bootstrap - name: Bot compute limit - name: Bot mcp servers - name: Bots - name: Calls - name: Connections - name: Contacts - name: Conversations - name: Coupons - name: Day grants - name: Desktop - name: Entity files - name: Files - name: Github - name: Insights - name: Login - name: Mcp servers - name: Me - name: Me bot messaging - name: Me chat header - name: Me daily limit - name: Me time zone - name: Memory - name: Message delete - name: Messages - name: Notifications - name: Optimize prompt - name: Phone - name: Places - name: Projects - name: Public file links - name: Push - name: Queue - name: Reactions - name: Register - name: Rooms - name: Routes - name: Routines - name: Runs - name: Skills - name: Tasks - name: Transcribe - name: Tts - name: Webhooks - name: Whats new - name: Whatsapp - name: Workspace files paths: /api/conversations/{conversationId}/queue/{itemId}/steer: post: tags: - Queue summary: POST /api/conversations/{conversationId}/queue/{itemId}/steer description: '"Send now": hand the message to the running turn.' operationId: post_api_conversations_conversationId_queue_itemId_steer parameters: - name: conversationId in: path required: true schema: type: string - name: itemId in: path required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: object properties: delivered: type: string enum: - steered - queued queue: type: object properties: items: type: array items: type: object properties: id: type: string format: uuid conversationId: type: string format: uuid text: type: string status: type: string enum: - queued - paused createdAt: type: string format: date-time attachments: maxItems: 8 type: array items: type: object properties: name: type: string minLength: 1 maxLength: 255 mediaType: type: string minLength: 1 maxLength: 128 sizeBytes: type: integer minimum: 0 maximum: 9007199254740991 url: type: string minLength: 1 maxLength: 2048 file: type: object properties: id: type: string format: uuid filename: type: string minLength: 1 maxLength: 255 mimeType: type: string minLength: 1 maxLength: 128 byteSize: type: integer minimum: 0 maximum: 9007199254740991 available: type: boolean createdAt: type: string format: date-time origin: default: upload type: string enum: - upload - agent sha256: default: null anyOf: - type: string pattern: ^[0-9a-f]{64}$ - type: 'null' required: - id - filename - mimeType - byteSize - available - createdAt - origin - sha256 additionalProperties: false required: - name - mediaType - sizeBytes - url additionalProperties: false required: - id - conversationId - text - status - createdAt additionalProperties: false paused: type: boolean max: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 canSteer: type: boolean required: - items - paused - max additionalProperties: false entry: oneOf: - type: object properties: id: type: string format: uuid conversationId: type: string format: uuid seq: type: integer minimum: 0 maximum: 9007199254740991 runId: anyOf: - type: string format: uuid - type: 'null' createdAt: type: string format: date-time reactions: type: array items: type: object properties: emoji: type: string minLength: 1 maxLength: 32 count: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 mine: type: boolean required: - emoji - count - mine additionalProperties: false kind: type: string const: user payload: type: object properties: text: type: string maxLength: 1000000 attachments: default: [] maxItems: 16 type: array items: type: object properties: name: type: string minLength: 1 maxLength: 255 mediaType: type: string minLength: 1 maxLength: 128 sizeBytes: type: integer minimum: 0 maximum: 9007199254740991 url: type: string minLength: 1 maxLength: 2048 file: type: object properties: id: type: string format: uuid filename: type: string minLength: 1 maxLength: 255 mimeType: type: string minLength: 1 maxLength: 128 byteSize: type: integer minimum: 0 maximum: 9007199254740991 available: type: boolean createdAt: type: string format: date-time origin: default: upload type: string enum: - upload - agent sha256: default: null anyOf: - type: string pattern: ^[0-9a-f]{64}$ - type: 'null' required: - id - filename - mimeType - byteSize - available - createdAt - origin - sha256 additionalProperties: false required: - name - mediaType - sizeBytes - url additionalProperties: false fromBotId: default: null anyOf: - type: string format: uuid - type: 'null' location: type: object properties: latitude: type: number minimum: -90 maximum: 90 longitude: type: number minimum: -180 maximum: 180 accuracyMeters: type: number minimum: 0 maximum: 1000000 precision: type: string enum: - precise - approximate capturedAt: type: string format: date-time placeName: type: string minLength: 1 maxLength: 200 required: - latitude - longitude - accuracyMeters - precision - capturedAt additionalProperties: false replyTo: type: object properties: seq: type: integer minimum: 0 maximum: 9007199254740991 required: - seq additionalProperties: false taskBrief: type: object properties: taskId: type: string format: uuid reason: type: string enum: - assigned - created - resume - recovery - changes_requested title: type: string minLength: 1 maxLength: 200 number: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 required: - taskId - reason additionalProperties: false voiceCallId: type: string format: uuid quickReplyAnswer: type: object properties: seq: type: integer minimum: 0 maximum: 9007199254740991 index: type: integer minimum: 0 maximum: 3 indices: minItems: 1 maxItems: 4 type: array items: type: integer minimum: 0 maximum: 3 required: - seq - index additionalProperties: false steered: type: boolean required: - text - attachments - fromBotId additionalProperties: false required: - id - conversationId - seq - runId - createdAt - kind - payload additionalProperties: false - type: object properties: id: type: string format: uuid conversationId: type: string format: uuid seq: type: integer minimum: 0 maximum: 9007199254740991 runId: anyOf: - type: string format: uuid - type: 'null' createdAt: type: string format: date-time reactions: type: array items: type: object properties: emoji: type: string minLength: 1 maxLength: 32 count: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 mine: type: boolean required: - emoji - count - mine additionalProperties: false kind: type: string const: assistant payload: type: object properties: phoneCall: anyOf: - type: object properties: callId: type: string minLength: 1 maxLength: 64 status: type: string maxLength: 40 calleeName: type: string maxLength: 200 test: type: boolean required: - callId - status additionalProperties: false - type: 'null' text: type: string maxLength: 1000000 thinking: default: null anyOf: - type: string maxLength: 1000000 - type: 'null' model: default: null anyOf: - type: string minLength: 1 maxLength: 128 pattern: ^[A-Za-z0-9._@:/-]+$ - type: 'null' complete: default: true type: boolean artifacts: default: [] maxItems: 16 type: array items: type: object properties: id: type: string format: uuid filename: type: string minLength: 1 maxLength: 255 mimeType: type: string minLength: 1 maxLength: 128 byteSize: type: integer minimum: 0 maximum: 9007199254740991 available: type: boolean createdAt: type: string format: date-time required: - id - filename - mimeType - byteSize - available - createdAt additionalProperties: false quickReplies: type: object properties: question: type: string maxLength: 100000 options: maxItems: 50 type: array items: type: string maxLength: 1000 expiresAt: type: string format: date-time mode: type: string enum: - single - multi min: type: integer minimum: 1 maximum: 1000 max: type: integer minimum: 1 maximum: 1000 required: - question - options - expiresAt additionalProperties: false interrupted: type: boolean const: true required: - text - thinking - model - complete - artifacts additionalProperties: false required: - id - conversationId - seq - runId - createdAt - kind - payload additionalProperties: false - type: object properties: id: type: string format: uuid conversationId: type: string format: uuid seq: type: integer minimum: 0 maximum: 9007199254740991 runId: anyOf: - type: string format: uuid - type: 'null' createdAt: type: string format: date-time reactions: type: array items: type: object properties: emoji: type: string minLength: 1 maxLength: 32 count: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 mine: type: boolean required: - emoji - count - mine additionalProperties: false kind: type: string const: tool-call payload: type: object properties: toolUseId: type: string minLength: 1 maxLength: 200 name: type: string minLength: 1 maxLength: 128 input: {} required: - toolUseId - name - input additionalProperties: false required: - id - conversationId - seq - runId - createdAt - kind - payload additionalProperties: false - type: object properties: id: type: string format: uuid conversationId: type: string format: uuid seq: type: integer minimum: 0 maximum: 9007199254740991 runId: anyOf: - type: string format: uuid - type: 'null' createdAt: type: string format: date-time reactions: type: array items: type: object properties: emoji: type: string minLength: 1 maxLength: 32 count: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 mine: type: boolean required: - emoji - count - mine additionalProperties: false kind: type: string const: tool-result payload: type: object properties: toolUseId: type: string minLength: 1 maxLength: 200 isError: type: boolean content: {} required: - toolUseId - isError - content additionalProperties: false required: - id - conversationId - seq - runId - createdAt - kind - payload additionalProperties: false - type: object properties: id: type: string format: uuid conversationId: type: string format: uuid seq: type: integer minimum: 0 maximum: 9007199254740991 runId: anyOf: - type: string format: uuid - type: 'null' createdAt: type: string format: date-time reactions: type: array items: type: object properties: emoji: type: string minLength: 1 maxLength: 32 count: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 mine: type: boolean required: - emoji - count - mine additionalProperties: false kind: type: string const: system payload: type: object properties: text: type: string maxLength: 20000 level: type: string enum: - info - warn - error voiceCallId: type: string format: uuid voiceCallEnded: type: boolean const: true hop: anyOf: - type: object properties: direction: type: string enum: - out - in - thread peerBotId: type: string format: uuid peerName: type: string minLength: 1 maxLength: 80 conversationId: type: string format: uuid ownerBotId: type: string format: uuid messageCount: type: integer minimum: 0 maximum: 9007199254740991 text: type: string minLength: 1 maxLength: 100000 sentCount: type: integer minimum: 0 maximum: 9007199254740991 receivedCount: type: integer minimum: 0 maximum: 9007199254740991 required: - direction - peerBotId - peerName - conversationId - ownerBotId additionalProperties: false - type: 'null' whatsapp: anyOf: - type: object properties: direction: type: string enum: - out - in botId: type: string format: uuid chatJid: type: string maxLength: 128 pattern: >- ^[0-9A-Za-z._:-]{1,100}@(s\.whatsapp\.net|g\.us|lid)$ peerName: type: string minLength: 1 maxLength: 80 isGroup: default: false type: boolean text: type: string minLength: 1 maxLength: 20000 sentCount: type: integer minimum: 0 maximum: 9007199254740991 receivedCount: type: integer minimum: 0 maximum: 9007199254740991 required: - direction - botId - chatJid - peerName - isGroup additionalProperties: false - type: 'null' task: anyOf: - type: object properties: taskId: type: string format: uuid title: type: string minLength: 1 maxLength: 200 status: type: string enum: - pending - queued - in_progress - waiting - blocked - resuming - completed - failed - cancelled number: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 required: - taskId - title - status additionalProperties: false - type: 'null' connect: anyOf: - type: object properties: toolkitSlug: type: string minLength: 1 maxLength: 64 pattern: ^[a-z][a-z0-9_-]*$ toolkitName: type: string minLength: 1 maxLength: 120 reason: type: string enum: - missing - expired required: - toolkitSlug - toolkitName - reason additionalProperties: false - type: 'null' autoAllow: anyOf: - type: boolean const: true - type: 'null' approvalNote: anyOf: - type: boolean const: true - type: 'null' required: - text - level additionalProperties: false required: - id - conversationId - seq - runId - createdAt - kind - payload additionalProperties: false - type: object properties: id: type: string format: uuid conversationId: type: string format: uuid seq: type: integer minimum: 0 maximum: 9007199254740991 runId: anyOf: - type: string format: uuid - type: 'null' createdAt: type: string format: date-time reactions: type: array items: type: object properties: emoji: type: string minLength: 1 maxLength: 32 count: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 mine: type: boolean required: - emoji - count - mine additionalProperties: false kind: type: string const: automation-result payload: type: object properties: routineId: type: string format: uuid routineName: type: string minLength: 1 maxLength: 200 routineRunId: type: string format: uuid status: type: string enum: - queued - running - succeeded - failed - skipped summary: type: string maxLength: 100000 required: - routineId - routineName - routineRunId - status - summary additionalProperties: false required: - id - conversationId - seq - runId - createdAt - kind - payload additionalProperties: false required: - delivered - queue additionalProperties: false 4XX: description: Error. A problem object with a status and a message. security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.