ForgeEventsclosed catalog · 59 types · about Resources
App eventsyour open vocabulary · owner-scoped
One read eachGET /events · GET /app-events
Events
ForgeEvents — the closed catalog, by family
| family | types | emitted by |
|---|---|---|
| lifecycle | ApplicationInitialized · EnvironmentProvisioned · DependenciesInstalled · DevServerStarted · DevServerStopped · ProductionArtifactsGenerated | initialize-app · provision-environment · install-dependencies · run-dev-server · productionize |
| build · test · lint | BuildStarted/Succeeded/Failed · TestRunStarted/Succeeded/Failed · CheckRunStarted/Succeeded/Failed | build · test · lint |
| deploy · release | DeploymentStarted/Completed/RolledBack · ReleaseStarted/Completed/Failed | deploy · release |
| analysis | InspectionCreated · VerificationCompleted · AnalysisCreated · PlanCreated | inspect · verify · explain-failure · generate-feature-plan |
| scheduler | JobScheduled · JobUnscheduled · JobRan · JobRunFailed | schedule-job · the ticker |
| secrets | SecretSet · SecretUnset | set-secret · unset-secret |
| agent · artifact | AgentRunSucceeded · AgentRunFailed · ArtifactCreated | agent-run |
| messaging | EmailSent · EmailFailed · MessageSent · MessageFailed | send-email · send-message |
| identity | UserSignedUp · UserVerified · UserAuthenticated · SessionRefreshed · SessionRevoked · PasswordResetRequested · PasswordChanged · OwnerSeeded · UserDeleted · Twofa* | the /auth routes |
| incidents | IncidentOpened · IncidentUpdated · IncidentResolved | the /status/incidents routes |
| observability · ops | ObservabilityConfigured · MonitoringConfigured · EvalRunCompleted · DeliveryCheckCompleted/Failed | setup-observability · provision-monitoring · eval · delivery-check |
{ "id": "evt_01J…", "type": "BuildSucceeded", "resource_type": "Build", "resource_id": "res_01J…",
"app_id": "app_hello", "timestamp": "2026-09-03T14:01:58Z", "actor": { "type": "builder", "id": "cli" }, "data": { "duration_ms": 14100 } }
GET /events?app_id=app_hello&resource_id=res_01J…&limit=20App events (C3) — what the platform itself writes into your log
| type | when | data |
|---|---|---|
| mcp.tool_call | every MCP tools/call | tool · host · ok · reason? |
| authz.decision · authz.approval | every C29 evaluation · a staged action approved | decision · rule · high_risk · action |
| policy.set · policy.removed | a rule written · a rule removed | id · effect · owner? |
| membership.removed | removal · self-leave · teardown | group_id · removed_owner · via |
| billing.* | checkout_started · trial_started · subscription_updated · customer_deleted · admin_locked/comped | plan_key · status · event_type |
| connector.connected · connector.disconnected · connector.token_issued | a provider grant lands · is revoked · a token is minted | provider · scopes |
| message.sent · message.failed | an outbound send as the user | provider · channel · message_id · error? |
| anything you choose | your app's own facts | POST /app-events {owner, type, subject?, data} |
POST /app-events { "app": "hello", "owner": "user_01", "type": "order.placed", "subject": "order:ord_7", "data": { "total": 42.00 } }
GET /app-events?app=hello&owner=user_01&subject=order:ord_7 newest first
GET /app-events/latest?app=hello&owner=user_01 subject → latest