Secrets

Endpoints for retrieving and managing secrets associated with an instance.

Secrets object

Attributes

object

Object

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

Date

The secret's last used date

created_at

Date

The secret's creation date

{
  "object": "secret",
  "id": "example_id",
  "status": "active",
  "type": {
    "identifier": "example_identifier",
    "name": "example_name"
  },
  "description": "This is a secret",
  "metadata": {},
  "organization_id": "example_organization_id",
  "instance_id": "example_instance_id",
  "fingerprint": "1234567890abcdef",
  "last_used_at": "2025-07-20T12:25:38.574Z",
  "created_at": "2025-07-20T12:25:38.574Z"
}

List secrets

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

GEThttp://api.metorial.com/secrets
curl -X GET "https://api.metorial.com/secrets" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..."

Get secret by ID

Retrieves detailed information about a specific secret by ID.

URL Parameters

secretId

String

The unique identifier for the secret

GEThttp://api.metorial.com/secrets/:secretId
curl -X GET "https://api.metorial.com/secrets/sec_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..."