# Proactive

> The Proactive operations of the Hub REST API (1 operation).

URL: https://docs.synap.live/docs/reference/hub-api/proactive · Generated from Synap-core/backend@c31e261ab (main)

Paths are relative to `/api/hub` on a pod.

## POST /proactive/post

Post a proactive message into the user's feed channel

Rate-limited: max 3 messages/hour and 10/day per (user, workspace). Returns posted=false when rate-limited.

Request body (`application/json`): ProactivePostRequest

| Field | Type | Required | Description |
|---|---|---|---|
| `userId` | string | yes |  |
| `workspaceId` | string | yes |  |
| `content` | string | yes | Plaintext or markdown body. Max 10000 chars. |
| `proactiveType` | ProactiveType | yes |  |
| `reasoning` | string |  |  |
| `metadata` | object |  |  |

Responses:

- `200`: Delivery result (may be posted=false when rate-limited)
- `400`: Bad request
- `403`: Forbidden
- `500`: Internal error