Update a trial activation

Updates the specified trial activation by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

PATCH/v3/trial-activations/{id}

Parameters

Name	Type	In	Description
id*	string	path	Unique identifier for the trial activation.

Request Body Schema

Property	Type	Description	Constraints
os*	string	Name of the operating system.	enum: [windows, linux, macos, android, ios]
osVersion	string	Version of the operating system.	min: 0, max: 256
fingerprint*	string	Fingerprint of the machine.	min: 64, max: 1024
vmName	string	Name of the virtual machine.	min: 0, max: 256
container	boolean	Whether app is run inside a container.
hostname*	string	Name of the host machine.	min: 1, max: 1024
userHash*	string	Hash of the machine user name.	min: 1, max: 256
productId*	string	Unique identifier for the product.	min: 1, max: 256
accountId*	string	Unique identifier for the account.	min: 0, max: 256
releaseVersion	string	The release version of the app. Only following three formats are allowed x.x, x.x.x, x.x.x.x.	min: 0, max: 256
releaseChannel	string	The release channel of the app.	min: 0, max: 256
releasePlatform	string	The release platform of the app.	min: 0, max: 256
releasePublishedAt	string	This release published date (UTC) of the app.	format: date-time
metadata	array	List of metdata key/value pairs.	items: object
key*	string	Name of the key.	min: 1, max: 256
value*	string	Value of the key.	min: 0, max: 4096

Request Example

{
  "os": "windows",
  "osVersion": "string",
  "fingerprint": "stringstringstringstringstringstringstringstringstringstringstri",
  "vmName": "string",
  "container": true,
  "hostname": "string",
  "userHash": "string",
  "productId": "string",
  "accountId": "string",
  "releaseVersion": "string",
  "releaseChannel": "string",
  "releasePlatform": "string",
  "releasePublishedAt": "2019-08-24T14:15:22Z",
  "metadata": [
    {
      "key": "string",
      "value": "string"
    }
  ]
}

Triggers webhook: trialActivation.updated

POST <your-webhook-url>
{
  "event": "trialActivation.updated",
  "data": {
    "id": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "os": "windows",
    "osVersion": "string",
    "hostname": "string",
    "location": {
      "ipAddress": "string",
      "countryCode": "string",
      "countryName": "string",
      "regionCode": "string",
      "regionName": "string",
      "city": "string",
      "zipCode": "string",
      "timeZone": "string",
      "latitude": 0.1,
      "longitude": 0.1
    },
    "vmName": "string",
    "container": true,
    "appVersion": "string",
    "releaseVersion": "string",
    "releaseChannel": "string",
    "releasePlatform": "string",
    "offline": true,
    "productId": "string",
    "expiresAt": "2019-08-24T14:15:22Z",
    "metadata": [
      {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "key": "string",
        "value": "string"
      }
    ]
  },
  "triggeredAt": "string"
}

Responses

200

400

404

429

500

200 OK

{
  "trialActivationToken": "string"
}