Get a deployment branch policy

GET

/repos/{owner}/{repo}/environments/{environment_name}/deployment-branch-policies/{branch_policy_id}

Gets a deployment branch or tag policy for an environment.

Anyone with read access to the repository can use this endpoint.

OAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint with a private repository.

API method documentation

Parameters

Path Parameters

owner

required

string

The account owner of the repository. The name is not case sensitive.

repo

required

string

The name of the repository without the .git extension. The name is not case sensitive.

environment_name

required

string

The name of the environment. The name must be URL encoded. For example, any slashes in the name must be replaced with %2F.

branch_policy_id

required

integer

The unique identifier of the branch policy.

Responses

200

Response

Media type application/json

Deployment branch policy

Details of a deployment branch or tag policy.

object

id

The unique identifier of the branch or tag policy.

integer

node_id

string

name

The name pattern that branches or tags must match in order to deploy to the environment.

string

type

Whether this rule targets a branch or tag.

string

Allowed values: branch tag

Examples

Example default

{
  "id": 364662,
  "node_id": "MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjI=",
  "name": "release/*"
}