v1

latestOpenAPI 3.1.02026-07-2685154311.7 KB

Entity

Create a delegate token

Creates a delegate token for an entity. The delegate token is a JWT that allows a delegate to act on behalf of the entity. If a delegate DID already exists for the given delegateId, it will be reused.

post/entities/{entityDID}/delegateToken

Path parameters

entityDIDstring did required

Decentralized Identifier (DID)

Example:did:web:vasps.id:jxnl0411:at

The DID of the entity

Request body

entityDIDstring required

The entity DID (must match URL parameter)

delegateIdstring required

Unique identifier for the delegate

Example request

{
  "entityDID": "did:web:example.com"
}

Response

Delegate token created successfully

access_tokenstring required

JWT access token for the delegate

token_type'Bearer' required

Token type (always Bearer)

delegateDidstring required

DID of the created/retrieved delegate

Example response

{
  "delegateDid": "did:web:example.com"
}