Jobs

Endpoints related to managing long-running tasks, known as jobs, on Cycle.

List Jobs

Requires the apionly-jobs-view permission.

SecuritybearerAuth and hubAuth

Request

query Parameters

include	Array of strings A comma separated list of include values. Included resources will show up under the root document's `include` field, with the key being the id of the included resource. In the case of applying an include to a collection of resources, if two resources share the same include, it will only appear once in the return. Items Value: "creators"
	object Filter Field The filter field is a key-value object, where the key is what you would like to filter, and the value is the value you're filtering for.
sort	Array of strings An array of sort values. To sort descending, put a `-` in front of the value, e.g. `-id`.
	object In a list return, the data associated with the page number and size returned. 20 results per page, page 2 would be `page[size]=20&page[number]=2`

Responses

200

Returns a list of Jobs.

default

General error response from the platform

get/v1/jobs

Response samples

200
default

application/json

{"data": [{"id": "651586fca6078e98982dbd90",
"hub_id": "651586fca6078e98982dbd90",
"queue": "string",
"caption": "string",
"events": {"queued": "2021-01-30T08:30:00Z",
"completed": "2021-01-30T08:30:00Z",
"started": "2021-01-30T08:30:00Z"
},
"schedule": "2021-01-30T08:30:00Z",
"tasks": [{"id": "651586fca6078e98982dbd90",
"caption": "string",
"header": "string",
"events": {"queued": "2021-01-30T08:30:00Z",
"completed": "2021-01-30T08:30:00Z",
"started": "2021-01-30T08:30:00Z"
},
"steps": [{"caption": "string",
"description": "string",
"started": "2021-01-30T08:30:00Z",
"completed": "2021-01-30T08:30:00Z"
}
],
"state": {"changed": "2021-01-30T08:30:00Z",
"current": "pending"
},
"input": {"property1": null,
"property2": null
},
"output": {"property1": "string",
"property2": "string"
},
"error": {"message": "string"
}
}
],
"expires": "2021-01-30T08:30:00Z",
"hash": "string",
"limit_duplicates": true,
"creator": {"id": "651586fca6078e98982dbd90",
"type": "account"
},
"state": {"current": "new",
"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string"
}
}
}
],
"includes": {"creators": {"accounts": {"property1": {"name": {"first": "string",
"last": "string"
},
"email": {"address": "string"
},
"id": "string",
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z",
"last_login": "2021-01-30T08:30:00Z"
}
},
"property2": {"name": {"first": "string",
"last": "string"
},
"email": {"address": "string"
},
"id": "string",
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z",
"last_login": "2021-01-30T08:30:00Z"
}
}
},
"employees": {"property1": {"name": {"first": "string",
"last": "string"
},
"email": {"address": "string"
},
"id": "string",
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z",
"last_login": "2021-01-30T08:30:00Z"
}
},
"property2": {"name": {"first": "string",
"last": "string"
},
"email": {"address": "string"
},
"id": "string",
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z",
"last_login": "2021-01-30T08:30:00Z"
}
}
},
"visitors": {"property1": {"name": {"first": "string",
"last": "string"
},
"email": {"address": "string"
},
"id": "string",
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z",
"last_login": "2021-01-30T08:30:00Z"
}
},
"property2": {"name": {"first": "string",
"last": "string"
},
"email": {"address": "string"
},
"id": "string",
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z",
"last_login": "2021-01-30T08:30:00Z"
}
}
},
"environments": {"property1": {"id": "651586fca6078e98982dbd90",
"identifier": "string",
"name": "string",
"cluster": "string",
"about": {"description": "string",
"favorite": true
},
"creator": {"id": "651586fca6078e98982dbd90",
"type": "account"
},
"hub_id": "651586fca6078e98982dbd90",
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"events": {"created": "2021-01-30T08:30:00Z",
"updated": "2021-01-30T08:30:00Z",
"deleted": "2021-01-30T08:30:00Z"
},
"features": {"legacy_networking": true,
"monitoring": {"tier": "limited"
}
},
"services": {"loadbalancer": {"enable": true,
"container_id": "string",
"high_availability": true,
"auto_update": true,
"config": {"ipv4": null,
"ipv6": null,
"type": null,
"details": null,
"bind_host": null
}
},
"discovery": {"enable": true,
"container_id": "string",
"high_availability": true,
"auto_update": true,
"config": {"empty_set_delay": null,
"hosts": { },
"custom_resolvers": [ ]
}
},
"vpn": {"enable": true,
"container_id": "string",
"auto_update": true,
"config": {"allow_internet": null,
"auth": { }
}
},
"scheduler": {"enable": true,
"container_id": "string",
"high_availability": true,
"auto_update": true,
"config": {"public": null,
"access_keys": [ ]
}
},
"gateway": {"enable": true,
"container_id": "string",
"high_availability": true,
"auto_update": true
}
},
"acl": {"roles": {"property1": {"view": null,
"modify": null,
"manage": null
},
"property2": {"view": null,
"modify": null,
"manage": null
}
}
},
"private_network": {"vxlan_tag": 0,
"subnet": "string",
"ipv6": {"ip": "fd00::21:0:0:0",
"cidr": "fd00::21:0:0:0/96"
},
"legacy": {"subnet": 0,
"ipv4": {"ip": null,
"cidr": null
}
}
},
"deployments": {"tags": {"property1": "v1.2.3-dev",
"property2": "v1.2.3-dev"
}
},
"meta": {"containers_count": {"state": {"new": 0,
"starting": 0,
"running": 5,
"stopping": 0,
"deleting": 0,
"deleted": 0
},
"total": 5,
"available": 5
},
"instances_count": {"state": {"new": 0,
"starting": 0,
"running": 5,
"stopping": 0,
"deleting": 0,
"deleted": 0
},
"total": 5,
"available": 5
},
"containers": [{"id": null,
"name": null,
"state": null,
"image": null,
"environment": null
}
]
}
},
"property2": {"id": "651586fca6078e98982dbd90",
"identifier": "string",
"name": "string",
"cluster": "string",
"about": {"description": "string",
"favorite": true
},
"creator": {"id": "651586fca6078e98982dbd90",
"type": "account"
},
"hub_id": "651586fca6078e98982dbd90",
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"events": {"created": "2021-01-30T08:30:00Z",
"updated": "2021-01-30T08:30:00Z",
"deleted": "2021-01-30T08:30:00Z"
},
"features": {"legacy_networking": true,
"monitoring": {"tier": "limited"
}
},
"services": {"loadbalancer": {"enable": true,
"container_id": "string",
"high_availability": true,
"auto_update": true,
"config": {"ipv4": null,
"ipv6": null,
"type": null,
"details": null,
"bind_host": null
}
},
"discovery": {"enable": true,
"container_id": "string",
"high_availability": true,
"auto_update": true,
"config": {"empty_set_delay": null,
"hosts": { },
"custom_resolvers": [ ]
}
},
"vpn": {"enable": true,
"container_id": "string",
"auto_update": true,
"config": {"allow_internet": null,
"auth": { }
}
},
"scheduler": {"enable": true,
"container_id": "string",
"high_availability": true,
"auto_update": true,
"config": {"public": null,
"access_keys": [ ]
}
},
"gateway": {"enable": true,
"container_id": "string",
"high_availability": true,
"auto_update": true
}
},
"acl": {"roles": {"property1": {"view": null,
"modify": null,
"manage": null
},
"property2": {"view": null,
"modify": null,
"manage": null
}
}
},
"private_network": {"vxlan_tag": 0,
"subnet": "string",
"ipv6": {"ip": "fd00::21:0:0:0",
"cidr": "fd00::21:0:0:0/96"
},
"legacy": {"subnet": 0,
"ipv4": {"ip": null,
"cidr": null
}
}
},
"deployments": {"tags": {"property1": "v1.2.3-dev",
"property2": "v1.2.3-dev"
}
},
"meta": {"containers_count": {"state": {"new": 0,
"starting": 0,
"running": 5,
"stopping": 0,
"deleting": 0,
"deleted": 0
},
"total": 5,
"available": 5
},
"instances_count": {"state": {"new": 0,
"starting": 0,
"running": 5,
"stopping": 0,
"deleting": 0,
"deleted": 0
},
"total": 5,
"available": 5
},
"containers": [{"id": null,
"name": null,
"state": null,
"image": null,
"environment": null
}
]
}
}
},
"api_keys": {"property1": {"id": "651586fca6078e98982dbd90",
"name": "string",
"hub_id": "651586fca6078e98982dbd90",
"secret": "string",
"permissions": {"all_environments": true,
"environments": [{"id": null,
"manage": null
}
]
},
"capabilities": {"all": true,
"specific": ["string"
]
},
"ips": ["string"
],
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z"
}
},
"property2": {"id": "651586fca6078e98982dbd90",
"name": "string",
"hub_id": "651586fca6078e98982dbd90",
"secret": "string",
"permissions": {"all_environments": true,
"environments": [{"id": null,
"manage": null
}
]
},
"capabilities": {"all": true,
"specific": ["string"
]
},
"ips": ["string"
],
"state": {"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string",
"time": "2021-01-30T08:30:00Z"
}
},
"events": {"property1": "2021-01-30T08:30:00Z",
"property2": "2021-01-30T08:30:00Z"
}
}
}
}
}
}

Get Job

Requires the apionly-jobs-view permission.

SecuritybearerAuth and hubAuth

Request

path Parameters

jobId

required

string

The ID for the given Job.

Responses

200

A Job resources.

default

General error response from the platform

get/v1/jobs/{jobId}

Response samples

200
default

application/json

{"data": {"id": "651586fca6078e98982dbd90",
"hub_id": "651586fca6078e98982dbd90",
"queue": "string",
"caption": "string",
"events": {"queued": "2021-01-30T08:30:00Z",
"completed": "2021-01-30T08:30:00Z",
"started": "2021-01-30T08:30:00Z"
},
"schedule": "2021-01-30T08:30:00Z",
"tasks": [{"id": "651586fca6078e98982dbd90",
"caption": "string",
"header": "string",
"events": {"queued": "2021-01-30T08:30:00Z",
"completed": "2021-01-30T08:30:00Z",
"started": "2021-01-30T08:30:00Z"
},
"steps": [{"caption": "string",
"description": "string",
"started": "2021-01-30T08:30:00Z",
"completed": "2021-01-30T08:30:00Z"
}
],
"state": {"changed": "2021-01-30T08:30:00Z",
"current": "pending"
},
"input": {"property1": null,
"property2": null
},
"output": {"property1": "string",
"property2": "string"
},
"error": {"message": "string"
}
}
],
"expires": "2021-01-30T08:30:00Z",
"hash": "string",
"limit_duplicates": true,
"creator": {"id": "651586fca6078e98982dbd90",
"type": "account"
},
"state": {"current": "new",
"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string"
}
}
}
}

List Latest Jobs

Requires the apionly-jobs-view permission.

SecuritybearerAuth and hubAuth

Responses

200

Returns a list of Jobs.

default

General error response from the platform

get/v1/jobs/latest

Response samples

200
default

application/json

{"data": [{"id": "651586fca6078e98982dbd90",
"hub_id": "651586fca6078e98982dbd90",
"queue": "string",
"caption": "string",
"events": {"queued": "2021-01-30T08:30:00Z",
"completed": "2021-01-30T08:30:00Z",
"started": "2021-01-30T08:30:00Z"
},
"schedule": "2021-01-30T08:30:00Z",
"tasks": [{"id": "651586fca6078e98982dbd90",
"caption": "string",
"header": "string",
"events": {"queued": "2021-01-30T08:30:00Z",
"completed": "2021-01-30T08:30:00Z",
"started": "2021-01-30T08:30:00Z"
},
"steps": [{"caption": "string",
"description": "string",
"started": "2021-01-30T08:30:00Z",
"completed": "2021-01-30T08:30:00Z"
}
],
"state": {"changed": "2021-01-30T08:30:00Z",
"current": "pending"
},
"input": {"property1": null,
"property2": null
},
"output": {"property1": "string",
"property2": "string"
},
"error": {"message": "string"
}
}
],
"expires": "2021-01-30T08:30:00Z",
"hash": "string",
"limit_duplicates": true,
"creator": {"id": "651586fca6078e98982dbd90",
"type": "account"
},
"state": {"current": "new",
"changed": "2021-01-30T08:30:00Z",
"error": {"message": "string"
}
}
}
]
}

➔ Next to Monitoring

Jobs

List Jobs

query Parameters

Filter Field

Get Job

path Parameters

List Latest Jobs