ESET Online Help

Search
Select the category
Select the topic

POST Batch activate product

Relative path: /v1/mobile-devices:batchActivateProduct

Create product activation task with mobile devices as its targets.

Product is picked automatically based on the parent group of particular device.

The method can fail atomically with:
- PERMISSION_DENIED (gRPC) | 403 Forbidden (HTTP) if the caller cannot does not have rights to create device tasks.
- FAILED_PRECONDITION (gRPC) | 400 Bad Request (HTTP) if
- the devices on input do not share the same parent device group or
- if there is no such subscription with available product on the parent device group.
- NOT_FOUND (gRPC) | 404 Not Found (HTTP) if some of the devices on the input does not exist.

Request body

Display Schema instead of an Example or vice-versa

Type

Required

Example

Schema

application/json

No

{
  "deviceUuids": [
    "string"
  ]
}
{
  "$ref": "v1BatchActivateProductRequest",
  "deviceUuids": [
    {
      "type": "string"
    }
  ]
}


Responses

Display Schema instead of an Example or vice-versa

Code

Description

Example

Schema

200

Successful response.

{
  "activationTaskUuid": "string"
}
{
  "$ref": "v1BatchActivateProductResponse",
  "activationTaskUuid": {
    "type": "string",
    "description": "Reference to [device task]. Note: For more details about product activation tasks see https://help.eset.com/protect_cloud/en-US/client_tasks_product_activation.html type: automation.v1.DeviceTask"
  }
}

202

Response took too long; request cached. Response can be retrieved later using the response-id header.

null
[]

400

One of the errors: 1. Bad or missing authorization. 2. Validation error. Invalid argument provided.

null
[]

401

Token has expired or is invalid.

null
[]

403

Access denied. Check permissions.

null
[]

404

Requested resource not found.

null
[]

429

Rate limit reached. Try again later.

null
[]

500

Internal server failure. Try again later.

null
[]

502

Internal server failure. Try again later.

null
[]

503

Environment under maintenance. Try again later.

null
[]

504

Action took too long; timeout reached

null
[]