---
title: "Post Run Message"
method: POST
path: "/v2/runs/{run_id}/messages"
tags: ["Runs"]
---

# Post Run Message

`POST /v2/runs/{run_id}/messages`

Post a message to an agent run. This will persist the message and resume the agent execution if the run is in a resumable state (waiting, completed, or interrupted).

## Path parameters

- `run_id` string, uuid, required

## Request body

- object
  - `message` string, required — The message content to send to the agent

## Response `201`

Default Response

- object
  - `message` object, required — The message that was posted to the run
    - `id` string, required — Unique message identifier
    - `type` string, required — Message type
    - `role` string, required — Sender role
    - `timestamp` string, required — ISO 8601 timestamp when the message was posted
    - `text_content` string, required — Plain text content of the message

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `500` — Default Response

---

[API](https://skmtc.net/duvo/apis/duvo-public-api.md) · [All operations](https://skmtc.net/duvo/apis/duvo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/duvo/duvo-public-api/revisions/dafcf3d868a9/schema)