Authorizations

Grant authorization to create or issue claims

POST https://api.borlaug.network/identity/dids/:did/authorizations

Controller or subject grants authorizations to consumers to create a claims and to issuers to attest claims.

Path Parameters

Name	Type	Description
did	string	DID for which authorizations are granted

Headers

Name	Type	Description
Authorization	string	BWS authorization token

Request Body

Name	Type	Description
issuers	array	Array of issuer DIDs
consumers	array	Array of consumer DIDs

200 Cake successfully retrieved.

{
    "result": "success",
    "block": "0x20fdb4a3e9ad6c1b0f609884b45a8622f6499f636ab2446d059655f7d9bf5b9b",
    "extrinsic": "0x5c15820bc6822ad8f90847a643257a036454b296d1168a779fbc872b489f056e",
}

404 Could not find a cake matching this query.

{
  issuers: [{
    "did" : "did:bws:91a3cf7061973df27db1707965e765f21bdc7165d9323b8c99ca10298fac152b",
   	"expiry" : "2001-07-08T00:34:00"
  }],
  consumers: [{
    "did" : "did:bws:91a3cf7061973df27db1707965e765f21bdc7165d9323b8c99ca10298fac152b",
   	"expiry" : "2001-07-08T00:34:00"
  }]
}  

Retrieve authorizations for a DID

GET https://api.borlaug.network/identity/dids/:did/authorizations

Headers

Name	Type	Description
Authorization	string	BWS authorization token

200

{
  issuers: [{
    "did" : "did:bws:91a3cf7061973df27db1707965e765f21bdc7165d9323b8c99ca10298fac152b",
   	"expiry" : "2001-07-08T00:34:00"
  }],
  consumers: [{
    "did" : "did:bws:91a3cf7061973df27db1707965e765f21bdc7165d9323b8c99ca10298fac152b",
   	"expiry" : "2001-07-08T00:34:00"
  }]
}  

Revoke authorizations

DELETE https://api.borlaug.network/identity/dids/:did/authorizations

Revoke permission for consumers or issuers.

Headers

Name	Type	Description
Content-Type	string	application/json
Authorization	string	BWS authoriztion token

Request Body

Name	Type	Description
issuers	array	DIDs of issuers
consumers	array	DIDs of consumers to revoke

200

Request Body

{
	"issuers": ["0x1b8349616d8ded3ea38b2ea22bed6930f9f93bf014f589b20bfa2cb9f2c77da2"],
	"consumers": ["0x1b8349616d8ded3ea38b2ea22bed6930f9f93bf014f589b20bfa2cb9f2c77da2"]
}