JWKS URL

Well-known JWKS endpoint

curl --request GET \
  --url https://sdp.suki-stage.com/api/auth/.well-known/jwks-pub.json

{
  "keys": [
    {
      "alg": "RS256",
      "e": "AQAB",
      "kid": "sdp-pub",
      "kty": "RSA",
      "n": "yeNlzlub94YgerT030codqEztjfU_S6X4DbDA_iVKkjAWtYfPHDzz_sPCT1Axz6isZdf3lHpq_gYX4Sz-cbe4rjmigxUxr-FgKHQy3HeCdK6hNq9ASQvMK9LBOpXDNn7mei6RZWom4wo3CMvvsY1w8tjtfLb-yQwJPltHxShZq5-ihC9irpLI9xEBTgG12q5lGIFPhTl_7inA1PFK97LuSLnTJzW0bj096v_TMDg7pOWm_zHtF53qbVsI0e3v5nmdKXdFf9BjIARRfVrbxVxiZHjU6zL6jY5QJdh1QCmENoejj_ytspMmGW7yMRxzUqgxcAqOBpVm0b-_mW3HoBdjQ",
      "use": "sig"
    }
  ]
}

GET

api

auth

.well-known

jwks-pub.json

Well-known JWKS endpoint

curl --request GET \
  --url https://sdp.suki-stage.com/api/auth/.well-known/jwks-pub.json

{
  "keys": [
    {
      "alg": "RS256",
      "e": "AQAB",
      "kid": "sdp-pub",
      "kty": "RSA",
      "n": "yeNlzlub94YgerT030codqEztjfU_S6X4DbDA_iVKkjAWtYfPHDzz_sPCT1Axz6isZdf3lHpq_gYX4Sz-cbe4rjmigxUxr-FgKHQy3HeCdK6hNq9ASQvMK9LBOpXDNn7mei6RZWom4wo3CMvvsY1w8tjtfLb-yQwJPltHxShZq5-ihC9irpLI9xEBTgG12q5lGIFPhTl_7inA1PFK97LuSLnTJzW0bj096v_TMDg7pOWm_zHtF53qbVsI0e3v5nmdKXdFf9BjIARRfVrbxVxiZHjU6zL6jY5QJdh1QCmENoejj_ytspMmGW7yMRxzUqgxcAqOBpVm0b-_mW3HoBdjQ",
      "use": "sig"
    }
  ]
}

Use this public endpoint to get the JSON Web Key Set (JWKS) containing Suki’s public keys. You will need these keys to verify the signature of any JSON Web Token (JWT) issued by Suki, such as the suki_token. This endpoint follows the RFC 7517 standard.

AuthenticationThis is a public endpoint and does not require authentication.

Key Use Cases

Verify Tokens: Confirm the authenticity of the suki_token you receive from our authentication API.
Handle Key Rotation: Automatically discover new public keys when Suki rotates its signing keys.
Maintain Security: Follow industry best practices for JWT validation.

Code Examples

Python
TypeScript

import requests

url = "https://sdp.suki.ai/api/auth/.well-known/jwks-pub.json"

response = requests.get(url)

if response.status_code == 200:
    jwks = response.json()
    print("Public keys retrieved successfully")
    print(f"Keys: {jwks}")
else:
    print(f"Failed to retrieve JWKS: {response.status_code}")

const response = await fetch('https://sdp.suki.ai/api/auth/.well-known/jwks-pub.json');

if (response.ok) {
  const jwks = await response.json();
  console.log('Public keys retrieved successfully');
  console.log('Keys:', jwks);
} else {
  console.error(`Failed to retrieve JWKS: ${response.status}`);
}

Response

200 - */*

public key for the service

JSON Web Key Sets

keys

object[]

Show child attributes

Create Ambient Session

⌘I

API Overview

API References

Key Use Cases

Code Examples

Response

API Overview

API References

​Key Use Cases

​Code Examples

Response

Key Use Cases

Code Examples