---
title: "Append a factual event to a project's ledger. occurredAt is real-world time; the recorded time is always server-stamped. Returns the full RPC result including the event id."
method: POST
path: "/projects/{id}/events"
---

# Append a factual event to a project's ledger. occurredAt is real-world time; the recorded time is always server-stamped. Returns the full RPC result including the event id.

`POST /projects/{id}/events`

## Request

- Base URL: `https://forbiz.io/api/public/agent`
- URL: `https://forbiz.io/api/public/agent/projects/{id}/events`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `eventType` string
  - `rawText` string
  - `occurredAt` string, date-time
  - `source` string
  - `metadata` object
  - `confidence` number
  - `organizationId` string
  - `personId` string
  - `actionId` string
  - `actorName` string

## Response `200`

Appended

- object

## Other responses

- `208`: Idempotent replay of a previous request with the same Idempotency-Key. Nothing was applied again.
- `400`: Validation error
- `404`: Project not found in this workspace

---

[API](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api.md) · [All operations](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/revisions/e5b10d59dc5f?raw)