Tool details
| Field | Value |
|---|---|
| Name | list_schedules |
| Group | Schedules |
Playground
Input schema
input-schema.json
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"description": "Project ID or slug."
},
"status": {
"type": "string",
"enum": [
"active",
"paused",
"deleting"
],
"description": "Optional schedule status filter."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"description": "Maximum schedules to return.",
"default": 100
}
},
"additionalProperties": false,
"description": "Input schema for listing project schedules.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
Output schema
output-schema.json
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Schedule ID."
},
"project_id": {
"type": "string",
"format": "uuid",
"description": "Owning project ID."
},
"name": {
"type": "string",
"description": "Human-readable schedule name."
},
"status": {
"type": "string",
"enum": [
"active",
"paused",
"deleting"
],
"description": "Schedule status."
},
"paused_reason": {
"type": [
"string",
"null"
],
"description": "System pause reason when Veryfront pauses the schedule."
},
"paused_at": {
"type": [
"string",
"null"
],
"description": "Timestamp when Veryfront paused the schedule."
},
"last_failure_at": {
"type": [
"string",
"null"
],
"description": "Timestamp of the most recent schedule failure."
},
"last_failure_code": {
"type": [
"string",
"null"
],
"description": "Most recent schedule failure code."
},
"last_failure_message": {
"type": [
"string",
"null"
],
"description": "Most recent schedule failure message."
},
"last_failure_run_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "The last failure run id associated with this record."
},
{
"type": "null",
"description": "The last failure run id returned by the tool."
}
],
"description": "Canonical run ID for the most recent schedule failure."
},
"target": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"task",
"workflow",
"agent"
],
"description": "Kind of scheduled target."
},
"id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Target identifier. For agent schedules, this is the agent ID."
},
"conversation_mode": {
"type": "string",
"enum": [
"create_new",
"existing",
"none"
],
"description": "Agent conversation mode for recurring agent schedules."
},
"conversation_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Conversation identifier associated with the record."
},
{
"type": "null",
"description": "Conversation identifier associated with this result."
}
],
"description": "Existing conversation ID when conversation_mode is existing."
}
},
"required": [
"kind",
"id"
],
"additionalProperties": false,
"description": "Typed schedule target."
},
"schedule": {
"type": "string",
"description": "Schedule expression."
},
"timezone": {
"type": "string",
"description": "IANA timezone."
},
"runtime_target_kind": {
"type": "string",
"enum": [
"main_branch",
"environment",
"preview_branch"
],
"description": "Runtime target kind."
},
"runtime_target_environment_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "The runtime target environment id associated with this record."
},
{
"type": "null",
"description": "The runtime target environment id returned by the tool."
}
],
"description": "Environment ID for environment schedules."
},
"runtime_target_branch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "The runtime target branch id associated with this record."
},
{
"type": "null",
"description": "The runtime target branch id returned by the tool."
}
],
"description": "Branch ID for preview branch schedules."
},
"config": {
"type": "object",
"additionalProperties": {
"description": "Additional structured values associated with this result."
},
"description": "Run configuration without internal schedule target metadata."
},
"timeout_seconds": {
"type": "integer",
"description": "Per-run timeout in seconds."
},
"backoff_limit": {
"type": "integer",
"description": "Retry backoff limit."
},
"concurrency_policy": {
"type": "string",
"description": "How overlapping scheduled runs are handled."
},
"definition_source": {
"type": "string",
"enum": [
"manual",
"source"
],
"description": "Whether the schedule is manually managed or source-defined."
},
"source_trigger_id": {
"type": [
"string",
"null"
],
"description": "Source trigger ID for source-defined schedules."
},
"source_path": {
"type": [
"string",
"null"
],
"description": "Source file path for source-defined schedules."
},
"source_hash": {
"type": [
"string",
"null"
],
"description": "Source definition hash for source-defined schedules."
},
"last_scheduled_at": {
"type": [
"string",
"null"
],
"description": "Last scheduled fire time."
},
"last_successful_at": {
"type": [
"string",
"null"
],
"description": "Last successful run time."
},
"health": {
"anyOf": [
{
"type": "object",
"properties": {
"maxStalenessSeconds": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "The max staleness seconds associated with this record."
}
},
"required": [
"maxStalenessSeconds"
],
"additionalProperties": false,
"description": "Structured health details associated with this record."
},
{
"type": "null",
"description": "The health returned by the tool."
}
],
"description": "Optional staleness budget used for schedule health alerting."
},
"max_runs": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"description": "The max runs associated with this record."
},
{
"type": "null",
"description": "The max runs returned by the tool."
}
],
"description": "Optional maximum run count."
},
"run_count": {
"type": "integer",
"minimum": 0,
"description": "Completed or attempted scheduled run count."
},
"completed_at": {
"type": [
"string",
"null"
],
"description": "Completion time for finite schedules."
},
"created_by": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "The created by associated with this record."
},
{
"type": "null",
"description": "The created by returned by the tool."
}
],
"description": "User that created the schedule."
},
"integration_requirements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"integration": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"pattern": "^[a-z0-9][a-z0-9_-]*$",
"description": "The integration associated with this record."
},
"required_scopes": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "One required scope item associated with this record."
},
"maxItems": 50,
"description": "The required scopes associated with this record.",
"default": []
},
"resources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^[a-z][a-z0-9_-]*$",
"description": "The kind associated with this record."
},
"id": {
"type": "string",
"minLength": 1,
"maxLength": 512,
"description": "Unique identifier for the record."
},
"parent": {
"type": "object",
"properties": {
"kind": {
"$ref": "#/properties/data/items/properties/integration_requirements/items/properties/resources/items/properties/kind",
"description": "The kind returned by the tool."
},
"id": {
"$ref": "#/properties/data/items/properties/integration_requirements/items/properties/resources/items/properties/id",
"description": "Unique identifier for the returned record."
}
},
"required": [
"kind",
"id"
],
"additionalProperties": false,
"description": "The parent associated with this record."
}
},
"required": [
"kind",
"id"
],
"additionalProperties": false,
"description": "One resource item associated with this record."
},
"maxItems": 50,
"description": "The resources associated with this record.",
"default": []
}
},
"required": [
"integration"
],
"additionalProperties": false,
"description": "One integration requirement item associated with this record."
},
"maxItems": 20,
"description": "OAuth scopes and exact provider resources required before the schedule can run.",
"default": []
},
"created_at": {
"type": "string",
"description": "Creation timestamp."
},
"updated_at": {
"type": "string",
"description": "Last update timestamp."
}
},
"required": [
"id",
"project_id",
"name",
"status",
"paused_reason",
"paused_at",
"last_failure_at",
"last_failure_code",
"last_failure_message",
"last_failure_run_id",
"target",
"schedule",
"timezone",
"runtime_target_kind",
"runtime_target_environment_id",
"runtime_target_branch_id",
"config",
"timeout_seconds",
"backoff_limit",
"concurrency_policy",
"definition_source",
"source_trigger_id",
"source_path",
"source_hash",
"last_scheduled_at",
"last_successful_at",
"health",
"max_runs",
"run_count",
"completed_at",
"created_by",
"created_at",
"updated_at"
],
"additionalProperties": false,
"description": "Recurring project schedule."
},
"description": "Schedules returned for the project."
},
"source_schedules": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Unique identifier for the record."
},
"name": {
"type": "string",
"description": "Human-readable name for the record."
},
"description": {
"type": [
"string",
"null"
],
"description": "Human-readable description for the record."
},
"target": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"task",
"workflow",
"agent"
],
"description": "The kind associated with this record."
},
"id": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Unique identifier for the record."
},
"conversation_mode": {
"type": "string",
"enum": [
"create_new",
"existing",
"none"
],
"description": "The conversation mode associated with this record."
},
"conversation_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Conversation identifier associated with the record."
},
{
"type": "null",
"description": "Conversation identifier associated with this result."
}
],
"description": "Conversation identifier associated with the record."
}
},
"required": [
"kind",
"id"
],
"additionalProperties": false,
"description": "Structured target details associated with this record."
},
"schedule": {
"type": "string",
"description": "The schedule associated with this record."
},
"timezone": {
"type": "string",
"description": "The timezone associated with this record."
},
"runtime_target_kind": {
"type": "string",
"enum": [
"main_branch",
"environment",
"preview_branch"
],
"description": "The runtime target kind associated with this record."
},
"runtime_target_environment_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "The runtime target environment id associated with this record."
},
{
"type": "null",
"description": "The runtime target environment id returned by the tool."
}
],
"description": "The runtime target environment id associated with this record."
},
"runtime_target_branch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "The runtime target branch id associated with this record."
},
{
"type": "null",
"description": "The runtime target branch id returned by the tool."
}
],
"description": "The runtime target branch id associated with this record."
},
"config": {
"type": "object",
"additionalProperties": {
"description": "Additional structured values associated with this result."
},
"description": "Structured config details associated with this record."
},
"timeout_seconds": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "The timeout seconds associated with this record."
},
"backoff_limit": {
"type": "integer",
"minimum": 0,
"description": "The backoff limit associated with this record."
},
"concurrency_policy": {
"type": "string",
"description": "The concurrency policy associated with this record."
},
"max_runs": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"description": "The max runs associated with this record."
},
{
"type": "null",
"description": "The max runs returned by the tool."
}
],
"description": "The max runs associated with this record."
},
"health": {
"anyOf": [
{
"$ref": "#/properties/data/items/properties/health/anyOf/0",
"description": "The health returned by the tool."
},
{
"type": "null",
"description": "The health returned by the tool."
}
],
"description": "The health associated with this record."
},
"definition_source": {
"type": "string",
"const": "source",
"description": "The definition source associated with this record."
},
"source_trigger_id": {
"type": "string",
"description": "The source trigger id associated with this record."
},
"source_path": {
"type": "string",
"description": "The source path associated with this record."
},
"source_hash": {
"type": "string",
"description": "The source hash associated with this record."
},
"edit_mode": {
"type": "string",
"enum": [
"structured",
"source_only"
],
"description": "The edit mode associated with this record."
}
},
"required": [
"id",
"name",
"description",
"target",
"schedule",
"timezone",
"runtime_target_kind",
"runtime_target_environment_id",
"runtime_target_branch_id",
"config",
"timeout_seconds",
"backoff_limit",
"concurrency_policy",
"max_runs",
"health",
"definition_source",
"source_trigger_id",
"source_path",
"source_hash",
"edit_mode"
],
"additionalProperties": false,
"description": "One source schedule item associated with this record."
},
"description": "Source-defined schedules discovered for the project."
},
"diagnostics": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "source_file_diagnostic",
"description": "The kind associated with this record."
},
"source_kind": {
"type": "string",
"enum": [
"agent",
"prompt",
"tool",
"task",
"workflow",
"resource",
"skill",
"eval",
"schedule",
"webhook"
],
"description": "The source kind associated with this record."
},
"source_path": {
"type": "string",
"minLength": 1,
"description": "The source path associated with this record."
},
"source_id": {
"type": "string",
"minLength": 1,
"description": "The source id associated with this record."
},
"code": {
"type": "string",
"enum": [
"parse_error",
"invalid_definition",
"dynamic_definition",
"duplicate_source_id",
"unsupported_target",
"manual_conflict"
],
"description": "The code associated with this record."
},
"message": {
"type": "string",
"minLength": 1,
"description": "The message associated with this record."
}
},
"required": [
"kind",
"source_kind",
"source_path",
"code",
"message"
],
"additionalProperties": false,
"description": "One diagnostic item associated with this record."
},
"description": "List of diagnostics associated with this record."
}
},
"required": [
"data",
"source_schedules",
"diagnostics"
],
"additionalProperties": false,
"description": "List of project schedules.",
"$schema": "http://json-schema.org/draft-07/schema#"
}