Users

get

Return basic information about user by ID

🔒 Requires the read:users permission

Authorizations

bearerAuth

Path parameters

idstringRequired

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

Example: prov0|1234567890

Responses

200

Information about user

application/json

400

Failed to fetch user information

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the read:users permission

application/json

404

User not found

application/json

429

Too many requests

application/json

get

/api/v1/user/{id}

HTTPcURLJavaScriptPython

GET /api/v1/user/{id} HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "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"
    }
  ],
  "first_name": "John",
  "last_name": "Doe",
  "nickname": "JD",
  "created_at": "2025-11-10T12:19:26.487Z"
}

post

Update roles to user by id

🔒 Requires the update:users permission

Authorizations

bearerAuth

Path parameters

idstringRequired

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

Example: prov0|1234567890

Body

application/json

rolesstring[]RequiredExample: ["rol_abCdeFghIjklMnmP"]

addbooleanOptional

If true, add the new role to an existing one. If false, override an existing role

Responses

200

User roles updated successfully

application/json

400

Failed to update user roles

application/json

401

Failed to authenticate user

application/json

403

Missing required scopes. 🔒 Requires the update:users permission

application/json

404

User not found

application/json

429

Too many requests

application/json

post

/api/v1/user/{id}/roles

HTTPcURLJavaScriptPython

POST /api/v1/user/{id}/roles HTTP/1.1
Host: api.bluebricks.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "roles": [
    "rol_abCdeFghIjklMnmP"
  ],
  "add": true
}

{
  "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,
      "is_active": true,
      "is_deleted": true,
      "created": "2025-11-10T12:19:26.487Z",
      "cloud_account": null
    }
  ]
}