Key

PreviousDevice NextSign

Last updated 1 year ago

Was this helpful?

List My Keys

get

/key/v1/keys

Authorizations

Query parameters

include_revokedboolean

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.dev.hyphen.at//key/v1/keys' \
  --header 'Authorization: Bearer JWT'

200

{
  "keys": [
    {
      "publicKey": "text",
      "accountId": "text",
      "appId": "text",
      "type": "user-key",
      "name": "Hyphen Server Key",
      "keyIndex": 0,
      "userKey": {
        "type": "device",
        "app": {
          "appId": "swirl-dev",
          "appName": "Swirl"
        },
        "device": {
          "id": "deadbeef-dead-beef-cafe-deadbeefcafe",
          "publicKey": "faceb00ccafebabedeadbeefbadf00defaceb00ccafebabedeadbeefbadf00de",
          "sdkVersion": "1.0.0",
          "pushToken": "bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
          "name": "iPhone 14",
          "osName": "iOS",
          "osVersion": "16.2",
          "deviceManufacturer": "Apple",
          "deviceModel": "SM-265N",
          "lang": "en",
          "type": "mobile"
        }
      },
      "recoverKey": {
        "type": "icloud",
        "cloudKey": {
          "accountName": "text"
        }
      },
      "lastUsedAt": "2025-02-12T01:52:02.589Z"
    }
  ]
}

Add Recovery Key

post

/key/v1/recovery

Authorizations

Body

recoveryKeyobjectrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.dev.hyphen.at//key/v1/recovery' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{"recoveryKey":{"publicKey":"text","cloudKey":{"accountName":"text"}}}'

200

{
  "keys": [
    {
      "publicKey": "text",
      "accountId": "text",
      "appId": "text",
      "type": "user-key",
      "name": "Hyphen Server Key",
      "keyIndex": 0,
      "userKey": {
        "type": "device",
        "app": {
          "appId": "swirl-dev",
          "appName": "Swirl"
        },
        "device": {
          "id": "deadbeef-dead-beef-cafe-deadbeefcafe",
          "publicKey": "faceb00ccafebabedeadbeefbadf00defaceb00ccafebabedeadbeefbadf00de",
          "sdkVersion": "1.0.0",
          "pushToken": "bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
          "name": "iPhone 14",
          "osName": "iOS",
          "osVersion": "16.2",
          "deviceManufacturer": "Apple",
          "deviceModel": "SM-265N",
          "lang": "en",
          "type": "mobile"
        }
      },
      "recoverKey": {
        "type": "icloud",
        "cloudKey": {
          "accountName": "text"
        }
      },
      "lastUsedAt": "2025-02-12T01:52:02.589Z"
    }
  ]
}