---
title: "Post Project Event"
method: POST
path: "/projects/{project_id}/events"
---

# Post Project Event

`POST /projects/{project_id}/events`

## Request

- Base URL: `https://usemeridian.us` (the document declares no server; this is the origin it was published from)
- URL: `https://usemeridian.us/projects/{project_id}/events`
- Auth: none declared

Normalize a framework event into Meridian's task_log.

Auth: ``X-Meridian-Token: <project_token>`` header.  The token grants
write-access to a single project's task_log only — call
``ensure_project_token`` to mint one (returned by the dashboard's
Project settings panel, by GET /projects/{id}/webhook-token).

Body schema (all optional except description+session_name):
```
{
  "type": "task_completed" | "checkpoint" | "hitl_request" | "session_start",
  "session_name": "langgraph-researcher",
  "human_id": "langgraph",
  "agent_framework": "langgraph",
  "description": "researcher agent fetched 3 sources",
  "status": "done",
  "parent_task_id": null,
  "metadata": {}
}
```

## Path parameters

- `project_id` string, required

## Request body

- object

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/usemeridian/apis/meridian.md) · [All operations](https://skmtc.dev/usemeridian/apis/meridian/llms.txt) · [OpenAPI document](https://skmtc.dev/usemeridian/apis/meridian/revisions/f37a894bd374?raw)