Organization

List organization groups

get

Retrieves all groups in your organization. Groups allow you to organize users and manage access permissions at scale.

What are Groups? Groups are collections of users within your organization. They enable centralized permission management for teams, departments, or any logical user grouping.

Use Cases:

• Organize users by department (Engineering, Sales, Operations)

• Grant project access to entire teams at once

• Simplify permission management for large organizations

• Create cross-functional teams with specific access rights

Prerequisites:

• Must have access-management or invite permission

• Organization plan required (not available for Starter/Scale plans)

Authorizations

AuthorizationstringRequired

Enter your API key with the Bearer prefix, e.g. "Bearer QB_your_api_key_here"

Responses

200

Groups retrieved successfully - Returns array of groups with IDs and names

application/json

actionstringOptional

Action that was performed

Example: get blob list

messagestringOptional

Human-readable message (often empty on success)

statusintegerOptional

HTTP status code

Example: 200

successbooleanOptional

Operation completed successfully

Example: true

401

Unauthorized - Invalid or missing API key

application/json

403

Forbidden - Organization plan required or insufficient permissions

application/json

get/v2/organization/groups

GET /v2/organization/groups HTTP/1.1
Host: api.qubitro.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "action": "get blob list",
  "data": {
    "groups": [
      {
        "id": "5f8d0d55b54764ca6f3a1234",
        "name": "Engineering Team"
      }
    ]
  },
  "message": "",
  "status": 200,
  "success": true
}

List projects of a group

get

Retrieves all projects accessible by a specific group

Authorizations

AuthorizationstringRequired

Enter your API key with the Bearer prefix, e.g. "Bearer QB_your_api_key_here"

Path parameters

group_idstringRequired

Group ID

Responses

200

Projects retrieved successfully

application/json

actionstringOptional

Action that was performed

Example: get blob list

messagestringOptional

Human-readable message (often empty on success)

statusintegerOptional

HTTP status code

Example: 200

successbooleanOptional

Operation completed successfully

Example: true

401

Unauthorized

404

Group not found

get/v2/organization/groups/{group_id}/projects

GET /v2/organization/groups/{group_id}/projects HTTP/1.1
Host: api.qubitro.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "action": "get blob list",
  "data": [
    {
      "created_at": "2024-01-15T10:30:00Z",
      "description": "Production environment IoT devices",
      "id": "3e5c0246-c759-48e8-8345-27db13f11ff7",
      "name": "Production IoT Fleet",
      "tags": [
        "production",
        "fleet",
        "monitoring"
      ]
    }
  ],
  "message": "",
  "status": 200,
  "success": true
}

Invite user to organization

post

Invite a user to join your organization with a specified role. The user will receive an email invitation and gain organization access based on their assigned role.

Organization Roles:

Role	Permissions
superadmin	Full control: all permissions including whitelabel, billing, credentials, blueprints, templates, device transfers
admin	Organization management: read, write, credentials, access management, blueprints, templates, device transfers (no billing)
readwrite	Create and edit: read, write, dashboard blueprints, function templates (no access management or credentials)
billingadmin	Billing only: read and manage billing information (limited other access)
readonly	View only: read organization resources (no modifications)

Custom Roles: Organizations can create custom roles with specific permission combinations from the available actions.

Prerequisites:

• Must have access-management permission in the organization

• Organization plan required (not available for Starter/Scale plans)

• User email must be registered on the platform

• Role must be a valid organization role ID

Authorizations

AuthorizationstringRequired

Enter your API key with the Bearer prefix, e.g. "Bearer QB_your_api_key_here"

Body

emailstringOptional

User email address

Example: [e-mail]

rolestringOptional

Organization role: "superadmin", "admin", "readwrite", "billingadmin", "readonly", or custom role ID

Example: readwrite

Responses

200

Invitation sent successfully - User will receive email notification

application/json

actionstringOptional

Action that was performed

Example: delete device

messagestringOptional

Human-readable success message

Example: Operation completed successfully

statusintegerOptional

HTTP status code

Example: 200

successbooleanOptional

Operation completed successfully

Example: true

400

Invalid request body - Check email format and role values (must be: superadmin, admin, readwrite, billingadmin, readonly, or custom role ID)

application/json

401

Unauthorized - Invalid or missing API key

application/json

403

Forbidden - Organization plan required or insufficient permissions

application/json

post/v2/organization/invite

POST /v2/organization/invite HTTP/1.1
Host: api.qubitro.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "email": "[e-mail]",
  "role": "readwrite"
}

{
  "action": "delete device",
  "message": "Operation completed successfully",
  "status": 200,
  "success": true
}