cheqd StudioSupport / Bug Reports

Keys

Create an identity key pair.

post
/key/create

This endpoint creates an identity key pair associated with the user's account for custodian-mode clients.

Authorizations
x-api-keystringRequired
Query parameters
typestring · enumOptional

Key type of the identity key pair to create.

Possible values:
Responses
200

The request was successful.

application/json
post
/key/create
POST /key/create HTTP/1.1
Host: studio-api.cheqd.net
x-api-key: YOUR_API_KEY
Accept: */*

{
  "kid": "text",
  "type": "Ed25519",
  "publicKeyHex": "text"
}

Import an identity key pair.

post
/key/import

This endpoint imports an identity key pair associated with the user's account for custodian-mode clients.

Authorizations
x-api-keystringRequired
Body
aliasstringOptional
typestring · enumOptionalPossible values:
privateKeyHexstringOptional
Responses
200

The request was successful.

application/json
post
/key/import
POST /key/import HTTP/1.1
Host: studio-api.cheqd.net
x-api-key: YOUR_API_KEY
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 56

"alias='text'&type='Ed25519'&privateKeyHex='text'"
{
  "kid": "text",
  "type": "Ed25519",
  "publicKeyHex": "text"
}

Fetch an identity key pair.

get
/key/read/{kid}

This endpoint fetches an identity key pair's details for a given key ID. Only the user account associated with the custodian-mode client can fetch the key pair.

Authorizations
x-api-keystringRequired
Path parameters
kidstringRequired

Key ID of the identity key pair to fetch.

Responses
200

The request was successful.

application/json
get
/key/read/{kid}
GET /key/read/{kid} HTTP/1.1
Host: studio-api.cheqd.net
x-api-key: YOUR_API_KEY
Accept: */*

{
  "kid": "text",
  "type": "Ed25519",
  "publicKeyHex": "text"
}

Convert a key to a W3C Verification Method.

get
/key/{kid}/verification-method

This endpoint converts a stored key (by key ID) into a W3C Verification Method format.

Authorizations
x-api-keystringRequired
Path parameters
kidstringRequired

Key ID of the identity key pair to convert.

Query parameters
verificationMethodTypestring · enumRequired

Type of verification method to use for the DID. See DID Core specification for more details. Only the types listed below are supported.

Possible values:
controllerstringOptional

Controller DID of the verification method

idstringOptional

Verification Method Id Fragment

Responses
200

The request was successful.

application/json
get
/key/{kid}/verification-method
GET /key/{kid}/verification-method?verificationMethodType=Ed25519VerificationKey2018 HTTP/1.1
Host: studio-api.cheqd.net
x-api-key: YOUR_API_KEY
Accept: */*

{
  "controller": "did:cheqd:testnet:7bf81a20-633c-4cc7-bc4a-5a45801005e0",
  "id": "did:cheqd:testnet :7bf81a20-633c-4cc7-bc4a-5a45801005e0#key-1",
  "publicKeyBase58": "BTJiso1S4iSiReP6wGksSneGfiKHxz9SYcm2KknpqBJt",
  "type": "Ed25519VerificationKey2018"
}

Last updated

Was this helpful?