---
title: "[Beta] Publish an event to an axon."
method: POST
path: "/v1/axons/{id}/publish"
tags: ["axons"]
---

# [Beta] Publish an event to an axon.

`POST /v1/axons/{id}/publish`

[Beta] Publish an event to a specified axon.

## Path parameters

- `id` string, required

## Request body

- PublishParams
  - `source` string, required — The source of the event (e.g. github, slack).
  - `event_type` string, required — The event type (e.g. push, pull_request).
  - `origin` 'EXTERNAL_EVENT' | 'AGENT_EVENT' | 'USER_EVENT', required — Allowed event origins for publish requests.
  - `payload` string, required — Event payload.

## Response `200`

OK

- PublishResultView
  - `sequence` integer, required — Assigned sequence number.
  - `timestamp_ms` integer, required — Timestamp in milliseconds since epoch.

---

[API](https://skmtc.net/runloopai/apis/runloop-api.md) · [All operations](https://skmtc.net/runloopai/apis/runloop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/runloopai/runloop-api/versions/ef553a04de89/schema)