# Protected branches

You can define a list of protected branch names on a repository. Names can use wildcards (`*`).

## References

- v4 API:
  - `gitlab.v4.objects.ProjectProtectedBranch`
  - `gitlab.v4.objects.ProjectProtectedBranchManager`
  - `gitlab.v4.objects.Project.protectedbranches`
- GitLab API: https://docs.gitlab.com/ce/api/protected_branches.html#protected-branches-api

## Examples

Get the list of protected branches for a project:

    p_branches = project.protectedbranches.list()

Get a single protected branch:

    p_branch = project.protectedbranches.get('master')

Create a protected branch:

    p_branch = project.protectedbranches.create({'name': '*-stable'})

Delete a protected branch:

    project.protectedbranches.delete('*-stable')
    # or
    p_branch.delete()