---
title: "POST /gateway/{actorId}/action/{action}"
method: POST
path: "/gateway/{actorId}/action/{action}"
---

# POST /gateway/{actorId}/action/{action}

`POST /gateway/{actorId}/action/{action}`

## Path parameters

- `actorId` string, required
- `action` string, required

## Request body

- object
  - `args` unknown, required

## Response `200`

Action executed successfully

- object
  - `output` unknown, required

## Other responses

- `400` — Invalid action
- `500` — Internal error

## Changes

- **2025-12-10** `c4371c5b7547` — 1 breaking, 1 info
  - the request property `args` became required
  - the response property `output` became required for the status `200`
- **2025-11-24** `8237387a39bd` — 1 info
  - endpoint added
- **2025-11-21** `1c4f6043d78a` — 1 breaking
  - api path removed without deprecation
- **2025-11-13** `bcbdc8594db6` — 1 info
  - endpoint added
- **2025-10-22** `debdae6b1f30` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/rivet-dev/apis/rivetkit-api/changes/gateway/:actorId/action/:action/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-service-production.skmtc.workers.dev/v1/apis/rivet-dev/rivetkit-api/revisions/987a66002b58/schema)
