Users

get

Return information about the current user (based on JWT token) including permissions

🔒 Requires the read:users permission

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Information about the current user with permissions

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/me

HTTPcURLJavaScriptPython

GET /api/v1/user/me 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",
  "role": {
    "id": "rol_abCdeFghIjklMnmP",
    "name": "Admin",
    "description": "Role for managing Admin permissions"
  },
  "first_name": "John",
  "last_name": "Doe",
  "nickname": "JD",
  "created_at": "2026-01-10T03:46:10.205Z",
  "permissions": [
    "read:users"
  ],
  "pylonEmailHash": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6"
}

get

Return basic information about user by ID

🔒 Requires the read:users permission

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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": "2026-01-10T03:46:10.205Z"
}

post

Update roles to user by id

🔒 Requires the update:users permission

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

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,
      "enabled_policies": [
        "require_owner_approval"
      ],
      "is_active": true,
      "is_deleted": true,
      "created": "2026-01-10T03:46:10.205Z",
      "cloud_account": null
    }
  ]
}