List action runs | Management API Reference

List all action runs

get/v1/projects/{ref}/actions

Returns a paginated list of action runs of the specified project.

OAuth scopes

environment:read

The fine-grained token must include the following permissions to access this endpoint:

action_runs_read

Path parameters

ref
Required
string
Project ref

Query parameters

offset
Optional
number
limit
Optional
number

Response codes

Response (200)

1
[
2
  {
3
    "id": "lorem",
4
    "branch_id": "lorem",
5
    "run_steps": [
6
      {
7
        "name": "clone",
8
        "status": "CREATED",
9
        "created_at": "lorem",
10
        "updated_at": "lorem"
11
      }
12
    ],
13
    "git_config": null,
14
    "workdir": "lorem",
15
    "check_run_id": 42,
16
    "created_at": "lorem",
17
    "updated_at": "lorem"
18
  }
19
]

1
{
2
  "type": "array",
3
  "items": {
4
    "type": "object",
5
    "properties": {
6
      "id": {
7
        "type": "string"
8
      },
9
      "branch_id": {
10
        "type": "string"
11
      },
12
      "run_steps": {
13
        "type": "array",
14
        "items": {
15
          "type": "object",
16
          "properties": {
17
            "name": {
18
              "type": "string",
19
              "enum": [
20
                "clone",
21
                "pull",
22
                "health",
23
                "configure",
24
                "migrate",
25
                "seed",
26
                "deploy"
27
              ]
28
            },
29
            "status": {
30
              "type": "string",
31
              "enum": [
32
                "CREATED",
33
                "DEAD",
34
                "EXITED",
35
                "PAUSED",
36
                "REMOVING",
37
                "RESTARTING",
38
                "RUNNING"
39
              ]
40
            },
41
            "created_at": {
42
              "type": "string"
43
            },
44
            "updated_at": {
45
              "type": "string"
46
            }
47
          },
48
          "required": [
49
            "name",
50
            "status",
51
            "created_at",
52
            "updated_at"
53
          ]
54
        }
55
      },
56
      "git_config": {
57
        "nullable": true
58
      },
59
      "workdir": {
60
        "type": "string",
61
        "nullable": true
62
      },
63
      "check_run_id": {
64
        "type": "number",
65
        "nullable": true
66
      },
67
      "created_at": {
68
        "type": "string"
69
      },
70
      "updated_at": {
71
        "type": "string"
72
      }
73
    },
74
    "required": [
75
      "id",
76
      "branch_id",
77
      "run_steps",
78
      "workdir",
79
      "check_run_id",
80
      "created_at",
81
      "updated_at"
82
    ]
83
  }
84
}