Create Job Tool
create-jobCreates one job directly in the selected FieldRobin business when the connection has job-write permission. Resolve the customer first and pass the verified customer ID when one is named. Use to create job in the connected business. Returns capability, status, approval_required, persisted, agent_run_id, scope, job, result, idempotent_replay, message.
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": {
"title": "<title>",
"idempotency_key": "<idempotency_key>"
},
"name": "create-job"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Short job title. | |
| status | No | Initial job status. | |
| customer_id | No | Verified customer ID, if the job belongs to an existing customer. | |
| description | No | Readable issue and service description. | |
| location_id | No | Business location for the job. | |
| voice_notes | No | Optional internal voice-note text. | |
| scheduled_at | No | Optional local wall-clock appointment date/time or ISO timestamp with offset. | |
| total_amount | No | Optional quoted amount. | |
| idempotency_key | Yes | Opaque retry key. Reuse it only for the same request to receive the verified result without creating a duplicate. | |
| service_address | No | Service address, if known. | |
| appointment_count | No | Optional appointment count. | |
| technician_user_id | No | Verified technician user ID, if assigned. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job | Yes | Safe projection of the created record. | |
| scope | Yes | Business boundary used to authorize this result. | |
| result | Yes | Verified domain result and tenant-scoping evidence. | |
| status | Yes | Authoritative mutation outcome. | |
| message | Yes | Human-readable completion message. | |
| persisted | Yes | Whether the record was persisted. | |
| capability | Yes | Executed domain capability name. | |
| agent_run_id | Yes | Auditable agent run identifier. | |
| approval_required | Yes | Whether additional approval is required. | |
| idempotent_replay | Yes | True when this repeats an already verified request. |