list_jobs
Retrieve and filter agent jobs by status, schedule, or type, with options for pagination and sorting to efficiently manage job tracking in the Agent Jobs system.
Instructions
Retrieves a list of agent jobs, with optional filters and pagination.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
channel_code | No | Filter by the channel code (e.g., 'C123456' for a Slack channel). | |
created_at_gte | No | Filter for jobs created at or after a specific time (ISO 8601). | |
created_at_lte | No | Filter for jobs created at or before a specific time (ISO 8601). | |
job_type_id | No | Filter by the specific job type ID (e.g., 'daily-report'). | |
limit | No | Maximum number of jobs to return (e.g.,20). Default is 20. | |
offset | No | Number of jobs to skip, used for pagination. Default is 0. | |
org_id | No | Filter by organization ID. If not provided, the default from the environment is used. | |
scheduled_at | No | Filter by the exact scheduled time in ISO 8601 format (e.g., '2024-07-23T10:00:00Z'). | |
scheduled_at_gte | No | Filter for jobs scheduled at or after a specific time (ISO 8601). | |
scheduled_at_lte | No | Filter for jobs scheduled at or before a specific time (ISO 8601). | |
sort | No | Field to sort by and direction. Format is 'field:direction'. Example: 'created_at:desc'. | |
status | No | Filter by job status. Possible values are: 'waiting', 'scheduled', 'running', 'completed', 'failed', 'canceled'. |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"channel_code": {
"description": "Filter by the channel code (e.g., 'C123456' for a Slack channel).",
"type": "string"
},
"created_at_gte": {
"$ref": "#/properties/scheduled_at",
"description": "Filter for jobs created at or after a specific time (ISO 8601)."
},
"created_at_lte": {
"$ref": "#/properties/scheduled_at",
"description": "Filter for jobs created at or before a specific time (ISO 8601)."
},
"job_type_id": {
"description": "Filter by the specific job type ID (e.g., 'daily-report').",
"type": "string"
},
"limit": {
"description": "Maximum number of jobs to return (e.g.,20). Default is 20.",
"exclusiveMinimum": 0,
"type": "integer"
},
"offset": {
"description": "Number of jobs to skip, used for pagination. Default is 0.",
"minimum": 0,
"type": "integer"
},
"org_id": {
"description": "Filter by organization ID. If not provided, the default from the environment is used.",
"type": "string"
},
"scheduled_at": {
"description": "Filter by the exact scheduled time in ISO 8601 format (e.g., '2024-07-23T10:00:00Z').",
"type": "string"
},
"scheduled_at_gte": {
"$ref": "#/properties/scheduled_at",
"description": "Filter for jobs scheduled at or after a specific time (ISO 8601)."
},
"scheduled_at_lte": {
"$ref": "#/properties/scheduled_at",
"description": "Filter for jobs scheduled at or before a specific time (ISO 8601)."
},
"sort": {
"description": "Field to sort by and direction. Format is 'field:direction'. Example: 'created_at:desc'.",
"type": "string"
},
"status": {
"description": "Filter by job status. Possible values are: 'waiting', 'scheduled', 'running', 'completed', 'failed', 'canceled'.",
"enum": [
"waiting",
"scheduled",
"running",
"completed",
"failed",
"canceled"
],
"type": "string"
}
},
"type": "object"
}