Inviting participants

PreviousCreating a Trust Registry NextVerifiers and Public info

Last updated 5 months ago

Was this helpful?

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

200

List of participants

application/json

400

Application error

application/json

401

Unauthorized.

application/json

404

Trust Registry was not found.

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-06-01T13:03:44.342Z",
      "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

200

Participant information

application/json

400

Application error

application/json

401

Unauthorized.

application/json

404

Trust Registry was not found.

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-06-01T13:03:44.342Z",
  "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

200

Trust Registry participant has been deleted

400

Something went wrong with deleting the Trust Registry

application/json

401

Unauthorized.

application/json

404

Trust Registry participant does not exist

application/json

500

Something went wrong with deleting the Trust Registry

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

string · uri · min: 8Optional

Trust registry participant info URL

string · enumOptional

Trust registry participant info URL

Possible values:

Responses

200

Invite was accepted

application/json

400

Error accepting invite

application/json

401

Unauthorized.

application/json

402

Transaction limit reached or upgrade required to proceed

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-06-01T13:03:44.342Z",
  "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

200

Invitation has been declined

400

Invalid invite token

application/json

401

Unauthorized.

application/json

402

Transaction limit reached or upgrade required to proceed

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

200

Invitation has been declined

400

Invalid invite token

application/json

401

Unauthorized.

application/json

402

Transaction limit reached or upgrade required to proceed

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

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

200

Trust Registry participant has been invited

application/json

400

Error inviting Trust Registry participant

application/json

401

Unauthorized.

application/json

402

Transaction limit reached or upgrade required to proceed

application/json

404

Trust Registry was not found.

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

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

string · uri · min: 8Optional

Trust registry participant info URL

string · enumOptional

Trust registry participant info URL

Possible values:

statusstring · enumOptional

Trust registry participant status

Example: activePossible values:

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

200

Trust Registry participant has been updated

application/json

400

Error updating Trust Registry participant

application/json

401

Unauthorized.

application/json

402

Transaction limit reached or upgrade required to proceed

application/json

404

Trust Registry was not found.

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-06-01T13:03:44.342Z",
  "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

string · uri · min: 8Optional

Trust registry participant info URL

string · enumOptional

Trust registry participant info URL

Possible values:

Responses

200

Trust Registry participant has been updated

application/json

400

Error updating Trust Registry participant

application/json

401

Unauthorized.

application/json

402

Transaction limit reached or upgrade required to proceed

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-06-01T13:03:44.342Z",
  "suspendedAt": "text",
  "issuerSchemas": [
    "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
  ],
  "verifierSchemas": [
    "https://schema.truvera.io/ExampleSchema-V5-1722512884923.json"
  ]
}