General
Create a VICAL
/v1/ecosystems/{ecosystemId}/vicalsCreates a Verified Issuer Certificate Authority List (VICAL) based on the policy of the requested ecosystem. Refer to VICAL to learn more about the VICAL purpose and data structure.
Roles
Authorization
bearerAuth In: header
Path Parameters
The UUID of the ecosystem
uuidResponse Body
application/json
curl -X POST "https://example.com/v1/ecosystems/497f6eca-6276-4993-bfeb-53cbbbba6f08/vicals"{ "vicalIssueID": 0, "date": "2019-08-24T14:15:22Z"}Retrieve all VICALs
/v1/ecosystems/{ecosystemId}/vicals/publicRetrieves all VICALs available in the requested ecosystem.
This endpoint is intended for public consumption, and as such does not require authentication.
Path Parameters
The UUID of the ecosystem
uuidQuery Parameters
Range size of returned list.
1 <= value <= 1000100Starting point for the list of entries.
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/ecosystems/497f6eca-6276-4993-bfeb-53cbbbba6f08/vicals/public"{ "data": [ { "vicalIssueID": 0, "date": "2019-08-24T14:15:22Z", "filename": "string", "isAutoPublished": true } ], "nextCursor": "string"}Retrieve a VICAL
/v1/ecosystems/{ecosystemId}/vicals/public/{vicalIssueId}Retrieves a specific VICAL from the requested ecosystem by providing the VICAL version identifier.
This endpoint is intended for public consumption, and as such does not require authentication.
Path Parameters
The UUID of the ecosystem
uuidUnique identifier of a specific VICAL version. This numeric value is continuously increased whenever a VICAL is created.
int32Response Body
application/cbor
application/json
curl -X GET "https://example.com/v1/ecosystems/497f6eca-6276-4993-bfeb-53cbbbba6f08/vicals/public/0""string"Retrieve latest VICAL
/v1/ecosystems/{ecosystemId}/vicals/public/latestRetrieves the latest VICAL from the requested ecosystem.
This endpoint is intended for public consumption, and as such does not require authentication.
Path Parameters
The UUID of the ecosystem
uuidResponse Body
application/cbor
application/json
curl -X GET "https://example.com/v1/ecosystems/497f6eca-6276-4993-bfeb-53cbbbba6f08/vicals/public/latest""string"Delete a VICAL
/v1/ecosystems/{ecosystemId}/vicals/{vicalIssueId}Deletes a specific VICAL from the requested ecosystem by providing the VICAL version identifier. Deleting a VICAL also deletes the issuer policy published from it, if one exists. This action cannot be undone.
A 404 is only returned when the ecosystem does not exist. Deleting a vicalIssueId that does
not exist within an existing ecosystem still returns 204.
Roles
Analytics Events
Authorization
bearerAuth In: header
Path Parameters
The UUID of the ecosystem
uuidUnique identifier of a specific VICAL version. This numeric value is continuously increased whenever a VICAL is created.
int32Response Body
application/json
application/json
curl -X DELETE "https://example.com/v1/ecosystems/497f6eca-6276-4993-bfeb-53cbbbba6f08/vicals/0"How would you rate this page?
Last updated on