---
title: "Ask"
method: POST
path: "/workspaces/{workspace_id}/copilot"
tags: ["copilot"]
---

# Ask

`POST /workspaces/{workspace_id}/copilot`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/workspaces/{workspace_id}/copilot`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Path parameters

- `workspace_id` string, uuid, required

## Request body

- TurnIn
  - `question` string, nullable
  - `conversation_id` string, uuid, nullable
  - `approvals` object

## Response `200`

Successful Response

- TurnOut
  - `id` string, uuid, required
  - `run_id` string, uuid, required
  - `conversation_id` string, uuid, required
  - `status` 'answered' | 'awaiting_approval' | 'step_limit' | 'switched_off' | 'upstream_error' | 'refused' | 'cancelled' | 'budget' | 'interrupted', required
  - `answer` string, nullable, required
  - `evidence` CopilotEvidence[], required
    - `label` string, required
    - `arguments` object, required
    - `ids` string[], required
  - `proposals` union[], required
    - union
      - CopilotProposal
        - `kind` 'training_run', required
        - `reason` string, required
        - `input` object, required
        - `quote` object, required
        - `proposal_id` string, uuid, nullable
        - `plan_sha256` string, nullable
        - `max_usd` string, nullable
        - `expires_at` string, nullable
      - CopilotPipelineProposal
        - `kind` 'pipeline_change', required
        - `id` string, uuid, required
        - `sha256` string, required
        - `diff` object[], required
        - `rationale` string, required
  - `ungrounded_ids` string[], required
  - `web` CopilotWeb[], required
    - `step` integer, required
    - `tool` 'web_search' | 'web_fetch', required
    - `query` string, nullable
    - `url` string, nullable
    - `urls` string[], nullable
    - `error` string, nullable
    - `retrieved_at` string, nullable
  - `memory` CopilotMemoryWrite[], required
    - `scope` 'user' | 'workspace', required
    - `action` 'write' | 'delete', required
    - `file` string, required
    - `content` string, nullable, required
  - `approvals` CopilotApproval[], required
    - `tool_call_id` string, required
    - `kind` 'memory' | 'dataset_version' | 'big_box' | 'training_run', required
    - `scope` 'user' | 'workspace', nullable, required
    - `action` 'write' | 'delete', nullable, required
    - `arguments` object, required
  - `cost_usd` string, required
  - `model` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/os3robotics/apis/os3-api.md) - [All operations](https://skmtc.dev/os3robotics/apis/os3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/os3robotics/apis/os3-api/revisions/af32cd4f14bb?raw)