create_job
Set up new Agent Jobs by specifying job type, target platform, and optional parameters. Schedule jobs for future execution or run immediately using structured inputs.
Instructions
Create a new Agent Job with the minimal set of fields.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_type_id | Yes | ID of the job type (e.g. "mood-monitor") | |
| params | No | Free‑form params passed to the agent | |
| scheduled_at | No | Schedule the job to run later | |
| target_channel | Yes | Where the agent will communicate. |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"job_type_id": {
"description": "ID of the job type (e.g. \"mood-monitor\")",
"type": "string"
},
"params": {
"additionalProperties": {},
"description": "Free‑form params passed to the agent",
"type": "object"
},
"scheduled_at": {
"description": "Schedule the job to run later",
"type": "string"
},
"target_channel": {
"additionalProperties": false,
"description": "Where the agent will communicate.",
"properties": {
"code": {
"description": "Channel identifier, phone number, or user ID.",
"type": "string"
},
"org_id": {
"description": "Org ID – defaults to config.DEFAULT_ORG_ID",
"type": "string"
},
"platform": {
"description": "Destination platform.",
"enum": [
"whatsapp",
"slack",
"web"
],
"type": "string"
}
},
"required": [
"platform",
"code"
],
"type": "object"
}
},
"required": [
"job_type_id",
"target_channel"
],
"type": "object"
}