---
title: "Send a queue message"
method: POST
path: "/gateway/{actor}/queue/{name}"
---

# Send a queue message

`POST /gateway/{actor}/queue/{name}`

## Request

- The document declares no server URL.
- Auth: none declared

Enqueue a message on the actor's queue. Optionally wait for the actor to complete it and return its response.

## Path parameters

- `actor` string, required
- `name` string, required

## Query parameters

- `rvt-namespace` string
- `rvt-method` 'get' | 'getOrCreate'
- `rvt-key` string
- `rvt-pool` string
- `rvt-runner` string
- `rvt-input` string
- `rvt-region` string
- `rvt-crash-policy` 'restart' | 'sleep' | 'destroy'
- `rvt-skip-ready-wait` boolean
- `rvt-token` string

## Request body

- object
  - `body` unknown, required
  - `wait` boolean: Wait for the actor to complete the message and return its response.
  - `timeout` integer: How long to wait for completion, in milliseconds. Only used with wait.

## Response `200`

Message enqueued. When wait is true, also reports whether the actor completed it.

- object
  - `status` 'completed' | 'timedOut', required: Whether the actor completed the message before the timeout.
  - `response` unknown

## Changes

- **2026-09-29** `0130d6e7eada`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rivet-dev/apis/rivetkit-api/changes/gateway/:actor/queue/:name/post.md)

---

[API](https://skmtc.dev/rivet-dev/apis/rivetkit-api.md) - [All operations](https://skmtc.dev/rivet-dev/apis/rivetkit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rivet-dev/apis/rivetkit-api/revisions/0130d6e7eada?raw)