Comment on page
Automation Runs
The
automation/runs
namespace provides API methods for automation runs and threads. You can use these methods to retrieve automation runs and threads for a project, create new runs and threads, submit test results (including custom fields, artifacts & links) and finally mark runs and threads as completed.

Returns all automation runs for a project.
This method uses pagination so you might need to request additional pages to retrieve all automation runs.
![]() project_id id required
ID of the project. |
Parameters
Schema
![]() page integer
Number of page to return (default: first page) |
![]() per_page integer
Maximum number of automation runs to return (supported: 15 , 25 , 50 , 100 ; default: 100 ) |
![]() sort string
Sort field for the list of automation runs (supported: automation_runs:created_at ; default: automation_runs:created_at ) |
![]() order string
Sort order (ascending or descending) (supported: asc , desc ; default: desc ) |
![]() config_id string
Comma-separated list of configurations to filter by. |
![]() created_after string
Limit result to automation runs created after (in ISO8601 format and UTC time zone). |
![]() created_before string
Limit result to automation runs created before (in ISO8601 format and UTC time zone). |
![]() created_by string
Comma-separated list of users to filter by. |
![]() milestone_id string
Comma-separated list of milestones to filter by. |
![]() source_id string
Comma-separated list of automation sources to filter by. |
![]() status string
Comma-separated list of statuses to filter by. Use: 2 for success, 3 for failure, 4 for running. |
![]() tags string
Comma-separated list of tags to filter by. |
![]() expands string
Comma-separated list of expands to return. |
"page": {
"type": "integer",
"format": "int64",
"description": "Number of page (default: first page)."
},
"per_page": {
"type": "integer",
"format": "int64",
"enum": [
15,
25,
50,
100
],
"description": "Maximum number of items to return per page (default: 100)."
},
"sort": {
"type": "string",
"enum": [
"automation_runs:created_at"
],
"description": "Sort field for the list of automation runs."
},
"order": {
"type": "string",
"enum": [
"asc",
"desc"
],
"description": "Sort order (ascending or descending)."
},
"config_id": {
"type": "string",
"description": "Comma-separated list of configurations to filter by."
},
"created_after": {
"type": "string",
"format": "date-time",
"description": "Limit result to automation runs created after (in ISO8601 format and UTC time zone)."
},
"created_before": {
"type": "string",
"format": "date-time",
"description": "Limit result to automation runs created before (in ISO8601 format and UTC time zone)."
},
"created_by": {
"type": "string",
"description": "Comma-separated list of users to filter by."
},
"milestone_id": {
"type": "string",
"description": "Comma-separated list of milestones to filter by."
},
"source_id": {
"type": "string",
"description": "Comma-separated list of automation sources to filter by."
},
"status": {
"type": "string",
"description": "Comma-separated list of statuses to filter by. Use: `2` for success, `3` for failure, `4` for running."
},
"tags": {
"type": "string",
"description": "Comma-separated list of tags to filter by."
},
"expands": {
"type": "string",
"description": "Comma-separated list of expands to return."
}
This method supports the following expands so you can automatically include additional information for referenced objects:
automation_sources
configs
milestones
statuses
users
GET /api/v1/projects/1/automation/runs
200 OK
{
"page": 1,
"prev_page": null,
"next_page": 2,
"last_page": 2,
"per_page": 100,
"total": 150,
"result": [
{
"id": 1,
"project_id": 1,
"name": "Run 1",
"status": 2,
..
"is_completed": false,
"untested_count": 0,
"status1_count": 90,
"status2_count": 10,
"status3_count": 0,
"status4_count": 0,
"status5_count": 0,
"status6_count": 0,
"status7_count": 0,
"status8_count": 0,
"status9_count": 0,
"status10_count": 0,
"status11_count": 0,
"status12_count": 0,
"status13_count": 0,
"status14_count": 0,
"status15_count": 0,
"status16_count": 0,
"status17_count": 0,
"status18_count": 0,
"status19_count": 0,
"status20_count": 0,
"status21_count": 0,
"status22_count": 0,
"status23_count": 0,
"status24_count": 0,
"success_count": 90,
"failure_count": 10,
"completed_count": 100,
"total_count": 100,
"thread_count": 8,
"thread_active_count": 2,
"thread_completed_count": 6,
"created_at": "..",
"created_by": 2,
"updated_at": null,
"updated_by": null,
"completed_at": null,
"completed_by": null
},
{
"id": 2,
"project_id": 1,
"name": "Run 2",
"status": 3,
..
"is_completed": true,
"untested_count": 1,
"status1_count": 20,
"status2_count": 5,
"status3_count": 0,
"status4_count": 0,
"status5_count": 0,
"status6_count": 0,
"status7_count": 0,
"status8_count": 0,
"status9_count": 0,
"status10_count": 0,
"status11_count": 0,
"status12_count": 0,
"status13_count": 0,
"status14_count": 0,
"status15_count": 0,
"status16_count": 0,
"status17_count": 0,
"status18_count": 0,
"status19_count": 0,
"status20_count": 0,
"status21_count": 0,
"status22_count": 0,
"status23_count": 0,
"status24_count": 0,
"success_count": 20,
"failure_count": 5,
"completed_count": 25,
"total_count": 26,
"thread_count": 8,
"thread_active_count": 2,
"thread_completed_count": 6,
"created_at": "..",
"created_by": 2,
"updated_at": null,
"updated_by": null,
"completed_at": "..",
"completed_by": 1
},
..
],
"expands": {
..
}
}
// Get latest 100 automation runs for project with ID 5
GET /api/v1/projects/5/automation/runs
// Get second result page (pagination)
GET /api/v1/projects/5/automation/runs?page=2
// Get latest 100 automation runs
GET /api/v1/projects/5/automation/runs