Last updated on 8th May 2026

Teams API

These API endpoints allow you to manage teams within your DeployHQ account. Teams provide group-based access control for projects and permissions.

Tip: You can explore and test these endpoints interactively using our OpenAPI documentation.

Permissions

These endpoints require the authenticated user to have the Can manage users permission enabled, or to be an account administrator. Team management must also be enabled on your account's package.

Key Concepts

Project Access Modes

Teams support two project access modes:

  • All Projects (all_projects_allowed: true): Team members can access all current and future projects.
  • Specific Projects (all_projects_allowed: false): Team members can only access projects explicitly assigned to the team via project assignments.

Available Endpoints

  • List Teams
  • View Team
  • Create Team
  • Update Team
  • Delete Team