Some endpoints are able to return more data than they normally do by expanding their response. When this is possible the endpoint will specify the expand
field and will document which fields can be expanded. The expand field takes an array of string field names that identify which fields you wish to expand.
To expand a single field, you may specify it as part of the query.
For example:
/example-endpoint?expand[]=bar
This will cause the bar
key and its value to be included in the response. If bar
itself has expandable fields, see path expands.
If the field you wish to expand is not a top level key within the response, you may specify it using dot notation.
For example:
/example-endpoint?expand[]=foo.bar
If foo
itself is not an expandable field, this will work like a normal field expand. The bar
key and its value will be included in the response nested under the foo
key.
If foo
is an expandable field, see nested expands.
To expand more than one field, you may add additional expands to the query.
For example:
/example-endpoint?expand[]=bar&expand[]=baz
If you are already expanding a field, foo
, and it has its own expandable field(s), bar
, you may additionally expand bar as follows.
/example-endpoint?expand[]=foo&expand[]=foo.bar
The foo
key and its value will be included in the response. Additionally, The bar
key and its value will be included in the response nested under the foo
key.
If you wish to expand the bar
key, but are not interested in the other keys on foo
, see granular expands.
If foo
is an expandable field whose keys you are not interested in except for its own expandable field bar
, you may do the following.
/example-endpoint?expand[]=foo.bar
The foo
key will exist, but its value will only have the bar
key, discluding all other sibling keys you did not explicitly ask for.
Some endpoints specify a search
parameter. The value of this parameter must be a string that
contains a valid query as defined by this search query language.
A query consists of at least one and at most five clauses joined by the and
keyword.
For example:
inserted_at>='2023-01-01T00:00:00Z' and description~'east blue'
A clause consists of a key, an operator, and a value.
For example:
inserted_at>='2023-01-01T00:00:00Z'
When performing a search, the set of valid keys is defined by the relevant endpoint's search
parameter's documentation.
Each key an endpoint specifies as searchable will be associated with a set of operators that are valid to use with it. Below are all possible operators and their associated operation:
Keyword | Operation |
---|---|
: |
equals (case-sensitive) |
- |
substring (case-insensitive) |
~ |
substring (case-sensitive) |
< |
less than |
<= |
less than or equal to |
> |
greater than |
>= |
greater than or equal to |
Each key will specify which type of value it acepts.
You must use single quotes when supplying a string. You can escape single quotes inside of
single quotes with a backslash (\
).
For example:
summary~'zoro\'s three sword style'
Boolean values are supplied either true
or false
without single quotes.
For example:
archived:true
You must use single quotes when supplying a date-time and you must use the following
representation: '[YYYY]-[MM]-[DD]T[HH]:[MM]:[SS]Z'
. The timezone is always UTC.
For example:
inserted_at:'2023-01-01T00:00:00Z'
Numeric values are supplied as-is without single quotes.
For example:
berries:100000000
string <email> (email) | |
password required | string (user-password) |
username required | string |
{- "email": "user@example.com",
- "password": "string",
- "username": "string"
}
{- "data": {
- "email": "user@example.com",
- "username": "string"
}
}
custom_metadata | object (custom-metadata-artifact) <= 1000000 characters A JSON object that informs the metadata that will be associated with this artifact's binaries when they are included in bundles. Max size is 1,000,000 bytes (1 MB). |
description | string (artifact-description) [ 1 .. 256 ] characters |
id | string (custom-id) A user provided custom UUID id for the resource database record. This overrides peridio's autogenerated ID for the user provided one. Use with caution. |
name required | string (artifact-name) [ 1 .. 128 ] characters |
{- "custom_metadata": { },
- "description": "string",
- "id": "string",
- "name": "string"
}
{- "artifact": {
- "custom_metadata": { },
- "description": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "name": "string",
- "organization_prn": "string",
- "prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
Search
This resource has the following searchable fields.
Key | Required | Operators | Value |
---|---|---|---|
description |
: , ~ |
string | |
inserted_at |
: , > , >= , < , <= |
date-time | |
name |
: , ~ , - |
string | |
prn |
: |
string | |
updated_at |
: , > , >= , < , <= |
date-time |
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. |
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by |
search | string A search query per the search query language. |
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
{- "artifacts": [
- {
- "custom_metadata": { },
- "description": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "name": "string",
- "organization_prn": "string",
- "prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_page": "string"
}
artifact_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "artifact": {
- "custom_metadata": { },
- "description": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "name": "string",
- "organization_prn": "string",
- "prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
artifact_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
custom_metadata | object (custom-metadata-artifact) <= 1000000 characters A JSON object that informs the metadata that will be associated with this artifact's binaries when they are included in bundles. Max size is 1,000,000 bytes (1 MB). |
description | string (artifact-description) [ 1 .. 256 ] characters |
name | string (artifact-name) [ 1 .. 128 ] characters |
{- "custom_metadata": { },
- "description": "string",
- "name": "string"
}
{- "artifact": {
- "custom_metadata": { },
- "description": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "name": "string",
- "organization_prn": "string",
- "prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
artifact_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
artifact_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
custom_metadata | object (custom-metadata-artifact-version) <= 1000000 characters A JSON object that informs the metadata that will be associated with this artifact version's binaries when they are included in bundles. Max size is 1,000,000 bytes (1 MB). |
description | string (artifact-version-description) [ 1 .. 256 ] characters |
id | string (custom-id) A user provided custom UUID id for the resource database record. This overrides peridio's autogenerated ID for the user provided one. Use with caution. |
version required | string (artifact-version-version) [ 1 .. 128 ] characters |
{- "artifact_prn": "string",
- "custom_metadata": { },
- "description": "string",
- "id": "string",
- "version": "string"
}
{- "artifact_version": {
- "artifact_prn": "string",
- "custom_metadata": { },
- "description": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "organization_prn": "string",
- "prn": "string",
- "version": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
Search
This resource has the following searchable fields.
Key | Required | Operators | Value |
---|---|---|---|
artifact_prn |
: |
string | |
description |
: , ~ |
string | |
inserted_at |
: , > , >= , < , <= |
date-time | |
prn |
: |
string | |
updated_at |
: , > , >= , < , <= |
date-time |
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. |
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by |
search | string A search query per the search query language. |
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
{- "artifact_versions": [
- {
- "artifact_prn": "string",
- "custom_metadata": { },
- "description": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "organization_prn": "string",
- "prn": "string",
- "version": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_page": "string"
}
artifact_version_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "artifact_version": {
- "artifact_prn": "string",
- "custom_metadata": { },
- "description": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "organization_prn": "string",
- "prn": "string",
- "version": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
artifact_version_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
custom_metadata | object (custom-metadata-artifact-version) <= 1000000 characters A JSON object that informs the metadata that will be associated with this artifact version's binaries when they are included in bundles. Max size is 1,000,000 bytes (1 MB). |
description | string (artifact-version-description) [ 1 .. 256 ] characters |
{- "custom_metadata": { },
- "description": "string"
}
{- "artifact_version": {
- "artifact_prn": "string",
- "custom_metadata": { },
- "description": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "organization_prn": "string",
- "prn": "string",
- "version": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
artifact_version_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
Create a binary record.
artifact_version_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
custom_metadata | object (custom-metadata-binary) <= 1000000 characters A JSON object that informs the metadata that will be associated with this binary when it is included in bundles. Max size is 1,000,000 bytes (1 MB). |
description | string (binary-description) [ 1 .. 256 ] characters |
hash required | string (binary-hash) The lowercase hex encoding of the SHA256 hash of the binary's data. |
id | string (custom-id) A user provided custom UUID id for the resource database record. This overrides peridio's autogenerated ID for the user provided one. Use with caution. |
size required | integer (binary-size) [ 0 .. 53687091200000 ] The expected size in bytes of the binary. |
target required | string (target-triplet) [ 1 .. 128 ] characters A target triplet string that specifies compaitibility between binaries and devices. |
{- "artifact_version_prn": "string",
- "custom_metadata": { },
- "description": "string",
- "hash": "string",
- "id": "string",
- "size": 1800000,
- "target": "arm-linux-androideabi"
}
{- "binary": {
- "artifact_version_prn": "string",
- "custom_metadata": { },
- "description": "string",
- "hash": "string",
- "organization_prn": "string",
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "signatures": null,
- "size": 1800000,
- "state": "uploadable",
- "target": "arm-linux-androideabi",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
Search
This resource has the following searchable fields.
Key | Required | Operators | Value |
---|---|---|---|
artifact_version_prn |
: |
string | |
description |
: , ~ |
string | |
hash |
: |
string | |
inserted_at |
: , > , >= , < , <= |
date-time | |
prn |
: |
string | |
size |
: , > , >= , < , <= |
integer | |
target |
: , ~ |
string | |
updated_at |
: , > , >= , < , <= |
date-time |
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. |
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by |
search | string A search query per the search query language. |
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
{- "binaries": [
- {
- "artifact_version_prn": "string",
- "custom_metadata": { },
- "description": "string",
- "hash": "string",
- "organization_prn": "string",
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "signatures": null,
- "size": 1800000,
- "state": "uploadable",
- "target": "arm-linux-androideabi",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_page": "string"
}
binary_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "binary": {
- "artifact_version_prn": "string",
- "custom_metadata": { },
- "description": "string",
- "hash": "string",
- "organization_prn": "string",
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "signatures": null,
- "size": 1800000,
- "state": "uploadable",
- "target": "arm-linux-androideabi",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
binary_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
custom_metadata | object (custom-metadata-binary) <= 1000000 characters A JSON object that informs the metadata that will be associated with this binary when it is included in bundles. Max size is 1,000,000 bytes (1 MB). |
description | string (binary-description) [ 1 .. 256 ] characters |
state | string (binary-state) Enum: "uploadable" "hashable" "hashing" "signable" "signed" "destroyed" The binary state |
{- "custom_metadata": { },
- "description": "string",
- "state": "uploadable"
}
{- "binary": {
- "artifact_version_prn": "string",
- "custom_metadata": { },
- "description": "string",
- "hash": "string",
- "organization_prn": "string",
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "signatures": null,
- "size": 1800000,
- "state": "uploadable",
- "target": "arm-linux-androideabi",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
binary_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
Create a binary part.
binary_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
index required | integer (binary-part-index) The binary part index order |
expected_binary_size required | integer (binary-part-size) [ 5242880 .. 5368709120 ] The expected size in bytes of the binary part. |
hash required | string (binary-part-hash) The lowercase hex encoding of the SHA256 hash of the binary part's data. |
size required | integer (binary-part-size) [ 5242880 .. 5368709120 ] The expected size in bytes of the binary part. |
{- "expected_binary_size": 1800000,
- "hash": "string",
- "size": 1800000
}
{- "binary_part": {
- "binary_prn": "string",
- "hash": "string",
- "index": 0,
- "inserted_at": "2019-08-24T14:15:22Z",
- "organization_prn": "string",
- "prn": "string",
- "size": 1800000,
- "state": "uploadable",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
binary_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "binary_parts": [
- {
- "binary_prn": "string",
- "hash": "string",
- "index": 0,
- "inserted_at": "2019-08-24T14:15:22Z",
- "organization_prn": "string",
- "prn": "string",
- "size": 1800000,
- "state": "uploadable",
- "updated_at": "2019-08-24T14:15:22Z"
}
]
}
Attach a signature to a binary.
This endpoint must be used against a binary that is already uploaded completely. The request will fail if the signature is invalid.
binary_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
signing_key_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
signature required | string (binary-signature-signature) The lowercase hex encoding of the ed25519 signature of the base16 encoding of the SHA256 hash of the binary. |
{- "binary_prn": "string",
- "signing_key_prn": "string",
- "signature": "string"
}
{- "binary_signature": {
- "binary_prn": "string",
- "organization_prn": "string",
- "prn": "string",
- "signature": "string",
- "signing_key_prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
binary_signature_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
value required | string (signing-key-value) [ 1 .. 256 ] characters |
name required | string (signing-key-name) [ 1 .. 128 ] characters |
{- "value": "string",
- "name": "string"
}
{- "signing_key": {
- "value": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "name": "string",
- "organization_prn": "string",
- "prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
Search
This resource has the following searchable fields.
Key | Required | Operators | Value |
---|---|---|---|
inserted_at |
: , > , >= , < , <= |
date-time | |
name |
: , ~ |
string | |
prn |
: |
string | |
updated_at |
: , > , >= , < , <= |
date-time | |
value |
: |
string |
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. |
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by |
search | string A search query per the search query language. |
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
{- "signing_keys": [
- {
- "value": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "name": "string",
- "organization_prn": "string",
- "prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_page": "string"
}
signing_key_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "signing_key": {
- "value": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "name": "string",
- "organization_prn": "string",
- "prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
signing_key_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
value | string (signing-key-value) [ 1 .. 256 ] characters |
name | string (signing-key-name) [ 1 .. 128 ] characters |
{- "value": "string",
- "name": "string"
}
{- "signing_key": {
- "value": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "name": "string",
- "organization_prn": "string",
- "prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
signing_key_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
Search
This resource has the following searchable fields.
Key | Required | Operators | Value |
---|---|---|---|
state |
: |
string | |
device_prn |
: |
prn |
state
can be one of requested
, open
, closed
.
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. |
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by |
search | string A search query per the search query language. |
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
search | string (search-with-org) The |
{- "search": "organization_prn:'prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef'"
}
{- "tunnels": [
- {
- "cidr_block_allowlist": [
- "10.0.0.1/16",
- "172.154.0.1/16"
], - "device_proxy_ip_address": "10.0.1.1",
- "device_proxy_port": 47539,
- "device_public_key": "Y4nCIXdpb+f3WgPi0377FDPCAfP+st82s98lTRepHEk=",
- "device_tunnel_port": 22,
- "server_proxy_ip_address": "10.0.0.1",
- "server_proxy_port": 49293,
- "server_public_key": "2+h9vwIwg/1zTW9XLFzUmiTwCRRq7mzLgDnZfWEislY=",
- "server_tunnel_ip_address": "3.82.23.99",
- "server_tunnel_port": 47532,
- "expires_at": "2019-08-24T14:15:22Z",
- "state": "requested",
- "device_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "organization_prn": "string",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:tunnel:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "inserted_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_page": "string"
}
Create a tunnel to a device for remote access.
The tunnel is available via a public IP address and port for a configurable amount of time. Anyone can send data through the tunnel and it is your responsibility to enforce authentication and authorization if desired.
device_prn required | string (device-prn) Identifies which device to create a tunnel for. |
device_tunnel_port required | number (device-tunnel-port) The port on which the device is listening for service traffic (e.g. ssh). |
cidr_block_allowlist | Array of strings (cidr-block-allowlist) A set of CIDR blocks that are allowed to connect to the tunnel. |
ttl | number [ 1 .. 3600 ] Default: 3600 The amount of time in seconds that the tunnel is available for. |
{- "device_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "device_tunnel_port": 22,
- "cidr_block_allowlist": [
- "10.0.0.1/16",
- "172.154.0.1/16"
], - "ttl": 3600
}
{- "tunnel": {
- "cidr_block_allowlist": [
- "10.0.0.1/16",
- "172.154.0.1/16"
], - "device_proxy_ip_address": "10.0.1.1",
- "device_proxy_port": 47539,
- "device_public_key": "Y4nCIXdpb+f3WgPi0377FDPCAfP+st82s98lTRepHEk=",
- "device_tunnel_port": 22,
- "server_proxy_ip_address": "10.0.0.1",
- "server_proxy_port": 49293,
- "server_public_key": "2+h9vwIwg/1zTW9XLFzUmiTwCRRq7mzLgDnZfWEislY=",
- "server_tunnel_ip_address": "3.82.23.99",
- "server_tunnel_port": 47532,
- "expires_at": "2019-08-24T14:15:22Z",
- "state": "requested",
- "device_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "organization_prn": "string",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:tunnel:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "inserted_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
tunnel_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "tunnel": {
- "cidr_block_allowlist": [
- "10.0.0.1/16",
- "172.154.0.1/16"
], - "device_proxy_ip_address": "10.0.1.1",
- "device_proxy_port": 47539,
- "device_public_key": "Y4nCIXdpb+f3WgPi0377FDPCAfP+st82s98lTRepHEk=",
- "device_tunnel_port": 22,
- "server_proxy_ip_address": "10.0.0.1",
- "server_proxy_port": 49293,
- "server_public_key": "2+h9vwIwg/1zTW9XLFzUmiTwCRRq7mzLgDnZfWEislY=",
- "server_tunnel_ip_address": "3.82.23.99",
- "server_tunnel_port": 47532,
- "expires_at": "2019-08-24T14:15:22Z",
- "state": "requested",
- "device_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "organization_prn": "string",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:tunnel:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "inserted_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
Update a tunnel
tunnel_prn required | string (tunnel-prn) Example: prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:tunnel:b3f1f699-3bc8-4c77-bda2-b974595d5e3f Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
state | string The state we want the tunnel to be in. Only accepts "closed". |
ttl | number [ 1 .. 3600 ] The amount of time in seconds to extend the tunnel for. |
{- "state": "closed",
- "ttl": 1
}
{- "data": {
- "cidr_block_allowlist": [
- "10.0.0.1/16",
- "172.154.0.1/16"
], - "device_proxy_ip_address": "10.0.1.1",
- "device_proxy_port": 47539,
- "device_public_key": "Y4nCIXdpb+f3WgPi0377FDPCAfP+st82s98lTRepHEk=",
- "device_tunnel_port": 22,
- "server_proxy_ip_address": "10.0.0.1",
- "server_proxy_port": 49293,
- "server_public_key": "2+h9vwIwg/1zTW9XLFzUmiTwCRRq7mzLgDnZfWEislY=",
- "server_tunnel_ip_address": "3.82.23.99",
- "server_tunnel_port": 47532,
- "expires_at": "2019-08-24T14:15:22Z",
- "state": "closed",
- "device_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "organization_prn": "string",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:tunnel:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "inserted_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
Create a self-authenticating, one-time use, expiring URL to a device remote shell in the Peridio web console.
Once a request is made to the returned URL, it cannot be used again. For example, refreshing the page will fail.
You must supply either:
device_prn
Or:
device_identifier
and organization_prn
device_identifier | string (device-identifier) Identifies which device to create a web console shell for. Mutually exclusive with |
device_prn | string (device-prn) Identifies which device to create a web console shell for. Mutually exclusive with |
organization_prn | string (device-prn) Identifies which organization the device belongs to if supplying Mutually exclusive with |
ttl | integer [ 0 .. 86400 ] Default: 3600 The amount of time in seconds that the URL is valid for. Open connections are closed automatically upon expiration. |
{- "device_identifier": "sn1234",
- "device_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "organization_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "ttl": 3600
}
{- "expires_at": "2019-08-24T14:15:22Z",
}
certificate required | string Base64 encoded CA certificate. |
verification_certificate required | string Base64 encoded verification certificate. See: create-a-ca-verification-code |
description | string |
{- "certificate": "string",
- "verification_certificate": "string",
- "description": "string"
}
{- "ca_certificate": {
- "description": "string",
- "not_after": "2019-08-24T14:15:22Z",
- "not_before": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:ca_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "serial": "522154175989108335861639249273408275957749326848"
}
}
Search
This resource has the following searchable fields.
Key | Operators | Value |
---|---|---|
description |
: , ~ |
string |
inserted_at |
: , > , >= , < , <= |
date-time |
prn |
: |
string |
updated_at |
: , > , >= , < , <= |
date-time |
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. |
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by |
search | string A search query per the search query language. |
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
{- "ca_certificates": [
- {
- "description": "string",
- "not_after": "2019-08-24T14:15:22Z",
- "not_before": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:ca_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "serial": "522154175989108335861639249273408275957749326848"
}
], - "next_page": "string"
}
ca_certificate_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
ca_certificate_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "ca_certificate": {
- "description": "string",
- "not_after": "2019-08-24T14:15:22Z",
- "not_before": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:ca_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "serial": "522154175989108335861639249273408275957749326848"
}
}
ca_certificate_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
description | string |
{- "description": "string"
}
{- "ca_certificate": {
- "description": "string",
- "not_after": "2019-08-24T14:15:22Z",
- "not_before": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:ca_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "serial": "522154175989108335861639249273408275957749326848"
}
}
description | string (cohort-description) [ 1 .. 256 ] characters |
name required | string (cohort-name) [ 1 .. 128 ] characters |
product_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "description": "string",
- "name": "string",
- "product_prn": "string"
}
{- "cohort": {
- "description": "string",
- "name": "string",
- "organization_prn": "string",
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "product_prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
Search
This resource has the following searchable fields.
Key | Required | Operators | Value |
---|---|---|---|
description |
: , ~ |
string | |
inserted_at |
: , > , >= , < , <= |
date-time | |
name |
: , ~ |
string | |
prn |
: |
string | |
updated_at |
: , > , >= , < , <= |
date-time |
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. |
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by |
search | string A search query per the search query language. |
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
{- "cohorts": [
- {
- "description": "string",
- "name": "string",
- "organization_prn": "string",
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "product_prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_page": "string"
}
cohort_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "cohort": {
- "description": "string",
- "name": "string",
- "organization_prn": "string",
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "product_prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
cohort_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
description | string (cohort-description) [ 1 .. 256 ] characters |
name | string (cohort-name) [ 1 .. 128 ] characters |
{- "description": "string",
- "name": "string"
}
{- "cohort": {
- "description": "string",
- "name": "string",
- "organization_prn": "string",
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "product_prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
device_prn required | string (device-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
certificate required | string (device-certificate-pem-base64) Base64 encoded device certificate pem. |
{- "device_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "certificate": "string"
}
{- "device_certificate": {
- "not_after": "2019-08-24T14:15:22Z",
- "not_before": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "serial": "522154175989108335861639249273408275957749326848"
}
}
Search
This resource has the following searchable fields.
Key | Operators | Value |
---|---|---|
device_prn |
: |
string |
inserted_at |
: , > , >= , < , <= |
date-time |
prn |
: |
string |
product_prn |
: |
string |
updated_at |
: , > , >= , < , <= |
date-time |
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. |
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by |
search | string A search query per the search query language. |
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
{- "device_certificates": [
- {
- "not_after": "2019-08-24T14:15:22Z",
- "not_before": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "serial": "522154175989108335861639249273408275957749326848"
}
], - "next_page": "string"
}
device_certificate_prn required | string (device-certificate-prn) Example: prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "device_certificate": {
- "not_after": "2019-08-24T14:15:22Z",
- "not_before": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "serial": "522154175989108335861639249273408275957749326848"
}
}
device_certificate_prn required | string (device-certificate-prn) Example: prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
product_prn required | string (product-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
cohort_prn | string (cohort-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
description | string (device-description) |
quarantined | boolean (device-quarantined) |
identifier required | string (device-identifier) Uniquely identifies a device within an organization. |
tags | Array of strings (array-of-device-tags) |
target | string (target-triplet) [ 1 .. 128 ] characters A target triplet string that specifies compaitibility between binaries and devices. |
{- "product_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:product:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "description": "some description",
- "quarantined": false,
- "identifier": "sn1234",
- "tags": [
- "string"
], - "target": "arm-linux-androideabi"
}
{- "device": {
- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "description": "some description",
- "identifier": "sn1234",
- "inserted_at": "2019-08-24T14:15:22Z",
- "last_connected_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "product_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:product:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "quarantined": false,
- "reported_bundle_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:bundle:c0c25d62-26d4-40b8-b9ab-609936d5d6d0",
- "reported_release_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:release:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "reported_release_version": "1.0.0",
- "tags": [
- "tag-1"
], - "target": "arm-linux-androideabi",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
Search
This resource has the following searchable fields.
Key | Operators | Value |
---|---|---|
cohort_prn |
: |
string |
description |
: , ~ |
string |
identifier |
: , ~ |
string |
inserted_at |
: , > , >= , < , <= |
date-time |
last_connected_at |
: , > , >= , < , <= |
date-time |
prn |
: |
string |
product_prn |
: |
string |
reported_bundle_prn |
: |
string |
reported_release_prn |
: |
string |
reported_release_version |
: , ~ |
string |
target |
: , ~ |
string |
updated_at |
: , > , >= , < , <= |
date-time |
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. |
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by |
search | string A search query per the search query language. |
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
{- "devices": [
- {
- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "description": "some description",
- "identifier": "sn1234",
- "inserted_at": "2019-08-24T14:15:22Z",
- "last_connected_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "product_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:product:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "quarantined": false,
- "reported_bundle_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:bundle:c0c25d62-26d4-40b8-b9ab-609936d5d6d0",
- "reported_release_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:release:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "reported_release_version": "1.0.0",
- "tags": [
- "tag-1"
], - "target": "arm-linux-androideabi",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_page": "string"
}
device_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "device": {
- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "description": "some description",
- "identifier": "sn1234",
- "inserted_at": "2019-08-24T14:15:22Z",
- "last_connected_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "product_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:product:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "quarantined": false,
- "reported_bundle_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:bundle:c0c25d62-26d4-40b8-b9ab-609936d5d6d0",
- "reported_release_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:release:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "reported_release_version": "1.0.0",
- "tags": [
- "tag-1"
], - "target": "arm-linux-androideabi",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
device_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
product_prn | string (product-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
cohort_prn | string (cohort-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
description | string (device-description) |
quarantined | boolean (device-quarantined) |
tags | Array of strings (array-of-device-tags) |
target | string (target-triplet) [ 1 .. 128 ] characters A target triplet string that specifies compaitibility between binaries and devices. |
{- "product_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:product:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "description": "some description",
- "quarantined": false,
- "tags": [
- "string"
], - "target": "arm-linux-androideabi"
}
{- "device": {
- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "description": "some description",
- "identifier": "sn1234",
- "inserted_at": "2019-08-24T14:15:22Z",
- "last_connected_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "product_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:product:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "quarantined": false,
- "reported_bundle_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:bundle:c0c25d62-26d4-40b8-b9ab-609936d5d6d0",
- "reported_release_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:release:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "reported_release_version": "1.0.0",
- "tags": [
- "tag-1"
], - "target": "arm-linux-androideabi",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
device_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
Returns information regarding whether an update is available via a release or bundle override.
device_prn required | string (prn) The PRN of the device you wish to check for an update for. |
release_prn required | string (prn) The PRN of the release to consider as the device's current release during bundle resolution. |
bundle_prn | string (prn) The PRN of the bundle to consider as the device's current bundle during bundle resolution. |
release_version | string (release-version) The version to consider as the device's current release version during bundle resolution. |
write | boolean Default: false Whether the server's record of what the device's current state is will be updated in reaction to the release PRN, bundle PRN, and release version parameters if they are also supplied. |
{- "release_prn": "string",
- "bundle_prn": "string",
- "release_version": "1.0.0",
- "write": false
}
{- "status": "update",
- "source_type": "release",
- "source_prn": "string",
- "bundle_prn": "string",
- "manifest": [
- {
- "artifact_prn": "string",
- "artifact_version": "string",
- "binary_prn": "string",
- "custom_metadata": { },
- "hash": "string",
- "signatures": null,
- "size": 1800000,
- "target": "arm-linux-androideabi",
- "url": "string"
}
]
}
Search
This resource has the following searchable fields.
Key | Required | Operators | Value |
---|---|---|---|
deleted_at |
: , > , >= , < , <= |
date-time | |
inserted_at |
: , > , >= , < , <= |
date-time | |
name |
: , ~ |
string | |
prn |
: |
string | |
updated_at |
: , > , >= , < , <= |
date-time |
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. | ||||||||||||||||||
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by | ||||||||||||||||||
search | string A search query per the search query language. Searchable fields:
| ||||||||||||||||||
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
{- "products": [
- {
- "archived": false,
- "inserted_at": "2019-08-24T14:15:22Z",
- "name": "string",
- "prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_page": "string"
}
archived | boolean (product-archived) |
name required | string (product-name) Uniquely identifies a product within an organization. |
{- "archived": false,
- "name": "string"
}
{- "product": {
- "archived": false,
- "inserted_at": "2019-08-24T14:15:22Z",
- "name": "string",
- "prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
product_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "data": {
- "archived": false,
- "inserted_at": "2019-08-24T14:15:22Z",
- "name": "string",
- "prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
product_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
archived | boolean (product-archived) A product cannot be archived if any of the following are true:
|
name | string (product-name) Uniquely identifies a product within an organization. |
{- "archived": false,
- "name": "string"
}
{- "data": {
- "archived": false,
- "inserted_at": "2019-08-24T14:15:22Z",
- "name": "string",
- "prn": "string",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
description | string (webhook-description) |
url | string (webhook-url) |
enabled_events | Array of any (webhook-enabled-events) Items Enum: "device.release_changed" "webhook.test_fire" |
{- "description": "string",
- "url": "string",
- "enabled_events": [
- "device.release_changed"
]
}
{- "webhook": {
- "state": "enabled",
- "inserted_at": "2019-08-24T14:15:22Z",
- "url": "string",
- "description": "string",
- "enabled_events": [
- "device.release_changed"
], - "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:webhook:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "updated_at": "2019-08-24T14:15:22Z",
- "secret": "C4FE345F29EF6156BD40B6DF73625243"
}
}
Search
This resource has the following searchable fields.
Key | Required | Operators | Value |
---|---|---|---|
description |
: , ~ |
string | |
inserted_at |
: , > , >= , < , <= |
date-time | |
prn |
: |
string | |
updated_at |
: , > , >= , < , <= |
date-time |
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. |
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by |
search | string A search query per the search query language. |
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
{- "webhooks": [
- {
- "state": "enabled",
- "inserted_at": "2019-08-24T14:15:22Z",
- "url": "string",
- "description": "string",
- "enabled_events": [
- "device.release_changed"
], - "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:webhook:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_page": "string"
}
webhook_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "webhook": {
- "state": "enabled",
- "inserted_at": "2019-08-24T14:15:22Z",
- "url": "string",
- "description": "string",
- "enabled_events": [
- "device.release_changed"
], - "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:webhook:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
webhook_prn required | string (webhook-prn) Example: prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:webhook:b3f1f699-3bc8-4c77-bda2-b974595d5e3f Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
description | string (webhook-description) |
url | string (webhook-url) |
enabled_events | Array of any (webhook-enabled-events) Items Enum: "device.release_changed" "webhook.test_fire" |
state | any (webhook-state) Enum: "enabled" "disabled" |
{- "description": "string",
- "url": "string",
- "enabled_events": [
- "device.release_changed"
], - "state": "enabled"
}
{- "webhook": {
- "state": "enabled",
- "inserted_at": "2019-08-24T14:15:22Z",
- "url": "string",
- "description": "string",
- "enabled_events": [
- "device.release_changed"
], - "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:webhook:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
webhook_prn required | string (webhook-prn) Example: prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:webhook:b3f1f699-3bc8-4c77-bda2-b974595d5e3f Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
webhook_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
webhook_ttl | integer (webhook-ttl) The amount of time in seconds that the old secret and the new secret will co-exist. While they do, dual signature values will be provided with webhook executions. See the webhooks reference. |
{- "webhook_ttl": 0
}
{- "webhook": {
- "state": "enabled",
- "inserted_at": "2019-08-24T14:15:22Z",
- "url": "string",
- "description": "string",
- "enabled_events": [
- "device.release_changed"
], - "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:webhook:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "updated_at": "2019-08-24T14:15:22Z",
- "secret": "C4FE345F29EF6156BD40B6DF73625243"
}
}
webhook_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "event": {
- "data": {
- "type": "test_fire",
- "data": {
- "webhook_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:webhook:b3f1f699-3bc8-4c77-bda2-b974595d5e3f"
}
}, - "inserted_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:event:e0040f63-4e1c-43e7-880a-d6986a35c499",
- "type": "webhook",
- "version": 1
}
}
artifact_version_prns required | Array of strings (array-of-artifact-version-prns) |
id | string (custom-id) A user provided custom UUID id for the resource database record. This overrides peridio's autogenerated ID for the user provided one. Use with caution. |
null or string (bundle-name) |
{- "artifact_version_prns": [
- "string"
], - "id": "string",
- "name": { }
}
{- "bundle": {
- "artifact_versions": [
- {
- "prn": "string",
- "index": 0
}
], - "name": { },
- "organization_prn": "string",
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
Search
This resource has the following searchable fields.
Key | Required | Operators | Value |
---|---|---|---|
inserted_at |
: , > , >= , < , <= |
date-time | |
name |
: , ~ , - |
string | |
prn |
: |
string | |
updated_at |
: , > , >= , < , <= |
date-time |
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. |
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by |
search | string A search query per the search query language. |
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
{- "bundles": [
- {
- "artifact_versions": [
- {
- "prn": "string",
- "index": 0
}
], - "name": { },
- "organization_prn": "string",
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}
], - "next_page": "string"
}
bundle_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "bundle": {
- "artifact_versions": [
- {
- "prn": "string",
- "index": 0
}
], - "name": { },
- "organization_prn": "string",
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
bundle_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
null or string (bundle-name) | |
One of null |
{- "name": { }
}
{- "bundle": {
- "artifact_versions": [
- {
- "prn": "string",
- "index": 0
}
], - "name": { },
- "organization_prn": "string",
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
bundle_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
bundle_prn required | string (prn) The bundle the release will distribute to devices. |
phase_mode | string (release-phase-mode) Default: "numeric" Enum: "tags" "numeric" Describes if this release is using tag or numeric based phasing. tags or phase value for resolution
|
phase_tags | Array of strings (release-phase-tags) Limits by tags the devices that are allowed to update to this release. Required if: When |
phase_value | number (release-phase-value) [ 0 .. 1000000000 ] Limits by percent or static count the number of devices that are allowed to update to this release. Required if: When
NOTE: A release with a NOTE: There can only ever be a single release that is phased at a time within a cohort. Because of this, if there is already a phased release, it must be "completed" by setting the phase to |
cohort_prn required | string (prn) The cohort to create the release within, and in turn the cohort it will distribute its bundle to. |
string or null (release-description) | |
disabled | boolean (release-disabled) If a release is marked as disabled it cannot be resolved during release resolution. |
name required | string (release-name) |
next_release_prn | string (prn) If omitted, the release will be created as latest within the cohort. If there is already at least one release in the cohort, then the latest release in that cohort would have its If supplied, the release will be created prior to the release identified by |
previous_release_prn | string (prn) If omitted, In order to insert a release between two other releases, |
required required | boolean (release-required) If If |
schedule_date required | string <date-time> (release-schedule-availability) Before this date-time, the release will not be resolvable when checking for updates. You may use this to schedule a future release. |
version | string (release-version) The release version. If provided, it has to be a valid version. Used in dynamic release resolution. |
version-requirement | string (release-version-requirement) The release version requirement. If provided, it has to be a valid requirement. Used in dynamic release resolution. |
{- "bundle_prn": "string",
- "phase_mode": "tags",
- "phase_tags": [
- "string"
], - "phase_value": 1000000000,
- "cohort_prn": "string",
- "description": null,
- "disabled": true,
- "name": "string",
- "next_release_prn": "string",
- "previous_release_prn": "string",
- "required": true,
- "schedule_date": "2019-08-24T14:15:22Z",
- "version": "1.0.0",
- "version-requirement": "== 1.0.0"
}
{- "release": {
- "bundle_prn": "string",
- "cohort_prn": "string",
- "description": null,
- "disabled": true,
- "name": "string",
- "next_release_prn": { },
- "organization_prn": "string",
- "phase_mode": "tags",
- "phase_tags": [
- "string"
], - "phase_type": "static",
- "phase_value": 1000000000,
- "required": true,
- "schedule_date": "2019-08-24T14:15:22Z",
- "schedule_complete": true,
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "version": "1.0.0",
- "version_requirement": "== 1.0.0"
}
}
Search
This resource has the following searchable fields.
Key | Required | Operators | Value |
---|---|---|---|
cohort_prn |
: |
string | |
deleted_at |
: , > , >= , < , <= |
date-time | |
description |
: , ~ |
string | |
inserted_at |
: , > , >= , < , <= |
date-time | |
name |
: , ~ |
string | |
next_release_prn |
: |
string | |
prn |
: |
string | |
updated_at |
: , > , >= , < , <= |
date-time | |
version_requirement |
: , - |
string | |
version |
: , - |
string |
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. |
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by |
search | string A search query per the search query language. |
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
{- "next_page": "string",
- "releases": [
- {
- "bundle_prn": "string",
- "cohort_prn": "string",
- "description": null,
- "disabled": true,
- "name": "string",
- "next_release_prn": { },
- "organization_prn": "string",
- "phase_mode": "tags",
- "phase_tags": [
- "string"
], - "phase_type": "static",
- "phase_value": 1000000000,
- "required": true,
- "schedule_date": "2019-08-24T14:15:22Z",
- "schedule_complete": true,
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "version": "1.0.0",
- "version_requirement": "== 1.0.0"
}
]
}
release_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "release": {
- "bundle_prn": "string",
- "cohort_prn": "string",
- "description": null,
- "disabled": true,
- "name": "string",
- "next_release_prn": { },
- "organization_prn": "string",
- "phase_mode": "tags",
- "phase_tags": [
- "string"
], - "phase_type": "static",
- "phase_value": 1000000000,
- "required": true,
- "schedule_date": "2019-08-24T14:15:22Z",
- "schedule_complete": true,
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "version": "1.0.0",
- "version_requirement": "== 1.0.0"
}
}
release_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
string or null (release-description) | |
disabled | boolean (release-disabled) If a release is marked as disabled it cannot be resolved during release resolution. |
name | string (release-name) |
next_release_prn | string (prn) Update the release's |
phase_mode | string (release-phase-mode) Enum: "tags" "numeric" Describes if this release is using tag or numeric based phasing. tags or phase value for resolution
|
phase_tags | Array of strings (release-phase-tags) Limits by tags the devices that are allowed to update to this release. Required if: When |
phase_value | number (release-phase-value) [ 0 .. 1000000000 ] Limits by percent or static count the number of devices that are allowed to update to this release. Required if: When
NOTE: A release with a NOTE: There can only ever be a single release that is phased at a time within a cohort. Because of this, if there is already a phased release, it must be "completed" by setting the phase to |
required | boolean (release-required) If If |
schedule_date | string <date-time> (release-schedule-availability) Before this date-time, the release will not be resolvable when checking for updates. You may use this to schedule a future release. |
version | string (release-version) The release version. If provided, it has to be a valid version. Used in dynamic release resolution. |
version-requirement | string (release-version-requirement) The release version requirement. If provided, it has to be a valid requirement. Used in dynamic release resolution. |
{- "description": null,
- "disabled": true,
- "name": "string",
- "next_release_prn": "string",
- "phase_mode": "tags",
- "phase_tags": [
- "string"
], - "phase_value": 1000000000,
- "required": true,
- "schedule_date": "2019-08-24T14:15:22Z",
- "version": "1.0.0",
- "version-requirement": "== 1.0.0"
}
{- "release": {
- "bundle_prn": "string",
- "cohort_prn": "string",
- "description": null,
- "disabled": true,
- "name": "string",
- "next_release_prn": { },
- "organization_prn": "string",
- "phase_mode": "tags",
- "phase_tags": [
- "string"
], - "phase_type": "static",
- "phase_value": 1000000000,
- "required": true,
- "schedule_date": "2019-08-24T14:15:22Z",
- "schedule_complete": true,
- "prn": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z",
- "version": "1.0.0",
- "version_requirement": "== 1.0.0"
}
}
release_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
List all possible events (Device, Webhooks, API Key, etc.) within the specified time range.
The date range may be adjusted via query parameters.
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. |
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by |
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
inserted_at_lt | date-time The ending date point of the range of the query Must be greater than event_inserted_at_gte. |
inserted_at_gte | date-time The starting date point of the range of the query Must be lower than event_inserted_at_lt. |
actor_prn | string (prn) Filter events by actor PRN. |
resource_prn | string (prn) Filter events by resource PRN. |
type | string Enum: "device" "webhook" "api_key" Filter events by type. |
subtype | string Enum: "release_changed" "claimed_release" "checked_for_release" "connected" "updated" "authentication_failed" "created" "request_failed" "test_fire" Filter events by subtype. |
{- "events": [
- {
- "data": {
- "type": "created",
- "data": {
- "api_key_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:api_key:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "creator_prn": "prn:1:user:b3f1f699-3bc8-4c77-bda2-b974595d5e3f"
}
}, - "inserted_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:event:e0040f63-4e1c-43e7-880a-d6986a35c499",
- "type": "api_key",
- "version": 1,
- "actor_prn": "string",
- "resource_prn": "string",
- "event_subtype": "release_changed"
}
], - "next_page": "string"
}
See the webhooks reference for a list of supported events.
This event is created when an api key is created.
peridio-signature | string Examples:
The webhook signature. See signature verification. |
peridio-published-at | string <date-time> The timestamp of when the event was published (not created). See signature verification. |
object Data associated with the | |
inserted_at | string <date-time> |
prn | string (event-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
type | string Value: "api_key" |
version | integer Value: 1 |
{- "data": {
- "type": "created",
- "data": {
- "api_key_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:api_key:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "creator_prn": "prn:1:user:b3f1f699-3bc8-4c77-bda2-b974595d5e3f"
}
}, - "inserted_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:event:e0040f63-4e1c-43e7-880a-d6986a35c499",
- "type": "api_key",
- "version": 1
}
See the webhooks reference for a list of supported events.
This event is created when a device checks for an update with get-update.
peridio-signature | string Examples:
The webhook signature. See signature verification. |
peridio-published-at | string <date-time> The timestamp of when the event was published (not created). See signature verification. |
object Data associated with the | |
inserted_at | string <date-time> |
prn | string (event-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
type | string Value: "device" |
version | integer Value: 1 |
{- "data": {
- "type": "checked_for_release",
- "data": {
- "device": {
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "identifier": "sn1234",
- "cohort": {
- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "cohort_name": "string"
}
}, - "release": {
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:release:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "version": "1.0.0"
}, - "bundle": {
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:bundle:c0c25d62-26d4-40b8-b9ab-609936d5d6d0",
- "name": { }
}
}
}, - "inserted_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:event:e0040f63-4e1c-43e7-880a-d6986a35c499",
- "type": "device",
- "version": 1
}
See the webhooks reference for a list of supported events.
This event is created when a device claims access to a phased release during a get-update.
peridio-signature | string Examples:
The webhook signature. See signature verification. |
peridio-published-at | string <date-time> The timestamp of when the event was published (not created). See signature verification. |
object Data associated with the | |
inserted_at | string <date-time> |
prn | string (event-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
type | string Value: "device" |
version | integer Value: 1 |
{- "data": {
- "type": "claimed_release",
- "data": {
- "device": {
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "identifier": "sn1234",
- "cohort": {
- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "cohort_name": "string"
}
}, - "release": {
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:release:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "version": "1.0.0"
}
}
}, - "inserted_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:event:e0040f63-4e1c-43e7-880a-d6986a35c499",
- "type": "device",
- "version": 1
}
See the webhooks reference for a list of supported events.
This event is created when a device successfully completes a TLS handshake while connecting to the Peridio Device API.
peridio-signature | string Examples:
The webhook signature. See signature verification. |
peridio-published-at | string <date-time> The timestamp of when the event was published (not created). See signature verification. |
object Data associated with the | |
inserted_at | string <date-time> |
prn | string (event-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
type | string Value: "device" |
version | integer Value: 1 |
{- "data": {
- "type": "connected",
- "data": {
- "device": {
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "identifier": "sn1234",
- "cohort": {
- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "cohort_name": "string"
}
}, - "ip_address": "192.168.0.1",
- "certificate": {
- "authority_key_identifier": "string",
- "common_name": "string",
- "fingerprint": "stringstringstringstringstringstringstringstringstringstringstri"
}, - "ca_certificate": {
- "common_name": "string",
- "fingerprint": "stringstringstringstringstringstringstringstringstringstringstri"
}, - "route": "string",
- "headers": {
- "peridio-release-prn": "prn:1:4b8c3b41-f1ce-4c09-83ee-9cb60eb71483:release:d39587b9-4445-4e91-8952-4af83b97fea6"
}
}
}, - "inserted_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:event:e0040f63-4e1c-43e7-880a-d6986a35c499",
- "type": "device",
- "version": 1
}
See the webhooks reference for a list of supported events.
This event is created when a device informs Peridio of its current release or bundle via the peridio-release-prn
or peridio-bundle-prn
headers, and that release or bundle is different than the one Peridio currently had on record. In cases where a peridio-bundle-prn
header is supplied, the to_release
property will be null
.
For example, if Peridio thought the device was on release 1, but then the device informed Peridio it was on release 2, then this event would be created going from 1 to 2 along with the new release's bundle. Similarly, if Peridio thought the device was on bundle 1, but then the device informed Peridio it was on bundle 2, then this event would be created going from bundle 1 to 2, with a to_release
of null
.
peridio-signature | string Examples:
The webhook signature. See signature verification. |
peridio-published-at | string <date-time> The timestamp of when the event was published (not created). See signature verification. |
object Data associated with the | |
inserted_at | string <date-time> |
prn | string (event-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
type | string Value: "device" |
version | integer Value: 1 |
{- "data": {
- "type": "release_changed",
- "data": {
- "device": {
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "identifier": "sn1234",
- "cohort": {
- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "cohort_name": "string"
}
}, - "from_release": {
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:release:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "version": "1.0.0"
}, - "to_release": {
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:release:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "version": "1.0.0",
- "known": true
}, - "from_bundle": {
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:bundle:c0c25d62-26d4-40b8-b9ab-609936d5d6d0"
}, - "to_bundle": {
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:bundle:c0c25d62-26d4-40b8-b9ab-609936d5d6d0",
- "known": true
}
}
}, - "inserted_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:event:e0040f63-4e1c-43e7-880a-d6986a35c499",
- "type": "device",
- "version": 1
}
See the webhooks reference for a list of supported events.
This event is created when a device database record is updated.
peridio-signature | string Examples:
The webhook signature. See signature verification. |
peridio-published-at | string <date-time> The timestamp of when the event was published (not created). See signature verification. |
object Data associated with the | |
inserted_at | string <date-time> |
prn | string (event-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
type | string Value: "device" |
version | integer Value: 1 |
{- "data": {
- "type": "updated",
- "data": {
- "device": {
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "identifier": "sn1234",
- "cohort": {
- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "cohort_name": "string"
}, - "description": "some description",
- "quarantined": false,
- "tags": { },
- "firmware": {
- "prn": "string",
- "vcs_identifier": { },
- "version": "1.0.0-alpha.3"
}, - "release": {
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:release:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "version": "1.0.0"
}, - "bundle": {
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:bundle:c0c25d62-26d4-40b8-b9ab-609936d5d6d0",
- "name": { }
}
}
}
}, - "inserted_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:event:e0040f63-4e1c-43e7-880a-d6986a35c499",
- "type": "device",
- "version": 1
}
See the webhooks reference for a list of supported events.
This event is created when an attempt to publish an event via a webhook fails.
peridio-signature | string Examples:
The webhook signature. See signature verification. |
peridio-published-at | string <date-time> The timestamp of when the event was published (not created). See signature verification. |
object Data associated with the | |
inserted_at | string <date-time> |
prn | string (event-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
type | string Value: "webhook" |
version | integer Value: 1 |
{- "data": {
- "type": "request_failed",
- "data": {
- "type": "host_resolution_failed",
- "data": {
- "webhook": {
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:webhook:b3f1f699-3bc8-4c77-bda2-b974595d5e3f"
}
}
}
}, - "inserted_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:event:e0040f63-4e1c-43e7-880a-d6986a35c499",
- "type": "webhook",
- "version": 1
}
See the webhooks reference for a list of supported events.
This event is created by the Peridio API test-fire-webhook endpoint as well as during URL verification.
peridio-signature | string Examples:
The webhook signature. See signature verification. |
peridio-published-at | string <date-time> The timestamp of when the event was published (not created). See signature verification. |
object Data associated with the | |
inserted_at | string <date-time> |
prn | string (event-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
type | string Value: "webhook" |
version | integer Value: 1 |
{- "data": {
- "type": "test_fire",
- "data": {
- "webhook_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:webhook:b3f1f699-3bc8-4c77-bda2-b974595d5e3f"
}
}, - "inserted_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:event:e0040f63-4e1c-43e7-880a-d6986a35c499",
- "type": "webhook",
- "version": 1
}
organization_name required | string (organization-name) |
{- "data": [
- {
- "description": "string",
- "not_after": "2019-08-24T14:15:22Z",
- "not_before": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:ca_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "serial": "522154175989108335861639249273408275957749326848"
}
]
}
organization_name required | string (organization-name) |
certificate required | string Base64 encoded CA certificate. |
verification_certificate required | string Base64 encoded verification certificate. See: create-a-ca-verification-code |
description | string |
{- "certificate": "string",
- "verification_certificate": "string",
- "description": "string"
}
{- "data": {
- "description": "string",
- "not_after": "2019-08-24T14:15:22Z",
- "not_before": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:ca_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "serial": "522154175989108335861639249273408275957749326848"
}
}
organization_name required | string (organization-name) |
ca_certificate_serial required | string (ca-certificate-serial) Example: 522154175989108335861639249273408275957749326848 |
{- "data": {
- "description": "string",
- "not_after": "2019-08-24T14:15:22Z",
- "not_before": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:ca_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "serial": "522154175989108335861639249273408275957749326848"
}
}
organization_name required | string (organization-name) |
ca_certificate_serial required | string (ca-certificate-serial) Example: 522154175989108335861639249273408275957749326848 |
description | string |
object (ca-jitp) |
{- "description": "string",
- "jitp": {
- "description": "string",
- "product_name": "string",
- "tags": [
- "string"
], - "cohort_prn": "string",
- "target": "string"
}
}
{- "data": {
- "description": "string",
- "not_after": "2019-08-24T14:15:22Z",
- "not_before": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:ca_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "serial": "522154175989108335861639249273408275957749326848"
}
}
organization_name required | string (organization-name) |
product_name required | string (product-name) Uniquely identifies a product within an organization. |
device_identifier required | string (device-identifier) Example: sn1234 Uniquely identifies a device within an organization. |
{- "data": [
- {
- "not_after": "2019-08-24T14:15:22Z",
- "not_before": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "serial": "522154175989108335861639249273408275957749326848"
}
]
}
organization_name required | string (organization-name) |
product_name required | string (product-name) Uniquely identifies a product within an organization. |
device_identifier required | string (device-identifier) Example: sn1234 Uniquely identifies a device within an organization. |
cert required | string (device-certificate-pem-base64) Base64 encoded device certificate pem. |
{- "cert": "string"
}
{- "data": {
- "not_after": "2019-08-24T14:15:22Z",
- "not_before": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "serial": "522154175989108335861639249273408275957749326848"
}
}
organization_name required | string (organization-name) |
product_name required | string (product-name) Uniquely identifies a product within an organization. |
device_identifier required | string (device-identifier) Example: sn1234 Uniquely identifies a device within an organization. |
certificate_serial required | string (device-certificate-serial) Example: 522154175989108335861639249273408275957749326848 |
{- "data": {
- "not_after": "2019-08-24T14:15:22Z",
- "not_before": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device_certificate:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "serial": "522154175989108335861639249273408275957749326848"
}
}
organization_name required | string (organization-name) |
product_name required | string (product-name) Uniquely identifies a product within an organization. |
device_identifier required | string (device-identifier) Example: sn1234 Uniquely identifies a device within an organization. |
certificate_serial required | string (device-certificate-serial) Example: 522154175989108335861639249273408275957749326848 |
organization_name required | string (organization-name) |
product_name required | string (product-name) Uniquely identifies a product within an organization. |
{- "data": [
- {
- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "description": "some description",
- "identifier": "sn1234",
- "inserted_at": "2019-08-24T14:15:22Z",
- "last_connected_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "product_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:product:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "quarantined": false,
- "reported_bundle_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:bundle:c0c25d62-26d4-40b8-b9ab-609936d5d6d0",
- "reported_release_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:release:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "reported_release_version": "1.0.0",
- "tags": [
- "tag-1"
], - "target": "arm-linux-androideabi",
- "updated_at": "2019-08-24T14:15:22Z"
}
]
}
organization_name required | string (organization-name) |
product_name required | string (product-name) Uniquely identifies a product within an organization. |
cohort_prn | string (cohort-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
description | string (device-description) |
healthy | boolean (device-healthy) |
identifier required | string (device-identifier) Uniquely identifies a device within an organization. |
last_communication | string <date-time> (device-last-communication) This field is ignored and has no effect. |
tags | Array of strings (array-of-device-tags) |
target | string (target-triplet) [ 1 .. 128 ] characters A target triplet string that specifies compaitibility between binaries and devices. |
{- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "description": "some description",
- "healthy": true,
- "identifier": "sn1234",
- "last_communication": "2019-08-24T14:15:22Z",
- "tags": [
- "string"
], - "target": "arm-linux-androideabi"
}
{- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "description": "some description",
- "identifier": "sn1234",
- "inserted_at": "2019-08-24T14:15:22Z",
- "last_connected_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "product_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:product:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "quarantined": false,
- "reported_bundle_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:bundle:c0c25d62-26d4-40b8-b9ab-609936d5d6d0",
- "reported_release_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:release:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "reported_release_version": "1.0.0",
- "tags": [
- "tag-1"
], - "target": "arm-linux-androideabi",
- "updated_at": "2019-08-24T14:15:22Z"
}
organization_name required | string (organization-name) |
product_name required | string (product-name) Uniquely identifies a product within an organization. |
device_identifier required | string (device-identifier) Example: sn1234 Uniquely identifies a device within an organization. |
organization_name required | string (organization-name) |
product_name required | string (product-name) Uniquely identifies a product within an organization. |
device_identifier required | string (device-identifier) Example: sn1234 Uniquely identifies a device within an organization. |
{- "data": {
- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "description": "some description",
- "identifier": "sn1234",
- "inserted_at": "2019-08-24T14:15:22Z",
- "last_connected_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "product_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:product:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "quarantined": false,
- "reported_bundle_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:bundle:c0c25d62-26d4-40b8-b9ab-609936d5d6d0",
- "reported_release_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:release:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "reported_release_version": "1.0.0",
- "tags": [
- "tag-1"
], - "target": "arm-linux-androideabi",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
organization_name required | string (organization-name) |
product_name required | string (product-name) Uniquely identifies a product within an organization. |
device_identifier required | string (device-identifier) Example: sn1234 Uniquely identifies a device within an organization. |
cohort_prn | string (cohort-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
description | string (device-description) |
healthy | boolean (device-healthy) |
last_communication | string <date-time> (device-last-communication) This field is ignored and has no effect. |
tags | Array of strings (array-of-device-tags) |
target | string (target-triplet) [ 1 .. 128 ] characters A target triplet string that specifies compaitibility between binaries and devices. |
{- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "description": "some description",
- "healthy": true,
- "last_communication": "2019-08-24T14:15:22Z",
- "tags": [
- "string"
], - "target": "arm-linux-androideabi"
}
{- "data": {
- "cohort_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:cohort:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "description": "some description",
- "identifier": "sn1234",
- "inserted_at": "2019-08-24T14:15:22Z",
- "last_connected_at": "2019-08-24T14:15:22Z",
- "prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:device:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "product_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:product:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "quarantined": false,
- "reported_bundle_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:bundle:c0c25d62-26d4-40b8-b9ab-609936d5d6d0",
- "reported_release_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:release:b3f1f699-3bc8-4c77-bda2-b974595d5e3f",
- "reported_release_version": "1.0.0",
- "tags": [
- "tag-1"
], - "target": "arm-linux-androideabi",
- "updated_at": "2019-08-24T14:15:22Z"
}
}
organization_name required | string (organization-name) |
product_name required | string (product-name) Uniquely identifies a product within an organization. |
{- "data": [
- {
- "conditions": {
- "tags": [
- "string"
], - "version": "== 1.0.0"
}, - "delta_updatable": true,
- "firmware_uuid": "ad4e7819-9176-4c88-8ecc-459ee9868725",
- "is_active": false,
- "name": "string"
}
]
}
organization_name required | string (organization-name) |
product_name required | string (product-name) Uniquely identifies a product within an organization. |
required | object (deployment-conditions) |
delta_updatable | boolean (delta-updatable) Default: false |
firmware required | string <uuid> (firmware-uuid) Uniquely identifies a firmware. |
is_active required | boolean (deployment-is-active) Must be |
name required | string (deployment-name) |
{- "conditions": {
- "tags": [
- "string"
], - "version": "== 1.0.0"
}, - "delta_updatable": true,
- "firmware": "a3a072e2-291e-4454-88c4-f2689e9ad8c7",
- "is_active": false,
- "name": "string"
}
{- "data": {
- "conditions": {
- "tags": [
- "string"
], - "version": "== 1.0.0"
}, - "delta_updatable": true,
- "firmware_uuid": "ad4e7819-9176-4c88-8ecc-459ee9868725",
- "is_active": false,
- "name": "string"
}
}
required | object (deployment-conditions) |
delta_updatable | boolean (delta-updatable) Default: false |
firmware_uuid required | string <uuid> (firmware-uuid) Uniquely identifies a firmware. |
name required | string (deployment-name) |
product_prn required | string (product-prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "conditions": {
- "tags": [
- "string"
], - "version": "== 1.0.0"
}, - "delta_updatable": true,
- "firmware_uuid": "ad4e7819-9176-4c88-8ecc-459ee9868725",
- "name": "string",
- "product_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:product:b3f1f699-3bc8-4c77-bda2-b974595d5e3f"
}
{- "deployment": {
- "conditions": {
- "tags": [
- "string"
], - "version": "== 1.0.0"
}, - "delta_updatable": true,
- "firmware_uuid": "ad4e7819-9176-4c88-8ecc-459ee9868725",
- "is_active": false,
- "name": "string"
}
}
Search
This resource has the following searchable fields.
Key | Operators | Value |
---|---|---|
inserted_at |
: , > , >= , < , <= |
date-time |
is_active |
: |
boolean |
name |
: , ~ |
string |
prn |
: |
string |
updated_at |
: , > , >= , < , <= |
date-time |
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. |
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by |
search | string A search query per the search query language. |
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
{- "deployments": [
- {
- "conditions": {
- "tags": [
- "string"
], - "version": "== 1.0.0"
}, - "delta_updatable": true,
- "firmware_uuid": "ad4e7819-9176-4c88-8ecc-459ee9868725",
- "is_active": false,
- "name": "string"
}
], - "next_page": "string"
}
deployment_prn required | string (deployment-prn) Example: prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:deployment:b3f1f699-3bc8-4c77-bda2-b974595d5e3f Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "deployment": {
- "conditions": {
- "tags": [
- "string"
], - "version": "== 1.0.0"
}, - "delta_updatable": true,
- "firmware_uuid": "ad4e7819-9176-4c88-8ecc-459ee9868725",
- "is_active": false,
- "name": "string"
}
}
When updating a deployment, you can modify its firmware_uuid
only if you also pass its associated product_prn
required | string (deployment-prn) Example: prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:deployment:b3f1f699-3bc8-4c77-bda2-b974595d5e3f Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
required | object | ||||||||||||
|
{- "deployment": {
- "name": "string",
- "conditions": {
- "tags": [
- "string"
], - "version": "== 1.0.0"
}, - "delta_updatable": true,
- "firmware_uuid": "ad4e7819-9176-4c88-8ecc-459ee9868725",
- "is_active": false,
- "product_prn": "prn:1:be4d30b4-de6b-47cd-85ea-a75e23fd63ef:product:b3f1f699-3bc8-4c77-bda2-b974595d5e3f"
}
}
{- "deployment": {
- "conditions": {
- "tags": [
- "string"
], - "version": "== 1.0.0"
}, - "delta_updatable": true,
- "firmware_uuid": "ad4e7819-9176-4c88-8ecc-459ee9868725",
- "is_active": false,
- "name": "string"
}
}
Deprecated
This functionality has been superceded by artifacts, artifact versions, and binaries.
organization_name required | string (organization-name) |
product_name required | string (product-name) Uniquely identifies a product within an organization. |
{- "data": [
- {
- "architecture": "string",
- "author": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "platform": "string",
- "product": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
- "vcs_identifier": "d670460b4b4aece5915caf5c68d12f560a9fe3e4",
- "version": "1.0.0-alpha.3"
}
]
}
organization_name required | string (organization-name) |
product_name required | string (product-name) Uniquely identifies a product within an organization. |
firmware required | string <binary> Reference firmware file requirements. |
ttl | integer |
{- "data": {
- "architecture": "string",
- "author": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "platform": "string",
- "product": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
- "vcs_identifier": "d670460b4b4aece5915caf5c68d12f560a9fe3e4",
- "version": "1.0.0-alpha.3"
}
}
organization_name required | string (organization-name) |
product_name required | string (product-name) Uniquely identifies a product within an organization. |
firmware_uuid required | string <uuid> (firmware-uuid) Uniquely identifies a firmware. |
This endpoint has an expandable response. See expanding responses.
organization_name required | string (organization-name) |
product_name required | string (product-name) Uniquely identifies a product within an organization. |
firmware_uuid required | string <uuid> (firmware-uuid) Uniquely identifies a firmware. |
expand | Array of strings See expanding responses. Expandable Fields For more information on each field, reference the response.
|
{- "data": {
- "architecture": "string",
- "author": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "platform": "string",
- "product": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
- "vcs_identifier": "d670460b4b4aece5915caf5c68d12f560a9fe3e4",
- "version": "1.0.0-alpha.3",
- "url": "string"
}
}
Deprecated
This functionality has been superceded by artifacts, artifact versions, and binaries.
product_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
firmware required | string <binary> Reference firmware file requirements. |
ttl | integer |
{- "firmware": {
- "architecture": "string",
- "author": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "platform": "string",
- "product": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
- "vcs_identifier": "d670460b4b4aece5915caf5c68d12f560a9fe3e4",
- "version": "1.0.0-alpha.3"
}
}
limit | integer [ 1 .. 100 ] Default: 10 Specifies the max length of the returned results. |
order | string Enum: "asc" "desc" Controls whether the order of results is ascending or descending by |
search | string A search query per the search query language. |
page | string A cursor for pagination across multiple pages of results. Don't include this parameter on
the first call. Use the |
{- "firmwares": [
- {
- "architecture": "string",
- "author": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "platform": "string",
- "product": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
- "vcs_identifier": "d670460b4b4aece5915caf5c68d12f560a9fe3e4",
- "version": "1.0.0-alpha.3"
}
], - "next_page": "string"
}
firmware_uuid required | string <uuid> (firmware-uuid) Uniquely identifies a firmware. |
product_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "product_prn": "string"
}
This endpoint has an expandable response. See expanding responses.
firmware_uuid required | string <uuid> (firmware-uuid) Uniquely identifies a firmware. |
expand | Array of strings See expanding responses. Expandable Fields For more information on each field, reference the response.
|
product_prn required | string (prn) Peridio Resource Names (PRNs) uniquely identify Peridio resources. |
{- "product_prn": "string"
}
{- "firmware": {
- "architecture": "string",
- "author": "string",
- "inserted_at": "2019-08-24T14:15:22Z",
- "platform": "string",
- "product": "string",
- "updated_at": "2019-08-24T14:15:22Z",
- "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
- "vcs_identifier": "d670460b4b4aece5915caf5c68d12f560a9fe3e4",
- "version": "1.0.0-alpha.3",
- "url": "string"
}
}