APIs & SDK
- Overview
- Python SDK Overview
- REST API
- REST API overview
- Cloud API
- Server API
- Server API Overview
- Root
- Flows
- Flow Runs
- Task Runs
- Flow Run States
- Task Run States
- Flow Run Notification Policies
- Deployments
- POSTCreate Deployment
- GETRead Deployment
- DELDelete Deployment
- PATCHUpdate Deployment
- GETRead Deployment By Name
- POSTRead Deployments
- POSTPaginate Deployments
- POSTGet Scheduled Flow Runs For Deployments
- POSTCount Deployments
- POSTSchedule Deployment
- POSTResume Deployment
- POSTPause Deployment
- POSTCreate Flow Run From Deployment
- GETWork Queue Check For Deployment
- GETRead Deployment Schedules
- POSTCreate Deployment Schedules
- DELDelete Deployment Schedule
- PATCHUpdate Deployment Schedule
- POST
- SavedSearches
- Logs
- Concurrency Limits
- Concurrency Limits V2
- Block types
- Block documents
- Work Pools
- Task Workers
- Work Queues
- Artifacts
- Block schemas
- Block capabilities
- Collections
- Variables
- GETCreate Csrf Token
- Events
- Automations
- UI
- Admin
- CLI Reference
Paginate Deployments
Pagination query for flow runs.
{
"results": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created": "2023-11-07T05:31:56Z",
"updated": "2023-11-07T05:31:56Z",
"name": "<string>",
"version": "<string>",
"description": "<string>",
"flow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"paused": false,
"schedules": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created": "2023-11-07T05:31:56Z",
"updated": "2023-11-07T05:31:56Z",
"deployment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"schedule": {
"interval": 123,
"anchor_date": "2020-01-01T00:00:00Z",
"timezone": "America/New_York"
},
"active": true,
"max_scheduled_runs": 1,
"parameters": {},
"slug": "<string>"
}
],
"concurrency_limit": 123,
"global_concurrency_limit": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created": "2023-11-07T05:31:56Z",
"updated": "2023-11-07T05:31:56Z",
"active": true,
"name": "<string>",
"limit": 123,
"active_slots": 123,
"slot_decay_per_second": 2
},
"concurrency_options": {
"collision_strategy": "ENQUEUE"
},
"job_variables": {},
"parameters": {},
"tags": [
"tag-1",
"tag-2"
],
"labels": {
"key": "value1",
"key2": 42
},
"work_queue_name": "<string>",
"last_polled": "2023-11-07T05:31:56Z",
"parameter_openapi_schema": {},
"path": "<string>",
"pull_steps": [
{}
],
"entrypoint": "<string>",
"storage_document_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"infrastructure_document_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "<string>",
"display_value": "<string>"
},
"updated_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "<string>",
"display_value": "<string>"
},
"work_pool_name": "<string>",
"status": "READY",
"enforce_parameter_schema": true
}
],
"count": 123,
"limit": 123,
"pages": 123,
"page": 123
}Headers
Body
x > 1Filter for flows. Only flows matching all criteria will be returned.
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ Filter criteria for Flow.id
A list of flow ids to include
Filter criteria for Flow.tags
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ A list of tags. Flows will be returned only if their tags are a superset of the list
If true, only include flows without tags
Filter flow runs. Only flow runs matching all criteria will be returned
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ Filter criteria for FlowRun.tags
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ A list of tags. Flow runs will be returned only if their tags are a superset of the list
A list of tags to include
If true, only include flow runs without tags
Filter criteria for FlowRun.deployment_id
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ A list of flow run deployment ids to include
If true, only include flow runs without deployment ids
Filter criteria for `FlowRun.work_queue_name
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ A list of work queue names to include
If true, only include flow runs without work queue names
Filter criteria for FlowRun.state
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ Filter criteria for FlowRun.state_type
A list of flow run state types to include
SCHEDULED, PENDING, RUNNING, COMPLETED, FAILED, CANCELLED, CRASHED, PAUSED, CANCELLING A list of flow run state types to exclude
SCHEDULED, PENDING, RUNNING, COMPLETED, FAILED, CANCELLED, CRASHED, PAUSED, CANCELLING Filter criteria for FlowRun.flow_version
A list of flow run flow_versions to include
Filter criteria for FlowRun.start_time
Filter criteria for FlowRun.end_time
Filter criteria for FlowRun.next_scheduled_start_time
Filter criteria for FlowRun.parent_task_run_id
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ A list of flow run parent_task_run_ids to include
If true, only include flow runs without parent_task_run_id
Filter task runs. Only task runs matching all criteria will be returned
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ Filter criteria for TaskRun.id
A list of task run ids to include
Filter criteria for TaskRun.tags
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ A list of tags. Task runs will be returned only if their tags are a superset of the list
If true, only include task runs without tags
Filter criteria for TaskRun.state
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ Filter criteria for TaskRun.state_type
A list of task run state types to include
SCHEDULED, PENDING, RUNNING, COMPLETED, FAILED, CANCELLED, CRASHED, PAUSED, CANCELLING Filter criteria for TaskRun.start_time
Filter criteria for TaskRun.subflow_run
If true, only include task runs that are subflow run parents; if false, exclude parent task runs
Filter criteria for TaskRun.flow_run_id
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ A list of task run flow run ids to include
Filter for task runs with None as their flow run id
Filter for deployments. Only deployments matching all criteria will be returned.
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ Filter criteria for Deployment.id
A list of deployment ids to include
Filter criteria for Deployment.name or Flow.name
A case-insensitive partial match on deployment or flow names. For example, passing 'example' might match deployments or flows with 'example' in their names.
Filter criteria for Deployment.paused
Only returns where deployment is/is not paused
Filter criteria for Deployment.tags
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ A list of tags. Deployments will be returned only if their tags are a superset of the list
A list of tags to include
If true, only include deployments without tags
Filter criteria for Deployment.work_queue_name
A list of work queue names to include
DEPRECATED: Prefer Deployment.concurrency_limit_id over Deployment.concurrency_limit. If provided, will be ignored for backwards-compatibility. Will be removed after December 2024.
Only include deployments with a concurrency limit greater than or equal to this value
Only include deployments with a concurrency limit less than or equal to this value
If true, only include deployments without a concurrency limit
Filter work pools. Only work pools matching all criteria will be returned
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ Filter criteria for WorkPool.id
A list of work pool ids to include
Filter criteria for WorkPool.name
A list of work pool names to include
Filter work queues. Only work queues matching all criteria will be returned
Operator for combining filter criteria. Defaults to 'and_'.
and_, or_ Filter criteria for WorkQueue.id
A list of work queue ids to include
Filter criteria for WorkQueue.name
Defines deployment sorting options.
CREATED_DESC, UPDATED_DESC, NAME_ASC, NAME_DESC Defaults to PREFECT_API_DEFAULT_LIMIT if not provided.
Response
The name of the deployment.
The flow id associated with the deployment.
An optional version for the deployment.
A description for the deployment.
Whether or not the deployment is paused.
A list of schedules for the deployment.
The deployment id associated with this schedule.
Whether or not the schedule is active.
The maximum number of scheduled runs for the schedule.
x > 0A dictionary of parameter value overrides.
A unique slug for the schedule.
DEPRECATED: Prefer global_concurrency_limit. Will always be None for backwards compatibility. Will be removed after December 2024.
The global concurrency limit object for enforcing the maximum number of flow runs that can be active at once.
The name of the global concurrency limit.
The concurrency limit.
The number of active slots.
Whether the global concurrency limit is active.
The decay rate for active slots when used as a rate limit.
The concurrency options for the deployment.
Enumeration of concurrency collision strategies.
ENQUEUE, CANCEL_NEW Overrides to apply to the base infrastructure block at runtime.
Parameters for flow runs scheduled by the deployment.
A list of tags for the deployment
A dictionary of key-value labels. Values can be strings, numbers, or booleans.
The work queue for the deployment. If no work queue is set, work will not be scheduled.
The last time the deployment was polled for status updates.
The parameter schema of the flow, including defaults.
The path to the working directory for the workflow, relative to remote storage or an absolute path.
Pull steps for cloning and running this deployment.
The path to the entrypoint for the workflow, relative to the path.
The block document defining storage used for this flow.
The block document defining infrastructure to use for flow runs.
The name of the deployment's work pool.
Whether the deployment is ready to run flows.
READY, NOT_READY Whether or not the deployment should enforce the parameter schema.
Was this page helpful?
{
"results": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created": "2023-11-07T05:31:56Z",
"updated": "2023-11-07T05:31:56Z",
"name": "<string>",
"version": "<string>",
"description": "<string>",
"flow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"paused": false,
"schedules": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created": "2023-11-07T05:31:56Z",
"updated": "2023-11-07T05:31:56Z",
"deployment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"schedule": {
"interval": 123,
"anchor_date": "2020-01-01T00:00:00Z",
"timezone": "America/New_York"
},
"active": true,
"max_scheduled_runs": 1,
"parameters": {},
"slug": "<string>"
}
],
"concurrency_limit": 123,
"global_concurrency_limit": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created": "2023-11-07T05:31:56Z",
"updated": "2023-11-07T05:31:56Z",
"active": true,
"name": "<string>",
"limit": 123,
"active_slots": 123,
"slot_decay_per_second": 2
},
"concurrency_options": {
"collision_strategy": "ENQUEUE"
},
"job_variables": {},
"parameters": {},
"tags": [
"tag-1",
"tag-2"
],
"labels": {
"key": "value1",
"key2": 42
},
"work_queue_name": "<string>",
"last_polled": "2023-11-07T05:31:56Z",
"parameter_openapi_schema": {},
"path": "<string>",
"pull_steps": [
{}
],
"entrypoint": "<string>",
"storage_document_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"infrastructure_document_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "<string>",
"display_value": "<string>"
},
"updated_by": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"type": "<string>",
"display_value": "<string>"
},
"work_pool_name": "<string>",
"status": "READY",
"enforce_parameter_schema": true
}
],
"count": 123,
"limit": 123,
"pages": 123,
"page": 123
}