Skip to content
  • Auto
  • Light
  • Dark

List

List builds for a project
get/v0/builds

List builds for a project

Query Parameters
projectstring
optional

Project name

branchstring
optional

Branch name

cursorstring
optional

Pagination cursor from a previous response

limitnumber
optional

Maximum number of builds to return, defaults to 10 (maximum: 100)

exclusiveMinimum0
maximum100
revisionunion
optional
string OR map[object]

A config commit SHA used for the build

Hide ParametersShow Parameters
UnionMember0string

A config commit SHA used for the build

UnionMember1map

Hash of the files used for the build

Hide ParametersShow Parameters
hashstring

File content hash

Returns
dataarray of idstringconfig_commitstringcreated_atstringdocumented_specunionobjectenumorgstringprojectstringtargetsobjectupdated_atstringBuildObject
has_moreboolean
next_cursorstring
optional
curl https://api.stainless.com/v0/builds \
    -H "Authorization: Bearer $STAINLESS_API_KEY"
200 Example
{
  "data": [
    {
      "id": "id",
      "config_commit": "config_commit",
      "created_at": "2019-12-27T18:11:19.117Z",
      "documented_spec": {
        "content": "content",
        "type": "content"
      },
      "object": "build",
      "org": "org",
      "project": "project",
      "targets": {
        "cli": {
          "commit": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "object": "build_target",
          "status": "not_started",
          "test": {
            "status": "not_started"
          },
          "build": {
            "status": "not_started"
          },
          "upload": {
            "status": "not_started"
          }
        },
        "csharp": {
          "commit": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "object": "build_target",
          "status": "not_started",
          "test": {
            "status": "not_started"
          },
          "build": {
            "status": "not_started"
          },
          "upload": {
            "status": "not_started"
          }
        },
        "go": {
          "commit": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "object": "build_target",
          "status": "not_started",
          "test": {
            "status": "not_started"
          },
          "build": {
            "status": "not_started"
          },
          "upload": {
            "status": "not_started"
          }
        },
        "java": {
          "commit": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "object": "build_target",
          "status": "not_started",
          "test": {
            "status": "not_started"
          },
          "build": {
            "status": "not_started"
          },
          "upload": {
            "status": "not_started"
          }
        },
        "kotlin": {
          "commit": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "object": "build_target",
          "status": "not_started",
          "test": {
            "status": "not_started"
          },
          "build": {
            "status": "not_started"
          },
          "upload": {
            "status": "not_started"
          }
        },
        "node": {
          "commit": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "object": "build_target",
          "status": "not_started",
          "test": {
            "status": "not_started"
          },
          "build": {
            "status": "not_started"
          },
          "upload": {
            "status": "not_started"
          }
        },
        "php": {
          "commit": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "object": "build_target",
          "status": "not_started",
          "test": {
            "status": "not_started"
          },
          "build": {
            "status": "not_started"
          },
          "upload": {
            "status": "not_started"
          }
        },
        "python": {
          "commit": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "object": "build_target",
          "status": "not_started",
          "test": {
            "status": "not_started"
          },
          "build": {
            "status": "not_started"
          },
          "upload": {
            "status": "not_started"
          }
        },
        "ruby": {
          "commit": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "object": "build_target",
          "status": "not_started",
          "test": {
            "status": "not_started"
          },
          "build": {
            "status": "not_started"
          },
          "upload": {
            "status": "not_started"
          }
        },
        "terraform": {
          "commit": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "object": "build_target",
          "status": "not_started",
          "test": {
            "status": "not_started"
          },
          "build": {
            "status": "not_started"
          },
          "upload": {
            "status": "not_started"
          }
        },
        "typescript": {
          "commit": {
            "status": "not_started"
          },
          "lint": {
            "status": "not_started"
          },
          "object": "build_target",
          "status": "not_started",
          "test": {
            "status": "not_started"
          },
          "build": {
            "status": "not_started"
          },
          "upload": {
            "status": "not_started"
          }
        }
      },
      "updated_at": "2019-12-27T18:11:19.117Z"
    }
  ],
  "has_more": true,
  "next_cursor": "next_cursor"
}