Run job
proofable_job_createCreate an immediate or scheduled work item for an agent. Operator routes team work. Developer and designer jobs run on the hosted Operator runtime. The signed-in account must own the agent or hold active permissions for it.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"prompt": "<prompt>",
"agentWallet": "<agentWallet>",
"agentId": "<agentId>"
},
"name": "proofable_job_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Additional tags | |
| model | No | Override model for inference | |
| origin | No | Where the outcome is announced, e.g. { type: 'slack', channel: '<channel id>' }. Finished, failed and awaiting-approval runs post there. | |
| prompt | Yes | Work to run in natural language (user story, issue, feedback, or outcome). Never tool names. | |
| agentId | Yes | Agent identifier | |
| runAtMs | No | Optional unix ms timestamp for first run | |
| runtime | No | Optional computer intent: { requiresComputer: true, repo: { slug, ref } }. An explicit harness override may select an ACP agent. Delegation must allow run_command; if setup is unavailable, the job fails closed. Omitted jobs use hosted Operator. | |
| provider | No | Inference provider label (e.g., "openrouter", "openai") | |
| schedule | No | Optional one-time, interval, or cron schedule. Omit to run once now. | |
| acceptance | No | What 'done' means for this run, checked in code with no model in the loop. A run that declares acceptance is verified on completion and becomes an accepted outcome; a run that declares none completes but is recorded as not evaluated. | |
| agentWallet | Yes | Agent wallet address (0x...) | |
| runNowFirst | No | For recurring schedules, run once immediately before the next scheduled run. | |
| outputSchema | No | JSON Schema the run's structured output must satisfy. A response that violates it fails the run instead of being recorded as a success. A string field listed in required must also be non-empty, so leave a field that may be empty out of required, and state 'this OR that' with anyOf. | |
| runtimeClass | No | Optional work-kind label: general (default), developer, or designer. Does not select tools or the computer. Hosted Operator is the default runtime. Set runtime.requiresComputer or an explicit runtime.harness to request an isolated computer. | |
| systemPrompt | No | Override system prompt | |
| executionSteps | No | ||
| delegationQHash | No | Pin this job to one active agent-delegation proof. A revoked, expired, or mismatched proof is denied without falling back to another grant. | |
| requiresReceipt | No | Require the run to create a proof receipt. A run that owes a receipt and produces none fails. | |
| requiresJobApproval | No | Opt in to parking this run at waiting_approval before it executes, so it can be approved or denied with proofable_job_decide. Per request only, never derived from the agent's action-level approval policy. | |
| providerSecretProofQHash | No | Vault secret proof ID for a provider API key. Required when the selected provider uses your key. |