Project Groups

Changed on
put/project-groups/{group_id}/repository

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/project-groups/{group_id}/repository
  • Auth: HTTP bearer

Path parameters

group_idinteger required

Project group ID

Request body

git_provider_connection_idinteger nullable

The connection to read the repository through. Set exactly one of this and public_provider.

main_branchstring required
public_providerstring nullable

github or gitlab, to use a public repository without a connection. Pushes to it cannot trigger deploys.

repo_namestring required
repo_ownerstring required

Example request

{
  "main_branch": "main",
  "public_provider": "github",
  "repo_name": "shop",
  "repo_owner": "acme"
}

Response

Repository set and written through to every project that follows it; see services for per-project outcomes

Example response

{
  "group": {
    "created_at": "2026-09-28T12:15:47.609192Z",
    "projects": [
      {
        "directory": "apps/web",
        "last_deployment": "2026-09-28T12:15:47.609192Z",
        "main_branch": "main"
      }
    ],
    "repository": {
      "main_branch": "main",
      "public_provider": "github",
      "repo_name": "shop",
      "repo_owner": "acme"
    },
    "updated_at": "2026-09-28T12:15:47.609192Z"
  }
}

Changes