Creates new release
POSThttps://apis.<domain>/iot/firmwares/:firmwareId/releases
Creates a new firmware release version
Authorization Action:
core:firmwares:createRelease
Request
Path Parameters
firmwareId stringrequired
Firmware identifier
- multipart/form-data
Bodyrequired
versionstringrequired
notestring
mandatoryboolean
Default value:
falsemin_versionstring
max_versionstring
filenamestringrequired
binstring<binary>required
Responses
- 201
- 400
- 401
- 403
- 404
- 415
- 500
Release details
- application/json
- Schema
- Example (auto)
Schema
idstring
Unique release identifier
versionstring
Version number
notestring
Release notes
mandatoryboolean
Whether update is mandatory
min_versionstring
Minimum version that can update to this
max_versionstring
Maximum version that can update to this
filenamestring
Original firmware file name
sizeinteger
File size in bytes
checksumstring
File checksum
created_atstring<date-time>
updated_atstring<date-time>
updated_bystring
ID of user who last updated
{
"id": "string",
"version": "string",
"note": "string",
"mandatory": true,
"min_version": "string",
"max_version": "string",
"filename": "string",
"size": 0,
"checksum": "string",
"created_at": "2024-07-29T15:51:28.071Z",
"updated_at": "2024-07-29T15:51:28.071Z",
"updated_by": "string"
}
Failed due to malformed request
Missing or invalid access token provided
User not authorized to create release
Firmware not found
Missing or invalid content type
Unexpected server-side error occurred
Authorization: http
name: bearerAuthtype: httpscheme: bearerdescription: * Users access: `Authorization: Bearer <user_token>`
- csharp
- curl
- dart
- go
- http
- java
- javascript
- kotlin
- c
- nodejs
- objective-c
- ocaml
- php
- powershell
- python
- r
- ruby
- rust
- shell
- swift
- HTTPCLIENT
- RESTSHARP
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://apis.<domain>/iot/firmwares/:firmwareId/releases");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var content = new StringContent(string.Empty);
content.Headers.ContentType = new MediaTypeHeaderValue("multipart/form-data");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());