Blues Notehub

Get device environment variables from Blues Notehub

get

Retrieves environment variables for a Blues Notehub device. This endpoint proxies the request to the Blues Notehub API using your organization's stored Notehub PAT credential.

Prerequisites:

• Device must be a Blues Notehub device (source_type: "notehub")

• Organization must have a Notehub PAT credential configured in External Credentials

• API key must have "read" scope permission

How it works:

1. Validates your Qubitro API key and extracts your organization

2. Looks up the Notehub PAT credential stored in your organization's external credentials

3. Fetches the device to get its Notehub device UID

4. Proxies the request to Blues Notehub API

5. Returns the environment variables from Notehub

Authorizations

BearerAuth

AuthorizationstringRequired

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

Path parameters

project_idstringRequired

Project ID (UUID format)

Example: 3e5c0246-c759-48e8-8345-27db13f11ff7

device_idstringRequired

Device ID (UUID format)

Example: dev-abc123

Responses

200

Environment variables retrieved successfully

application/json

400

Device is not a Blues Notehub device

application/json

401

Unauthorized - Invalid or missing API key

application/json

404

Device not found

application/json

424

Notehub PAT credential not configured for this organization

application/json

502

Blues Notehub API returned an error

application/json

get

/v2/projects/{project_id}/devices/{device_id}/blues/environment-variables

HTTPcURLJavaScriptPython

GET /v2/projects/{project_id}/devices/{device_id}/blues/environment-variables HTTP/1.1
Host: api.qubitro.com
Authorization: YOUR_API_KEY
Accept: */*

{
  "environment_variables": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

Set device environment variables in Blues Notehub

put

Sets environment variables for a Blues Notehub device. This endpoint proxies the request to the Blues Notehub API using your organization's stored Notehub PAT credential.

Prerequisites:

• Device must be a Blues Notehub device (source_type: "notehub")

• Organization must have a Notehub PAT credential configured in External Credentials

• API key must have "update" scope permission

• Notehub PAT must have at least "developer" role permissions

How it works:

1. Validates your Qubitro API key and extracts your organization

2. Looks up the Notehub PAT credential stored in your organization's external credentials

3. Fetches the device to get its Notehub device UID

4. Proxies the request to Blues Notehub API to set the environment variables

5. Returns success if the variables were set

Note: Environment variables set via this endpoint will be synchronized to the Notecard device on its next sync with Notehub.

Authorizations

BearerAuth

AuthorizationstringRequired

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

Path parameters

project_idstringRequired

Project ID (UUID format)

Example: 3e5c0246-c759-48e8-8345-27db13f11ff7

device_idstringRequired

Device ID (UUID format)

Example: dev-abc123

Body

application/json

Responses

200

Environment variables set successfully

application/json

actionstringOptional

Action that was performed

Example: delete device

messagestringOptional

Human-readable success message

Example: Operation completed successfully

successbooleanOptional

Operation completed successfully

Example: true

400

Invalid request body or device is not a Blues Notehub device

application/json

401

Unauthorized - Invalid or missing API key

application/json

404

Device not found

application/json

424

Notehub PAT credential not configured for this organization

application/json

502

Blues Notehub API returned an error

application/json

put

/v2/projects/{project_id}/devices/{device_id}/blues/environment-variables

HTTPcURLJavaScriptPython

PUT /v2/projects/{project_id}/devices/{device_id}/blues/environment-variables HTTP/1.1
Host: api.qubitro.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 82

{
  "environment_variables": {
    "firmware_version": "1.2.3",
    "monitoring_interval": "300"
  }
}

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