Delete a Firmware

Deletes a firmware.

Request URL

DELETE {base_url}/uc-cautop/api/v1/firmwares/{id}

Request parameters

Headers
Parameter Required Type Description
Authorization Yes String The access token used for authentication.

Format: Bearer {access_token}.
x-tenant-code No String The tenant name.
Note: You can obtain tenant name using the Query Tenants interface.
Path parameters
Parameter Required Type Description
id Yes String The firmware ID. You can obtain the ID using the Search Firmwares interface.

Response parameters

Parameter Type Description
requestId String The unique ID of the request, which can be used to quickly locate the request.
code String The HTTP status code of the request.
  • 200: Request succeeded.
  • Non-200 value: Request failed.
message String The status message of the request.
detailMessage String The detailed error information.

When the request is successful, this parameter returns empty.
result Object<Firmware> The deleted firmware.
Firmware
Parameter Type Description
id String The unique identifier of the firmware.
ucId String The ID of the UC domain that the firmware belongs to.
vendor String The vendor identifier of the phone, for example Yealink, Fanvil, Grandstream.
model String The model of the phone, for example T54W, V65.
firmwareVersion String The firmware version, for example 97.0.0.1.
fileName String The original file name of the firmware file.
fileResourceId String The ID of the file in the resource service.
fileSize String The size of the file, in bytes.
remark String The remark of the firmware.
createdAt String The time when the firmware was created, in Unix timestamp format (seconds).
updatedAt String The time when the firmware was last updated, in Unix timestamp format (seconds).
ownerType String

The owner type of the firmware:

  • admin: Administrator.
  • reseller: Reseller.
ownerId String The ID of the owner.
ownerEmail String The email address of the owner's primary account.
assignTo Object<Assign_To> The assignment configuration of the firmware.
Assign_To
Parameter Type Description
myTenantAssignment Object<My_Tenant_Assignment> The assignment to the admin's own tenant.
resellerAssignment Object<Reseller_Assignment> The assignment to resellers.
My_Tenant_Assignment
Parameter Type Description
enabled Boolean

Whether the resource is assigned to the admin's own tenant.

  • true: Assigned.
  • false: Not assigned.
scope String

The assignment scope. This parameter takes effect only when the value of enabled is true.

  • all: Visible to all tenants directly under the admin.
  • specific: Visible only to the tenants specified by tenantCodes.
tenantCodes Array<String> The list of tenant codes. This parameter takes effect only when the value of scope is specific.
Reseller_Assignment
Parameter Type Description
enabled Boolean

Whether the resource is assigned to resellers.

  • true: Assigned.
  • false: Not assigned.
scope String

The assignment scope. This parameter takes effect only when the value of enabled is true.

  • all: Visible to all resellers except those specified by excludedResellerIds.
  • specific: Visible only to the resellers specified by resellers.
resellers Array<Reseller_Assign_Item> The list of reseller assignments. This parameter takes effect only when the value of scope is specific.
excludedResellerIds Array<String> The list of excluded reseller IDs. This parameter takes effect only when the value of scope is all.
Reseller_Assign_Item
Parameter Type Description
resellerId String The user ID of the reseller.
tenantScope String

The tenant visibility scope under the reseller.

  • all: Visible to all tenants under the reseller.
  • specific: Visible only to the tenants specified by tenantCodes.
tenantCodes Array<String> The list of tenant codes. This parameter takes effect only when the value of tenantScope is specific.