Organization

get

Return all existing roles in the organization

🔒 Requires the read:organization permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

All existing roles

application/json

400

Bad request

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the read:organization permission

application/json

404

Roles not found

application/json

429

Too many requests

application/json

get

/api/v1/organization/roles

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

[
  {
    "id": "rol_abCdeFghIjklMnmP",
    "name": "Admin",
    "description": "Role for managing Admin permissions"
  }
]

get

Return information about current organization

🔒 Requires the read:organization permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Information about organization

application/json

400

Failed to fetch organization information

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the read:organization permission

application/json

404

Organization not found

application/json

429

Too many requests

application/json

get

/api/v1/organization

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

{
  "id": "org_abCdeFghIjklMnmP",
  "name": "acme-corp",
  "display_name": "ACME Corp.",
  "branding": {
    "logo_url": "https://example.com/logo.png",
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "metadata": {
    "org_status": "paid"
  },
  "is_trial": true,
  "created_at": "2021-01-01T00:00:00Z",
  "trial_started": "2021-01-01T00:00:00Z"
}

patch

Update current organization

🔒 Requires the update:organization permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

namestringOptional

The organization slug, provided by Bluebricks, cannot be changed

Example: acme-corp

display_namestringOptional

The organization display name, can be changed

Example: ACME Corp.

Responses

200

Updated information about organization

application/json

400

Failed to update organization

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the update:organization permission

application/json

429

Too many requests

application/json

patch

/api/v1/organization

PATCH /api/v1/organization HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 173

{
  "name": "acme-corp",
  "display_name": "ACME Corp.",
  "branding": {
    "logo_url": "https://example.com/logo.png",
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "metadata": {
    "org_status": "paid"
  }
}

{
  "id": "org_abCdeFghIjklMnmP",
  "name": "acme-corp",
  "display_name": "ACME Corp.",
  "branding": {
    "logo_url": "https://example.com/logo.png",
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "metadata": {
    "org_status": "paid"
  },
  "is_trial": true,
  "created_at": "2021-01-01T00:00:00Z",
  "trial_started": "2021-01-01T00:00:00Z"
}

get

Return members of current organization

🔒 Requires the read:users permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

limitnumberOptional

Results limit to allow pagination, e.g. 50

Default: 20Example: 10

offsetnumberOptional

Results offset to allow pagination e.g. 10

Default: 0Example: 10

filterstringOptional

Structure: [key1=value1,key2=value2&value3]

searchstringOptional

Enables searching within the list for members that match a particular query. e.g. john

Responses

200

List of organization members

application/json

400

Failed to list organization members

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the read:users permission

application/json

429

Too many requests

application/json

get

/api/v1/organization/members

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

{
  "total": 1,
  "members": [
    {
      "id": "prov0|1234567890",
      "name": "John Doe",
      "email": "[email protected]",
      "picture": "https://example.com/profile.jpg",
      "roles": [
        {
          "id": "rol_abCdeFghIjklMnmP",
          "name": "Admin",
          "description": "Role for managing Admin permissions"
        }
      ],
      "assigned_environments": [
        {
          "id": "f27d96be-c486-4075-a926-0ee96775119e",
          "slug": "production-europe",
          "name": "Production Europe",
          "color": "#0000ff",
          "allow_pre_release": false,
          "is_default": true,
          "enabled_policies": [
            "require_owner_approval"
          ],
          "is_active": true,
          "is_deleted": true,
          "created": "2026-01-10T03:29:27.267Z",
          "cloud_account": null
        }
      ]
    }
  ]
}

post

Invite new members current organization

🔒 Requires the create:users permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

Responses

200

Invite details

application/json

400

Failed to invite new members

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the create:users permission

application/json

429

Too many requests

application/json

post

/api/v1/organization/members

POST /api/v1/organization/members HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "invitees": [
    {
      "email": "[email protected]",
      "role": "rol_abCdeFghIjklMnmP"
    }
  ]
}

{
  "invites": [
    {
      "id": "uinv_abCdeFghIjklMnmP",
      "invitee": "[email protected]",
      "organization_id": "org_abCdeFghIjklMnmP",
      "invitation_url": "https://app.bluebricks.co/sign-in?..."
    }
  ],
  "errors": [
    {
      "email": "[email protected]",
      "statusCode": 404,
      "error": "NOT_FOUND",
      "message": "Role does not exist"
    }
  ]
}

delete

Remove member from current organization

🔒 Requires the delete:users permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

memberIdstringRequired

The user's unique ID e.g. prov0|1234567890

Example: prov0|1234567890

Responses

200

Status of remove request

application/json

400

Failed remove member

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the delete:users permission

application/json

404

Member not found in organization

application/json

429

Too many requests

application/json

delete

/api/v1/organization/members/{memberId}

DELETE /api/v1/organization/members/{memberId} HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "success"
}

get

Return public encryption keys for the organization to encrypt secrets

🔒 Requires the read:organization permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Public key data

application/json

400

Failed to get public key

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the read:organization permission

application/json

404

Public key not found

application/json

429

Too many requests

application/json

get

/api/v1/public-keys

GET /api/v1/public-keys HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "public_key": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...\n-----END PUBLIC KEY-----"
}

post

Create and store managed public key for the organization to encrypt secrets

🔒 Requires the update:organization permission

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

public_keystringRequired

PEM-formatted RSA public key (minimum 2048 bits)

Example: -----BEGIN PUBLIC KEY----- MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA... -----END PUBLIC KEY-----

key_identifierstringRequired

Cloud provider key identifier (AWS KMS ARN, Azure Key Vault URI, or GCP KMS resource name)

Example: arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012

Responses

200

Successfully created public key

application/json

400

Failed to create public key

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the update:organization permission

application/json

404

Public key not found

application/json

409

Public key already exists for organization

application/json

429

Too many requests

application/json

post

/api/v1/public-keys

POST /api/v1/public-keys HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 213

{
  "public_key": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...\n-----END PUBLIC KEY-----",
  "key_identifier": "arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012"
}

{
  "public_key": "-----BEGIN PUBLIC KEY-----\nMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...\n-----END PUBLIC KEY-----",
  "key_identifier": "arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012",
  "created_at": "2026-01-10T03:29:27.267Z",
  "created_by": {
    "id": "prov0|1234567890",
    "name": "John Doe",
    "nickname": "JD",
    "picture": "https://example.com/profile.jpg"
  }
}

PreviousGraph NextPackage

Last updated 1 month ago

Was this helpful?

Good night