Secrets

Secrets represent sensitive information securely stored by Metorial. Secrets are automatically created by Metorial, for example for server deployment configurations.

Secrets object

Attributes

object

String

id

String

The secret's unique identifier

status

Enum

The secret's status

type

Object

description

String

The secret's description

metadata

Object

The secret's metadata

organization_id

String

The secret's organization identifier

instance_id

String

The secret's instance identifier

fingerprint

String

The secret's fingerprint

last_used_at

DateNullable

The secret's last used date

created_at

Date

The secret's creation date

{
  "object": "secret",
  "status": "active",
  "type": {},
  "description": "This is a secret",
  "metadata": {},
  "fingerprint": "1234567890abcdef"
}

List secrets

Returns a paginated list of secrets for the instance, optionally filtered by type or status.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

type

UnionOptional

status

UnionOptional
GEThttp://api.metorial.com/secrets
curl -X GET "https://api.metorial.com/secrets" \
  -H "Authorization: Bearer metorial_sk_..."

Get secret by ID

Retrieves detailed information about a specific secret by ID.

URL Parameters

secret_id

String

The unique identifier for the secret

GEThttp://api.metorial.com/secrets/:secret_id
curl -X GET "https://api.metorial.com/secrets/sec_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."