Register Key

POSThttps://sandbox-api.truthlocks.com/v1/issuers/{issuer_id}/keysAuth required

Registers a new cryptographic signing key for an issuer. Only Ed25519 keys are supported. Keys start in ACTIVE status and can be used immediately for signing attestations.

Path Parameters

issuer_idstringrequired

The UUID of the issuer to register the key for

Defaults to 550e8400-e29b-41d4-a716-446655440000

Body Parameters

kidstringrequired

Unique key identifier (e.g., "ed-key-1")

Defaults to ed-key-1

algorithmstringrequired

Must be "Ed25519"

Defaults to Ed25519

public_keystringrequired

Base64-encoded public key

Defaults to MCowBQYDK2VwAyEAGb9Y2LvOsSglb2wUInSMKDpXm1QL4JqVxbu1rZxHkRY=

Responses

{
  "kid": "ed-key-1",
  "issuer_id": "550e8400-e29b-41d4-a716-446655440000",
  "algorithm": "Ed25519",
  "public_key": "MCowBQYDK2VwAyEAGb9Y2LvOsSglb2wUInSMKDpXm1QL4JqVxbu1rZxHkRY=",
  "status": "ACTIVE",
  "created_at": "2026-01-13T12:00:00Z"
}

POST/v1/issuers/{issuer_id}/keys

Language

CredentialsHEADER

Authorization

cURL Request

Examples ▾

curl --request POST \
  --url https://sandbox-api.truthlocks.com/v1/issuers/550e8400-e29b-41d4-a716-446655440000/keys \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
  "kid": "ed-key-1",
  "algorithm": "Ed25519",
  "public_key": "MCowBQYDK2VwAyEAGb9Y2LvOsSglb2wUInSMKDpXm1QL4JqVxbu1rZxHkRY="
}'

Response

Click Try It! to send a real request, or view sample responses: