Skip to content
FeedbackDashboard

List project branches

BranchListPage projects().branches().list(BranchListParamsparams = BranchListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())
get/v0/projects/{project}/branches

Retrieve a project branch by name.

ParametersExpand Collapse
BranchListParams params
Optional<String> project
Optional<String> cursor

Pagination cursor from a previous response

Optional<Double> limit

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

exclusiveMinimum0
maximum100
ReturnsExpand Collapse
class BranchListResponse:

A project branch names a line of development for a project. Like a Git branch, it points to a Git commit with a set of config files. In addition, a project branch also points to a set of custom code changes, corresponding to Git branches in the staging repos.

String branch

Branch name

ConfigCommit configCommit

A Git commit that points to the latest set of config files on a given branch.

Repo repo
String branch
String name
String owner
String sha
String latestBuildId
Object object_
String org
String project

Project name

List project branches
package com.configure_me_stainless_v0.api.example;

import com.configure_me_stainless_v0.api.client.StainlessClient;
import com.configure_me_stainless_v0.api.client.okhttp.StainlessOkHttpClient;
import com.configure_me_stainless_v0.api.models.projects.branches.BranchListPage;
import com.configure_me_stainless_v0.api.models.projects.branches.BranchListParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        StainlessClient client = StainlessOkHttpClient.fromEnv();

        BranchListPage page = client.projects().branches().list();
    }
}
{
  "data": [
    {
      "branch": "branch",
      "config_commit": {
        "repo": {
          "branch": "branch",
          "name": "name",
          "owner": "owner"
        },
        "sha": "sha"
      },
      "latest_build_id": "latest_build_id",
      "object": "project_branch",
      "org": "org",
      "project": "project"
    }
  ],
  "has_more": true,
  "next_cursor": "next_cursor"
}
Returns Examples
{
  "data": [
    {
      "branch": "branch",
      "config_commit": {
        "repo": {
          "branch": "branch",
          "name": "name",
          "owner": "owner"
        },
        "sha": "sha"
      },
      "latest_build_id": "latest_build_id",
      "object": "project_branch",
      "org": "org",
      "project": "project"
    }
  ],
  "has_more": true,
  "next_cursor": "next_cursor"
}