An agent's key directory

GET

/v1/agents/{client_id}/directory

const url = 'https://api.trybage.com/v1/agents/example/directory';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.trybage.com/v1/agents/example/directory

The agent’s Signature-Agent (type jwks_uri): its registered key, plus the session keys its live tokens are bound to (with exp). Each kid is the key’s JWK thumbprint, which is the keyid in the agent’s signatures.

Parameters

Path Parameters

client_id

required

string

Responses

200

The keys.

application/http-message-signatures-directory+json

object

keys

required

Array<object>

object

kty

required

string

Allowed values: OKP EC

crv

required

string

Allowed values: Ed25519 P-256

required

string

kid

required

The key’s JWK thumbprint.

string

use

required

string

Allowed value: sig

alg

string

Allowed values: EdDSA ES256

exp

For session keys

integer

Example

{
  "keys": [
    {
      "kty": "OKP",
      "crv": "Ed25519",
      "use": "sig",
      "alg": "EdDSA"
    }
  ]
}

404

Unknown or disabled agent.