Inviting participants | Truvera Documentation portal

Truvera Documentation portal

Website Truvera Workspace

parameters

Authorizations

Path parameters

registryIdstringrequired

A trust registry id

parameters

PARAMETERS /trust-registries/{registryId}/participants HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Accept: */*

Get Trust Registry participants

get

Returns the Trust Registry participants

Authorizations

Path parameters

registryIdstringrequired

A trust registry id

Query parameters

offsetinteger · int32optional

How many items to offset by for pagination

Default: 0

limitinteger · int32 · min: 1 · max: 64optional

How many items to return at one time (max 64)

Default: 64

schemaIdstringoptional

A schema id

Responses

application/json

objectoptional

application/json

get

GET /trust-registries/{registryId}/participants HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Accept: */*

{
  "total": 42,
  "list": [
    {
      "id": "23314808-eec6-4492-9a8a-8f32e34b8155",
      "name": "Truvera Issuer",
      "did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
      "description": "Labore voluptate adipisicing magna duis eu fugiat pariatur excepteur irure.",
      "logoUrl": "https://logo.truvera.io/participant",
      "infoUrl": "https://info.truvera.io/trust-registry/participant/1234",
      "status": "active",
      "role": "issuer",
      "created": "2025-04-17T22:43:03.819Z",
      "suspendedAt": "text",
      "issuerSchemas": [
        "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
      ],
      "verifierSchemas": [
        "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
      ]
    }
  ]
}

parameters

Authorizations

Path parameters

registryIdstringrequired

A trust registry id

participantIdstringrequired

A participant id

parameters

PARAMETERS /trust-registries/{registryId}/participants/{participantId} HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Accept: */*

Get Trust Registry participant

get

Returns the Trust Registry participant

Authorizations

Path parameters

registryIdstringrequired

A trust registry id

participantIdstringrequired

A participant id

Responses

application/json

objectoptional

application/json

get

GET /trust-registries/{registryId}/participants/{participantId} HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Accept: */*

{
  "id": "23314808-eec6-4492-9a8a-8f32e34b8155",
  "name": "Truvera Issuer",
  "did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
  "description": "Labore voluptate adipisicing magna duis eu fugiat pariatur excepteur irure.",
  "logoUrl": "https://logo.truvera.io/participant",
  "infoUrl": "https://info.truvera.io/trust-registry/participant/1234",
  "status": "active",
  "role": "issuer",
  "created": "2025-04-17T22:43:03.819Z",
  "suspendedAt": "text",
  "issuerSchemas": [
    "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
  ],
  "verifierSchemas": [
    "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
  ]
}

Remove Trust Registry participant

delete

Removes a Trust Registry participant

Authorizations

Path parameters

registryIdstringrequired

A trust registry id

participantIdstringrequired

A participant id

Responses

application/json

delete

DELETE /trust-registries/{registryId}/participants/{participantId} HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Accept: */*

No Content

parameters

Authorizations

Path parameters

registryIdstringrequired

A trust registry id

participantIdstringrequired

A participant id

parameters

PARAMETERS /trust-registries/{registryId}/participants/{participantId}/info HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Accept: */*

Accepts an invite to an ecosystem

post

Authorizations

Body

tokenstringrequired

The invite token

Example: eyJhbGc...2VVqUw

didstring · min: 32required

DID as fully qualified, typically. did:cheqd:

Example: did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59

infoUrlany ofrequiredExample: https://info.truvera.io/trust-registry/participant/1234

Trust registry participant info URL

Responses

application/json

objectoptional

application/json

post

POST /trust-registries/invitations/accept HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 159

{
  "token": "eyJhbGc...2VVqUw",
  "did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
  "infoUrl": "https://info.truvera.io/trust-registry/participant/1234"
}

{
  "id": "23314808-eec6-4492-9a8a-8f32e34b8155",
  "name": "Truvera Issuer",
  "did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
  "description": "Labore voluptate adipisicing magna duis eu fugiat pariatur excepteur irure.",
  "logoUrl": "https://logo.truvera.io/participant",
  "infoUrl": "https://info.truvera.io/trust-registry/participant/1234",
  "status": "active",
  "role": "issuer",
  "created": "2025-04-17T22:43:03.819Z",
  "suspendedAt": "text",
  "issuerSchemas": [
    "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
  ],
  "verifierSchemas": [
    "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
  ]
}

Decline the invitation of joining a trust registry

post

Authorizations

Body

tokenstringrequired

Trust Registry participant invite token

Example: eyJhbG...2VVqUw

maxAgeintegeroptional

Token max age in seconds

Example: 604800

Responses

application/json

post

POST /trust-registries/invitations/decline HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "token": "eyJhbG...2VVqUw",
  "maxAge": 604800
}

No Content

Snooze the invitation of joining a trust registry

post

Authorizations

Body

tokenstringrequired

Trust Registry participant invite token

Example: eyJhbG...2VVqUw

maxAgeintegeroptional

Token max age in seconds

Example: 604800

Responses

application/json

post

POST /trust-registries/invitations/snooze HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "token": "eyJhbG...2VVqUw",
  "maxAge": 604800
}

No Content

Invites a Trust Registry participant

post

Authorizations

Path parameters

registryIdstringrequired

A trust registry id

registryIdstringrequired

A Trust Registry ID

Body

maxAgeintegeroptional

Max age of the invite in seconds

issuerSchemasstring[]optional

Trust registry issuer schema

Example: https://schema.truvera.io/ExampleSchema-V5-1722512884923.json

verifierSchemasstring[]optional

Trust registry verifier schema

Example: https://schema.truvera.io/ExampleSchema-V5-1722512884923.json

Responses

application/json

objectoptional

application/json

post

POST /trust-registries/{registryId}/participants HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 178

{
  "maxAge": 1,
  "issuerSchemas": [
    "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
  ],
  "verifierSchemas": [
    "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
  ]
}

{
  "link": "https://trust-registry.truvera.io/ecosystems?token=eyJhbGc...2VVqUw"
}

Update a Trust Registry participant

patch

Authorizations

Path parameters

registryIdstringrequired

A trust registry id

participantIdstringrequired

A participant id

registryIdstringrequired

A Trust Registry ID

Body

namestringoptional

Trust registry participant name

Example: Truvera Issuer

logoUrlstring · uri · min: 8optional

Trust registry participant logo URL

Example: https://logo.truvera.io/trust-registry-participant/1234

infoUrlany ofoptionalExample: https://info.truvera.io/trust-registry/participant/1234

Trust registry participant info URL

statusstring · enumoptional

Trust registry participant status

Example: activeAvailable options:

suspendedAtstringoptional

issuerSchemasstring[]optional

Trust registry participant issuer schema

Example: https://schema.truvera.io/ExampleSchema-V5-1722512884923.json

verifierSchemasstring[]optional

Trust registry participant verifier schema

Example: https://schema.truvera.io/ExampleSchema-V5-1722512884923.json

Responses

application/json

objectoptional

application/json

patch

PATCH /trust-registries/{registryId}/participants/{participantId} HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 366

{
  "name": "Truvera Issuer",
  "logoUrl": "https://logo.truvera.io/trust-registry-participant/1234",
  "infoUrl": "https://info.truvera.io/trust-registry/participant/1234",
  "status": "active",
  "suspendedAt": "text",
  "issuerSchemas": [
    "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
  ],
  "verifierSchemas": [
    "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
  ]
}

{
  "id": "23314808-eec6-4492-9a8a-8f32e34b8155",
  "name": "Truvera Issuer",
  "did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
  "description": "Labore voluptate adipisicing magna duis eu fugiat pariatur excepteur irure.",
  "logoUrl": "https://logo.truvera.io/participant",
  "infoUrl": "https://info.truvera.io/trust-registry/participant/1234",
  "status": "active",
  "role": "issuer",
  "created": "2025-04-17T22:43:03.819Z",
  "suspendedAt": "text",
  "issuerSchemas": [
    "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
  ],
  "verifierSchemas": [
    "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
  ]
}

Deprecated

Update own Trust Registry participant info

patch

Authorizations

Path parameters

registryIdstringrequired

A trust registry id

participantIdstringrequired

A participant id

Body

infoUrlany ofoptionalExample: https://info.truvera.io/trust-registry/participant/1234

Trust registry participant info URL

Responses

application/json

objectoptional

application/json

patch

PATCH /trust-registries/{registryId}/participants/{participantId}/info HTTP/1.1
Host: api-testnet.truvera.io
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 69

{
  "infoUrl": "https://info.truvera.io/trust-registry/participant/1234"
}

{
  "id": "23314808-eec6-4492-9a8a-8f32e34b8155",
  "name": "Truvera Issuer",
  "did": "did:cheqd:testnet:ac2b9027-ec1a-4ee2-aad1-1e316e7d6f59",
  "description": "Labore voluptate adipisicing magna duis eu fugiat pariatur excepteur irure.",
  "logoUrl": "https://logo.truvera.io/participant",
  "infoUrl": "https://info.truvera.io/trust-registry/participant/1234",
  "status": "active",
  "role": "issuer",
  "created": "2025-04-17T22:43:03.819Z",
  "suspendedAt": "text",
  "issuerSchemas": [
    "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
  ],
  "verifierSchemas": [
    "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
  ]
}