---
title: "POST /simulate/api/harness/conversations/{id}/events/"
method: POST
path: "/simulate/api/harness/conversations/{id}/events/"
tags: ["simulate"]
---

# POST /simulate/api/harness/conversations/{id}/events/

`POST /simulate/api/harness/conversations/{id}/events/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/simulate/api/harness/conversations/{id}/events/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

## Request body

- HarnessConversationEventBatch
  - `schema_version` 'futureagi.harness-conversation-event.v1', required
  - `acknowledged_through` integer, required
  - `events` HarnessConversationEvent[], required
    - `schema_version` 'futureagi.harness-conversation-event.v1', required
    - `event_id` string, required
    - `conversation_id` string, uuid, required
    - `sequence` integer, required
    - `kind` 'turn_started' | 'assistant_delta' | 'assistant_message' | 'stage_changed' | 'authoring_activity' | 'tool_started' | 'tool_result' | 'question_requested' | 'confirmation_requested' | 'turn_interrupted' | 'turn_completed' | 'checkpoint_committed' | 'capability_changed', required
    - `message_id` string, uuid, nullable
    - `stage` string
    - `invocation_id` string, nullable
    - `function_call_id` string, nullable
    - `emitted_at` string, date-time, required
    - `payload` object, required
    - `digest` string, required

## Response `200`

OK

- HarnessConversationEventAck
  - `acked_through_sequence` integer, required

## Other responses

- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)
