Skip to main content
GET
/
metadata
List all metadata objects
curl --request GET \
  --url https://api.altostrat.io/metadata \
  --header 'Authorization: Bearer <token>'
[
  {
    "resource_id": "9b52d930-f432-4c0a-bac0-4c12dff85544",
    "type": "mikrotik.device",
    "metadata": {
      "circuit_id": "AS12345-XYZ",
      "install_date": "2025-01-15",
      "is_critical": true,
      "rack_units": 2
    }
  }
]

Authorizations

โ€‹
Authorization
string
header
required

A bearer token is required for all API requests.

Query Parameters

โ€‹
search
string

An optional search string to filter metadata objects by matching values. Returns resources where any metadata value contains the search string.

Response

A collection of metadata objects.

โ€‹
resource_id
string<uuid>

The unique identifier of the resource this metadata belongs to.

Example:

"9b52d930-f432-4c0a-bac0-4c12dff85544"

โ€‹
type
string

A string identifying the type of the resource.

Example:

"mikrotik.device"

โ€‹
metadata
object

A free-form object containing key-value pairs. Values can be strings, numbers, or booleans.

Example:
{
  "circuit_id": "AS12345-XYZ",
  "install_date": "2025-01-15",
  "is_critical": true,
  "rack_units": 2
}