forge
Clone forge-starter
plane: bothresource: Inspectionrendered from forge v1.56.0 platform-model.json

inspect

Read the app's state: app · resources · events · app-events · notifications · routes · scripts · docker · secrets · jobs · agent-runs · email · auth · health.

InspectPOST /capabilities/inspect
Inspectionthe Resource it produces
1 eventInspectionCreated

Ask your agent forge → inspect

you
Is hello healthy? What jobs does it have?
claude
forge → inspect Done — Inspection created; I recorded InspectionCreated.

From the terminal

$ forge inspect health --app hello

HTTP either plane

POST /capabilities/inspect
Content-Type: application/json
x-forge-actor-type: builder
x-forge-actor-id: cli

{
  "app": "hello",
  "type": "health"
}

Input fields 5

app
platform
framework
type
owner

Events ForgeEvent

InspectionCreated   resource_type: Inspection

Resource GET /resources/Inspection/:id

{
  "type": "Inspection",
  "id": "res_01J…",
  "app_id": "app_hello",
  "status": "succeeded",
  "created_at": "2026-09-03T14:00:00Z"
}

Errors: see Reference → Errors. Find it in the playground