Organizations

Trinsic's new Provider API allows users to create organizations programmatically. Thousands of organizations can be created using the API to orchestrate entire use cases with SSI. Vendors and software platforms can use our API to facilitate industry wide adoption of portable digital identity.

All organizations that are created are registered on a distributed ledger of your choice. When you create a new organization, a decentralized identifier is written and allows anybody, anywhere to verify that any credentials you issue to someone actually came from you.

When an organization is created on the Sovrin Live network, there are fees involved in creating the organization and creating any credential templates that are written on the network. Learn more about our pricing model on our pricing page. Further, the Provider API is a paid feature. You must have a Developer, Production, or Enterprise account to use it.

There is also a Provider API reference app that demonstrates how to use it in a web app.

Generating a Provider Key

To use the Provider API, you need to use a Provider Key. To do so, follow these steps:

  1. Go to Trinsic Studio and login or create an account.
  2. Click on the account dropdown in the top-right of the screen and select the Provider Keys link.
  3. Click the + NEW KEY button and enter a name for the key. Then click on the CREATE button.
  4. COPY THE KEY and store it somewhere securely. You will not be able to see this key once the slider is closed, so be sure to copy it.

Create an Organization

API Reference

This operation uses the POST /tenants endpoint on the Provider API.

Example

Steps:

  1. Go to the Trinsic Studio and login.
  2. Click on the + Organization, and create an organization with the name of your choice on the Sovrin Staging Network.
  3. You can upload a logo for your organization, or one will be created for you if you choose not to.

List Organizations

API Reference

This operation uses the GET /tenants endpoint on the Provider API.

Example

Steps:

  1. Go to the Trinsic Studio and login.
  2. The Trinsic Studio Dashboard automatically loads all of the organizations associated with your account.

Get Organization Details

API Reference

This operation uses the GET /tenants/{tenantId} endpoint on the Provider API.

Example

Steps:

  1. Go to the Trinsic Studio and login.
  2. Click on the organization of your choice to go to the Organization Overview.

Update an Organization

API Reference

This operation uses the PUT /tenants/{tenantId} endpoint on the Provider API.

Example

Updating an organization is currently only available through the Provider API. There is no way to do this in Trinsic Studio.

Get an Organization's Access Token

API Reference

This operation uses the GET /tenants/{tenantId}/keys endpoint on the Provider API.

Example

Steps:

  1. Go to the Trinsic Studio and login.
  2. Click on the organization of your choice to go to the Organization Overview.
  3. The access token is listed on the right side of the view.
  4. You can copy the access token to the clipboard by clicking on it.

Update an Organization's Access Token

API Reference

This operation uses the PATCH /tenants/{tenantId}/keys endpoint on the Provider API.

Example

Updating an organization's access token is currently only available through the Provider API. There is no way to do this in Trinsic Studio.