Get asset by UUID.

GET 
/v1/assets/:uuid

Returns a single asset by UUID. This operation can be accessed by the asset or an admin.

Request

Path Parameters

uuid anyrequired
The UUID of the asset to retrieve.
Example: 8ea43308-d217-4545-b0d0-f93da568fe11
uuid uuidrequired

Unique identifier for the resource.

Responses

200

OK

application/json

Schema

Schema

$schema uri

A URL to the JSON Schema for this object.

data

object

required

created_at date-timerequired

Date and time the asset was created.

customer uuidrequired

Unique identifier for the customer

device stringrequired

Possible values: non-empty and <= 16 characters

Device type of the asset.

integration uuidrequired

Unique identifier for the integration

name stringrequired

Possible values: non-empty and <= 80 characters

Name of asset.

updated_at date-timerequired

Date and time the asset was updated.

uuid uuidrequired

Unique identifier for the person

status int64required
timestamp date-timerequired

Example (from schema)

{
  "$schema": "string",
  "data": {
    "created_at": "2024-05-27T07:25:42.258Z",
    "customer": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "device": "string",
    "integration": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string",
    "updated_at": "2024-05-27T07:25:42.258Z",
    "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  },
  "status": 0,
  "timestamp": "2024-05-27T07:25:42.258Z"
}

400

Bad Request

application/problem+json

Schema

Schema

$schema uri

A URL to the JSON Schema for this object.

detail string

A human-readable explanation specific to this occurrence of the problem.

errors

object[]

Optional list of individual error details

Array [

location string

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

message string

Error message text

value

The value at the given location

]

instance uri

A URI reference that identifies the specific occurrence of the problem.

status int64

HTTP status code

title string

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

type uri

Default value: about:blank

A URI reference to human-readable documentation for the error.

Example (from schema)

{
  "$schema": "string",
  "detail": "string",
  "errors": [
    {
      "location": "string",
      "message": "string"
    }
  ],
  "instance": "string",
  "status": 0,
  "title": "string",
  "type": "about:blank"
}

401

Unauthorized

application/problem+json

Schema

Schema

$schema uri

A URL to the JSON Schema for this object.

detail string

A human-readable explanation specific to this occurrence of the problem.

errors

object[]

Optional list of individual error details

Array [

location string

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

message string

Error message text

value

The value at the given location

]

instance uri

A URI reference that identifies the specific occurrence of the problem.

status int64

HTTP status code

title string

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

type uri

Default value: about:blank

A URI reference to human-readable documentation for the error.

Example (from schema)

{
  "$schema": "string",
  "detail": "string",
  "errors": [
    {
      "location": "string",
      "message": "string"
    }
  ],
  "instance": "string",
  "status": 0,
  "title": "string",
  "type": "about:blank"
}

403

Forbidden

application/problem+json

Schema

Schema

$schema uri

A URL to the JSON Schema for this object.

detail string

A human-readable explanation specific to this occurrence of the problem.

errors

object[]

Optional list of individual error details

Array [

location string

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

message string

Error message text

value

The value at the given location

]

instance uri

A URI reference that identifies the specific occurrence of the problem.

status int64

HTTP status code

title string

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

type uri

Default value: about:blank

A URI reference to human-readable documentation for the error.

Example (from schema)

{
  "$schema": "string",
  "detail": "string",
  "errors": [
    {
      "location": "string",
      "message": "string"
    }
  ],
  "instance": "string",
  "status": 0,
  "title": "string",
  "type": "about:blank"
}

422

Unprocessable Entity

application/problem+json

Schema

Schema

$schema uri

A URL to the JSON Schema for this object.

detail string

A human-readable explanation specific to this occurrence of the problem.

errors

object[]

Optional list of individual error details

Array [

location string

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

message string

Error message text

value

The value at the given location

]

instance uri

A URI reference that identifies the specific occurrence of the problem.

status int64

HTTP status code

title string

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

type uri

Default value: about:blank

A URI reference to human-readable documentation for the error.

Example (from schema)

{
  "$schema": "string",
  "detail": "string",
  "errors": [
    {
      "location": "string",
      "message": "string"
    }
  ],
  "instance": "string",
  "status": 0,
  "title": "string",
  "type": "about:blank"
}

500

Internal Server Error

application/problem+json

Schema

Schema

$schema uri

A URL to the JSON Schema for this object.

detail string

A human-readable explanation specific to this occurrence of the problem.

errors

object[]

Optional list of individual error details

Array [

location string

Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'

message string

Error message text

value

The value at the given location

]

instance uri

A URI reference that identifies the specific occurrence of the problem.

status int64

HTTP status code

title string

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

type uri

Default value: about:blank

A URI reference to human-readable documentation for the error.

Example (from schema)

{
  "$schema": "string",
  "detail": "string",
  "errors": [
    {
      "location": "string",
      "message": "string"
    }
  ],
  "instance": "string",
  "status": 0,
  "title": "string",
  "type": "about:blank"
}

Loading...