Skip to main content

List provider specifications

Get a paginated list of providers specifications filtered by NRN and other queries

Query Parameters
limit integer

Possible values: 1 ≤ value

Limits the number of results returned per page

offset integer

Specifies the offset for paginating through results

slug string

Unique slug for the provider specification

name string

Name of the provider specification

nrn NRN REQUIRED

Possible values: Value must match regular expression ^organization=[0-9*]+(:account=[0-9*]+)?(:namespace=[0-9*]+)?(:application=[0-9*]+)?(:scope=[0-9*]+)?$

Nullplatform Resource Name (NRN) representing a hierarchical identifier for nullplatform resources

category uuid[]

List of category IDs to filter by

Responses
2XX

Default Response

Schema OPTIONAL
object[]
id uuid

Unique identifier for the entity represented as a UUID

name string

Name of the provider specification

slug string

Unique slug for the provider specification

icon string OPTIONAL

Icon for the provider specification

description string OPTIONAL

Description of the provider specification

visible_to string[] OPTIONAL

List of NRNs this specification is visible to

schema object

JSON Schema for the provider specification. This schema defines settings for any Nullplatform integrations.
It can also include custom JSON Schema keywords such as:

  • tag (boolean): Marks a property as auto-taggable, automatically creating a tag with the property's value.
  • secret (boolean): Marks a property as secret, ensuring the property’s value is never revealed.
  • groups (array): Specifies configuration groups within the schema, automatically creating sections in the UI.
allow_dimensions boolean

Flag to allow dimensions for this specification

default_dimensions object OPTIONAL

Default dimensions for the provider specification

tags object[] OPTIONAL

Tags associated with the providers

key string

Tag key

value string

Tag value

id uuid

Unique identifier for the entity represented as a UUID

categories uuid[] OPTIONAL

IDs of associated categories

dependencies uuid[] OPTIONAL

IDs of associated dependencies

created_at date-time

Creation timestamp

updated_at date-time

Last update timestamp

4XX

Format for representing errors during API interactions

Schema OPTIONAL
statusCode number

HTTP status code indicating the error

code string OPTIONAL

Unique error code for reference and categorization

error string

Short, human-readable error type or category

message string

Detailed error message providing additional context

5XX

Format for representing errors during API interactions

Schema OPTIONAL
statusCode number

HTTP status code indicating the error

code string OPTIONAL

Unique error code for reference and categorization

error string

Short, human-readable error type or category

message string

Detailed error message providing additional context