Organization
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-managementorinvitepermissionOrganization plan required (not available for Starter/Scale plans)
Enter your API key with the Bearer prefix, e.g. "Bearer QB_your_api_key_here"
Groups retrieved successfully - Returns array of groups with IDs and names
Unauthorized - Invalid or missing API key
Forbidden - Organization plan required or insufficient permissions
GET /v2/organization/groups HTTP/1.1
Host: api.qubitro.com
Authorization: YOUR_API_KEY
Accept: */*
{
"groups": [
{
"id": "5f8d0d55b54764ca6f3a1234",
"name": "Engineering Team"
}
]
}Retrieves all projects accessible by a specific group
Enter your API key with the Bearer prefix, e.g. "Bearer QB_your_api_key_here"
Group ID
Projects retrieved successfully
Unauthorized
Group not found
GET /v2/organization/groups/{group_id}/projects HTTP/1.1
Host: api.qubitro.com
Authorization: YOUR_API_KEY
Accept: */*
[
{
"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"
]
}
]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:
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-managementpermission in the organizationOrganization plan required (not available for Starter/Scale plans)
User email must be registered on the platform
Role must be a valid organization role ID
Enter your API key with the Bearer prefix, e.g. "Bearer QB_your_api_key_here"
Organization role: "superadmin", "admin", "readwrite", "billingadmin", "readonly", or custom role ID
readwriteInvitation sent successfully - User will receive email notification
Invalid request body - Check email format and role values (must be: superadmin, admin, readwrite, billingadmin, readonly, or custom role ID)
Unauthorized - Invalid or missing API key
Forbidden - Organization plan required or insufficient permissions
POST /v2/organization/invite HTTP/1.1
Host: api.qubitro.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 47
{
"email": "[email protected]",
"role": "readwrite"
}{
"action": "delete device",
"message": "Operation completed successfully",
"success": true
}Last updated