How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Blues project API

Project operations

Blues project API is one of 14 APIs that Blues publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 11 JSON Schema definitions.

Tagged areas include Project. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 11 JSON Schemas.

This API exposes 45 operations across 30 paths, and defines 28 schemas. It is described by OpenAPI 3.0.3, at version 1.2.0.

Requests are made against a single base URL, https://api.notefile.net.

45 operations 30 paths 28 schemas 8 DELETE21 GET10 POST6 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.2.0
Base URL
https://api.notefile.net
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Blues project API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (personalAccessToken).

  • personalAccessToken — Use a personal access token from notehub.io/api-access

Paths & Operations 45

Across 30 paths, the API surfaces 45 operations — 8 DELETE, 21 GET, 10 POST, 6 PUT. Each is listed below with its method, path, parameters, and response codes.

project 45

Project operations

GET
/v1/products/{productUID}/project
Get a Project by ProductUID
GetProjectByProduct 1 param → 200default
GET
/v1/projects
Get Projects accessible by the apikey
GetProjects → 200default
POST
/v1/projects
Create a Project
CreateProject body → 201default
DELETE
/v1/projects/{projectOrProductUID}
Delete a Project by ProjectUID
DeleteProject 1 param → 200default
GET
/v1/projects/{projectOrProductUID}
Get a Project by ProjectUID
GetProject 1 param → 200default
GET
/v1/projects/{projectOrProductUID}/aws-role-config
Get AWS role configuration for role-based authentication
GetAWSRoleConfig 1 param → 200default
POST
/v1/projects/{projectOrProductUID}/clone
Clone a Project
CloneProject 1 param body → 201default
GET
/v1/projects/{projectOrProductUID}/devices/{deviceUID}/dfu/{firmwareType}/history
Get device DFU history for host or Notecard firmware
GetDeviceDfuHistory 3 params → 200default
GET
/v1/projects/{projectOrProductUID}/devices/{deviceUID}/dfu/{firmwareType}/status
Get device DFU history for host or Notecard firmware
GetDeviceDfuStatus 3 params → 200default
DELETE
/v1/projects/{projectOrProductUID}/devices/{deviceUID}/fleets
Remove Device from Fleets
DeleteDeviceFromFleets 2 params body → 200default
GET
/v1/projects/{projectOrProductUID}/devices/{deviceUID}/fleets
Get Device Fleets
GetDeviceFleets 2 params → 200default
PUT
/v1/projects/{projectOrProductUID}/devices/{deviceUID}/fleets
Add Device to Fleets
AddDeviceToFleets 2 params body → 200default
POST
/v1/projects/{projectOrProductUID}/dfu/{firmwareType}/{action}
Update/cancel host or notecard firmware updates
PerformDfuAction 12 params body → 200default
GET
/v1/projects/{projectOrProductUID}/dfu/{firmwareType}/history
Get host or Notecard DFU history for all devices that match the filter criteria
GetDevicesDfuHistory 15 params → 200default
GET
/v1/projects/{projectOrProductUID}/dfu/{firmwareType}/status
Get host or Notecard DFU history for all devices that match the filter criteria
GetDevicesDfuStatus 15 params → 200default
GET
/v1/projects/{projectOrProductUID}/environment_hierarchy
Get environment variable hierarchy for a device
GetProjectEnvironmentHierarchy 1 param → 200404500
GET
/v1/projects/{projectOrProductUID}/environment_variables
Get environment variables of a project
GetProjectEnvironmentVariables 1 param → 200default
PUT
/v1/projects/{projectOrProductUID}/environment_variables
Set environment variables of a project
SetProjectEnvironmentVariables 1 param body → 200default
DELETE
/v1/projects/{projectOrProductUID}/environment_variables/{key}
Delete an environment variable of a project by key
DeleteProjectEnvironmentVariable 2 params → 200default
GET
/v1/projects/{projectOrProductUID}/firmware
Get Available Firmware Information
GetFirmwareInfo 10 params → 200default
DELETE
/v1/projects/{projectOrProductUID}/firmware/{firmwareType}/{filename}
Delete a host firmware binary. The filename must be the full stored filename including the timestamp suffix (e.g. test$20260324190911.bin) as returned by the firmware upload or list endpoints.
DeleteFirmware 3 params → 204default
GET
/v1/projects/{projectOrProductUID}/firmware/{firmwareType}/{filename}
Download firmware binary
DownloadFirmware 3 params → 200default
POST
/v1/projects/{projectOrProductUID}/firmware/{firmwareType}/{filename}
Update the metadata of an existing host firmware entry. The filename must be the full stored filename including the timestamp suffix (e.g. test$20260324190911.bin) as returned by the firmware upload…
UpdateFirmware 3 params body → 200default
PUT
/v1/projects/{projectOrProductUID}/firmware/{firmwareType}/{filename}
Upload firmware binary
UploadFirmware 5 params body → 200default
GET
/v1/projects/{projectOrProductUID}/fleets
Get Project Fleets
GetFleets 1 param → 200default
POST
/v1/projects/{projectOrProductUID}/fleets
Create Fleet
CreateFleet 1 param body → 201default
DELETE
/v1/projects/{projectOrProductUID}/fleets/{fleetUID}
Delete Fleet
DeleteFleet 2 params → 204default
GET
/v1/projects/{projectOrProductUID}/fleets/{fleetUID}
Get Fleet
GetFleet 2 params → 200
PUT
/v1/projects/{projectOrProductUID}/fleets/{fleetUID}
Update Fleet
UpdateFleet 2 params body → 200default
GET
/v1/projects/{projectOrProductUID}/fleets/{fleetUID}/environment_hierarchy
Get environment variable hierarchy for a device
GetFleetEnvironmentHierarchy 2 params → 200404500
GET
/v1/projects/{projectOrProductUID}/fleets/{fleetUID}/environment_variables
Get environment variables of a fleet
GetFleetEnvironmentVariables 2 params → 200default
PUT
/v1/projects/{projectOrProductUID}/fleets/{fleetUID}/environment_variables
Set environment variables of a fleet
SetFleetEnvironmentVariables 2 params body → 200default
DELETE
/v1/projects/{projectOrProductUID}/fleets/{fleetUID}/environment_variables/{key}
Delete environment variables of a fleet
DeleteFleetEnvironmentVariable 3 params → 200default
POST
/v1/projects/{projectOrProductUID}/global-transformation
Set the project-level event JSONata transformation
SetGlobalEventTransformation 1 param body → 200default
POST
/v1/projects/{projectOrProductUID}/global-transformation/disable
Disable the project-level event JSONata transformation
DisableGlobalEventTransformation 1 param → 200default
POST
/v1/projects/{projectOrProductUID}/global-transformation/enable
Enable the project-level event JSONata transformation
EnableGlobalEventTransformation 1 param → 200default
GET
/v1/projects/{projectOrProductUID}/members
Get Project Members
GetProjectMembers 1 param → 200default
GET
/v1/projects/{projectOrProductUID}/products
Get Products within a Project
GetProducts 1 param → 200default
POST
/v1/projects/{projectOrProductUID}/products
Create Product within a Project
CreateProduct 1 param body → 201default
DELETE
/v1/projects/{projectOrProductUID}/products/{productUID}
Delete a product
DeleteProduct 2 params → 204default
GET
/v1/projects/{projectOrProductUID}/schemas
Get variable format for a notefile
GetNotefileSchemas 1 param → 200
GET
/v1/projects/{projectOrProductUID}/secrets
Get all secrets for a project (metadata only, values are never returned)
GetProjectSecrets 1 param → 200default
POST
/v1/projects/{projectOrProductUID}/secrets
Create a new project secret
CreateProjectSecret 1 param body → 201400409default
DELETE
/v1/projects/{projectOrProductUID}/secrets/{secretName}
Delete a project secret by name
DeleteProjectSecret 2 params → 204404default
PUT
/v1/projects/{projectOrProductUID}/secrets/{secretName}
Update the value of an existing project secret
UpdateProjectSecret 2 params body → 200404default

Schemas 28

The contract defines 28 schemas that model the data the API accepts and returns. The most detailed are FirmwareInfo (14 properties), EnvTreeJsonNode (11 properties), Fleet (8 properties), Error (6 properties). Each schema is shown below with its type and property counts.

ProjectSecret
object
Metadata for a project secret. The value is never returned.
5 properties 3 required
DeviceDfuStateMachine
object
Represents a single request to update the host or Notecard firmware
4 properties
SchemaProperty
object
5 properties 2 required
UpdateProjectSecretRequest
object
1 property 1 required
FleetRule
string
JSONata expression that will be evaluated to determine device membership into this fleet, if the expression evaluates to a 1, the device will be included, if i…
Error
object
6 properties 3 required
Product
object
4 properties 3 required
GetProjectSecretsResponse
object
1 property 1 required
Fleet
object
8 properties 3 required
EnvironmentVariables
object
1 property 1 required
NotefileSchema
object
2 properties 2 required
CreateProjectSecretRequest
object
2 properties 2 required
FleetConnectivityAssurance
object
1 property
Project
object
6 properties 3 required
AWSRoleConfig
object
Configuration needed to set up an IAM role trust policy for role-based authentication on AWS routes
2 properties 2 required
EnvTreeJsonNode
object
11 properties 5 required
DeviceDfuStatus
object
4 properties
Contact
object
4 properties
EnvVar
object
4 properties
DeviceDfuHistoryPage
object
2 properties
Role
string
DeviceDfuHistory
object
3 properties
DfuActionRequest
object
1 property
UpdateHostFirmwareRequest
object
Request body for updating host firmware metadata. All fields are optional; only provided fields will be updated.
3 properties
FirmwareInfo
object
14 properties
ProjectMember
object
3 properties 3 required
DeviceDfuStatusPage
object
2 properties
DeviceDfuStateMachineNode
object
Represents a single request to update the host or Notecard firmware
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

blues-wireless-project-api-openapi.yml Raw ↑

Other APIs Blues publishes across the network.

Notecard API
Blues alert API
Blues authorization API
Blues billing_account API
Blues device API
Blues event API
Blues external devices API
Blues jobs API
Blues monitor API
Blues organization API
Blues route API
Blues usage API
Where this information came from

This is an independent, third-party profile of Blues project API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.