plane: dataresource: AgentTaskC1rendered from forge v1.56.0 platform-model.json

agent-run

Invoke a model with a forced structured-output schema; the parsed result is persisted as an AgentTask and an Artifact, owner-scoped.

AgentRunPOST /capabilities/agent-run

AgentTaskthe Resource it produces

3 eventsAgentRunSucceeded · AgentRunFailed · ArtifactCreated

Ask your agent forge → agent-run

you

(your app calls this at runtime)

claude

forge → agent-run Done — AgentTask created; I recorded ArtifactCreated.

From the terminal

# no CLI verb — HTTP only
curl -sS http://127.0.0.1:3718/capabilities/agent-run \
 -H 'content-type: application/json' \
 -d '{"app":"hello","owner":"user_01","capability":"summarize","system":"…","input":"…","schema":{"type":"object"}}'

HTTP :3718

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

{
  "app": "hello",
  "owner": "user_01",
  "capability": "summarize",
  "system": "…",
  "input": "…",
  "schema": {
    "type": "object"
  }
}

Input fields 8

app
owner
capability
system
input
schema
model
max_tokens

Events ForgeEvent

AgentRunSucceeded   resource_type: AgentTask
AgentRunFailed   resource_type: AgentTask
ArtifactCreated   resource_type: AgentTask

Resource GET /resources/AgentTask/:id

{
  "type": "AgentTask",
  "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