Skip to content

Examples

Example: Adding a Witness via Admin API

curl -X POST "https://did.example.org/api/admin/witnesses" \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "did:key:z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK",
    "label": "Example Witness Service",
    "invitationUrl": "https://witness.example.com/oob-invite?oob=eyJAdHlwZSI6..."
  }'

Example: Retrieving Invitation

curl "https://did.example.org/api/invitations?_oobid=z6MkhaXgBZDvotDkL5257faiztiGiC2QtKLGpbnnEGta2doK"

Example: Getting Server Parameters

curl -X GET "https://did.example.org/api/admin/parameters" \
  -H "x-api-key: your-api-key"

Additional Resources

  • API Documentation: Available at /docs when the server is running
  • Explorer UI: Available at /api/explorer for browsing DIDs and resources
  • DID WebVH Specification: https://identity.foundation/didwebvh