Git Repositories

get

Return list of active repositories in the organization

🔒 Requires the read:package permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

installation_idstringOptional

App installation ID for the repository

Example: 12345678

Responses

200

List of active repositories

application/json

List of active repositories

statusCodenumberRequiredExample: 200

messagestringRequiredExample: Repositories retrieved successfully

400

Failed to list repositories

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the read:package permission

application/json

404

No active repositories found

application/json

409

Git installation already exists

application/json

429

Too many requests

application/json

get/api/v1/git/repos

GET /api/v1/git/repos HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "statusCode": 200,
  "message": "Repositories retrieved successfully",
  "repos": [
    {
      "provider": "github",
      "repo": "organization/repository",
      "installationId": "12345678",
      "createdBy": {
        "id": "prov0|1234567890",
        "name": "John Doe",
        "nickname": "JD",
        "picture": "https://example.com/profile.jpg"
      },
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": null,
      "isActive": true,
      "triggers": [
        {
          "id": "123e4567-e89b-12d3-a456-42661417400",
          "git_ref": "main",
          "path": "path/to/subdirectory",
          "createdAt": "2026-01-01T00:00:00.000Z",
          "updatedAt": null,
          "isActive": true
        }
      ],
      "publisherJobId": "123e4567-e89b-12d3-a456-42661417400"
    }
  ]
}

post

Register a new trigger for the git repository

🔒 Requires the create:package permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

installation_idstringRequired

App installation ID for the repository

Example: 12345678

repostringRequired

Repository name with owner

Example: organization/repository

git_refstringRequired

The git branch name the package was created from

Example: main

pathstringRequired

The git subdirectory path of the package repository

Example: path/to/subdirectory

packagestringOptional

The package name e.g. @bluebricks/aws-vpc

Example: @bluebricks/aws-vpc

Responses

200

Trigger registered successfully

application/json

Trigger registered successfully

providerstring · enumRequired

Git provider type

Example: githubPossible values:

repostringRequired

Repository name with owner

Example: organization/repository

installationIdstring · nullableRequired

App installation ID for the repository

Example: 12345678

createdAtstring · date-timeRequired

The date and time the resource was created e.g. 2022-01-01T00:00:00.000Z

updatedAtstring · nullableRequired

The date and time the resource was updated e.g. 2022-01-01T00:00:00.000Z

isActivebooleanRequired

Indicates if the repository is active

Example: true

publisherJobIdstring · uuidOptional

Unique identifier for the publisher status stream job

Example: 123e4567-e89b-12d3-a456-42661417400

400

Failed to register trigger

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the create:package permission

application/json

404

No active git configurations found or repository does not exist

application/json

409

Trigger already exists

application/json

429

Too many requests

application/json

post/api/v1/git/register

POST /api/v1/git/register HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 142

{
  "installation_id": "12345678",
  "repo": "organization/repository",
  "git_ref": "main",
  "path": "path/to/subdirectory",
  "package": "@bluebricks/aws-vpc"
}

{
  "provider": "github",
  "repo": "organization/repository",
  "installationId": "12345678",
  "createdBy": {
    "id": "prov0|1234567890",
    "name": "John Doe",
    "nickname": "JD",
    "picture": "https://example.com/profile.jpg"
  },
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": null,
  "isActive": true,
  "triggers": [
    {
      "id": "123e4567-e89b-12d3-a456-42661417400",
      "git_ref": "main",
      "path": "path/to/subdirectory",
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": null,
      "isActive": true
    }
  ],
  "publisherJobId": "123e4567-e89b-12d3-a456-42661417400"
}

put

Activate git trigger

🔒 Requires the create:package permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

triggerIdstring · uuidRequired

Unique identifier for the git trigger

Example: 123e4567-e89b-12d3-a456-42661417400

Responses

200

Updated trigger information for the git repository

application/json

Updated trigger information for the git repository

providerstring · enumRequired

Git provider type

Example: githubPossible values:

repostringRequired

Repository name with owner

Example: organization/repository

installationIdstring · nullableRequired

App installation ID for the repository

Example: 12345678

createdAtstring · date-timeRequired

The date and time the resource was created e.g. 2022-01-01T00:00:00.000Z

updatedAtstring · nullableRequired

The date and time the resource was updated e.g. 2022-01-01T00:00:00.000Z

isActivebooleanRequired

Indicates if the repository is active

Example: true

publisherJobIdstring · uuidOptional

Unique identifier for the publisher status stream job

Example: 123e4567-e89b-12d3-a456-42661417400

400

Failed to activate trigger

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the create:package permission

application/json

404

Trigger not found

application/json

429

Too many requests

application/json

put/api/v1/git/trigger

PUT /api/v1/git/trigger HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "triggerId": "123e4567-e89b-12d3-a456-42661417400"
}

{
  "provider": "github",
  "repo": "organization/repository",
  "installationId": "12345678",
  "createdBy": {
    "id": "prov0|1234567890",
    "name": "John Doe",
    "nickname": "JD",
    "picture": "https://example.com/profile.jpg"
  },
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": null,
  "isActive": true,
  "triggers": [
    {
      "id": "123e4567-e89b-12d3-a456-42661417400",
      "git_ref": "main",
      "path": "path/to/subdirectory",
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": null,
      "isActive": true
    }
  ],
  "publisherJobId": "123e4567-e89b-12d3-a456-42661417400"
}

delete

Deactivate git trigger

🔒 Requires the create:package permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

triggerIdstring · uuidRequired

Unique identifier for the git trigger

Example: 123e4567-e89b-12d3-a456-42661417400

Responses

200

Updated trigger information for the git repository

application/json

Updated trigger information for the git repository

providerstring · enumRequired

Git provider type

Example: githubPossible values:

repostringRequired

Repository name with owner

Example: organization/repository

installationIdstring · nullableRequired

App installation ID for the repository

Example: 12345678

createdAtstring · date-timeRequired

The date and time the resource was created e.g. 2022-01-01T00:00:00.000Z

updatedAtstring · nullableRequired

The date and time the resource was updated e.g. 2022-01-01T00:00:00.000Z

isActivebooleanRequired

Indicates if the repository is active

Example: true

publisherJobIdstring · uuidOptional

Unique identifier for the publisher status stream job

Example: 123e4567-e89b-12d3-a456-42661417400

400

Failed to deactivate trigger

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the create:package permission

application/json

404

Trigger not found

application/json

429

Too many requests

application/json

delete/api/v1/git/trigger

DELETE /api/v1/git/trigger HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "triggerId": "123e4567-e89b-12d3-a456-42661417400"
}

{
  "provider": "github",
  "repo": "organization/repository",
  "installationId": "12345678",
  "createdBy": {
    "id": "prov0|1234567890",
    "name": "John Doe",
    "nickname": "JD",
    "picture": "https://example.com/profile.jpg"
  },
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": null,
  "isActive": true,
  "triggers": [
    {
      "id": "123e4567-e89b-12d3-a456-42661417400",
      "git_ref": "main",
      "path": "path/to/subdirectory",
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": null,
      "isActive": true
    }
  ],
  "publisherJobId": "123e4567-e89b-12d3-a456-42661417400"
}

post

Return git credentials for the publisher within the organization

🔒 Requires the read:package permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

git_remote_urlstringOptional

The git remote url of the package repository

Example: https://github.com/username/repository.git

Responses

200

Git credentials for the publisher within the organization

application/json

Git credentials for the publisher within the organization

organizationstringRequired

The organization ID

Example: org_abCdeFghIjklMnmP

git_remote_urlstringOptional

The git remote url of the package repository

Example: https://github.com/username/repository.git

installation_idstringRequired

App installation ID for the repository

Example: 12345678

400

Failed to get git credentials

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the read:package permission

application/json

404

No active git configurations found

application/json

429

Too many requests

application/json

post/api/v1/git-credentials

POST /api/v1/git-credentials HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 63

{
  "git_remote_url": "https://github.com/username/repository.git"
}

{
  "credentials": {
    "token": "text",
    "type": "text",
    "expiration": "2025-04-07T11:00:00Z"
  },
  "organization": "org_abCdeFghIjklMnmP",
  "git_remote_url": "https://github.com/username/repository.git",
  "installation_id": "12345678"
}