Step 2 Update users role (passkey)

curl --request POST \
  --url https://sandbox.api.byzantine.fi/v1/submit/update-users-role \
  --header 'Content-Type: application/json' \
  --header 'X-Pubkey: <x-pubkey>' \
  --header 'X-Pubkey, X-Timestamp, X-Signature: <api-key>' \
  --header 'X-Signature: <x-signature>' \
  --header 'X-Timestamp: <x-timestamp>' \
  --data '
{
  "signedBody": {
    "type": "ACTIVITY_TYPE_UPDATE_ROOT_QUORUM",
    "timestampMs": "<string>",
    "organizationId": "d107c1e1-766a-4091-802c-de61a3973e91",
    "parameters": {
      "threshold": 1,
      "userIds": [
        "<string>"
      ]
    }
  },
  "webAuthnStamp": "<string>"
}
'

import requests

url = "https://sandbox.api.byzantine.fi/v1/submit/update-users-role"

payload = {
    "signedBody": {
        "type": "ACTIVITY_TYPE_UPDATE_ROOT_QUORUM",
        "timestampMs": "<string>",
        "organizationId": "d107c1e1-766a-4091-802c-de61a3973e91",
        "parameters": {
            "threshold": 1,
            "userIds": ["<string>"]
        }
    },
    "webAuthnStamp": "<string>"
}
headers = {
    "X-Pubkey": "<x-pubkey>",
    "X-Timestamp": "<x-timestamp>",
    "X-Signature": "<x-signature>",
    "X-Pubkey, X-Timestamp, X-Signature": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Pubkey': '<x-pubkey>',
    'X-Timestamp': '<x-timestamp>',
    'X-Signature': '<x-signature>',
    'X-Pubkey, X-Timestamp, X-Signature': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    signedBody: {
      type: 'ACTIVITY_TYPE_UPDATE_ROOT_QUORUM',
      timestampMs: '<string>',
      organizationId: 'd107c1e1-766a-4091-802c-de61a3973e91',
      parameters: {threshold: 1, userIds: ['<string>']}
    },
    webAuthnStamp: '<string>'
  })
};

fetch('https://sandbox.api.byzantine.fi/v1/submit/update-users-role', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "threshold": 1,
  "rootUserIds": [
    "<string>"
  ]
}

POST

submit

update-users-role

Step 2 Update users role (passkey)

curl --request POST \
  --url https://sandbox.api.byzantine.fi/v1/submit/update-users-role \
  --header 'Content-Type: application/json' \
  --header 'X-Pubkey: <x-pubkey>' \
  --header 'X-Pubkey, X-Timestamp, X-Signature: <api-key>' \
  --header 'X-Signature: <x-signature>' \
  --header 'X-Timestamp: <x-timestamp>' \
  --data '
{
  "signedBody": {
    "type": "ACTIVITY_TYPE_UPDATE_ROOT_QUORUM",
    "timestampMs": "<string>",
    "organizationId": "d107c1e1-766a-4091-802c-de61a3973e91",
    "parameters": {
      "threshold": 1,
      "userIds": [
        "<string>"
      ]
    }
  },
  "webAuthnStamp": "<string>"
}
'

import requests

url = "https://sandbox.api.byzantine.fi/v1/submit/update-users-role"

payload = {
    "signedBody": {
        "type": "ACTIVITY_TYPE_UPDATE_ROOT_QUORUM",
        "timestampMs": "<string>",
        "organizationId": "d107c1e1-766a-4091-802c-de61a3973e91",
        "parameters": {
            "threshold": 1,
            "userIds": ["<string>"]
        }
    },
    "webAuthnStamp": "<string>"
}
headers = {
    "X-Pubkey": "<x-pubkey>",
    "X-Timestamp": "<x-timestamp>",
    "X-Signature": "<x-signature>",
    "X-Pubkey, X-Timestamp, X-Signature": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'X-Pubkey': '<x-pubkey>',
    'X-Timestamp': '<x-timestamp>',
    'X-Signature': '<x-signature>',
    'X-Pubkey, X-Timestamp, X-Signature': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    signedBody: {
      type: 'ACTIVITY_TYPE_UPDATE_ROOT_QUORUM',
      timestampMs: '<string>',
      organizationId: 'd107c1e1-766a-4091-802c-de61a3973e91',
      parameters: {threshold: 1, userIds: ['<string>']}
    },
    webAuthnStamp: '<string>'
  })
};

fetch('https://sandbox.api.byzantine.fi/v1/submit/update-users-role', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "threshold": 1,
  "rootUserIds": [
    "<string>"
  ]
}

Authorizations

X-Pubkey, X-Timestamp, X-Signature

string

header

required

Headers

X-Pubkey

string

required

Integrator's ECDSA public key (P-256 curve, compressed SEC1 format). Example: 0x038fedef7c12f93bbf342ad8943b7a825a3b41f61c9dc118b2c718efebabbf62fd

X-Timestamp

string

required

Unix timestamp in seconds (UTC). Must be within tolerance window (1 minute) to prevent replay attacks. Example: 1760375826

X-Signature

string

required

ECDSA signature (DER-encoded, hex with 0x prefix). Signs the message: {timestamp}{METHOD}{path_and_query}{json_body}. Example: 0x3045022100...

Body

application/json

Body to update the root quorum of a Byzantine account

signedBody

object

required

The object that needs to be signed by the end user to update the root quorum of a Byzantine account.

Show child attributes

webAuthnStamp

string

required

Cryptographically passkey signed (stamped). For more info, see authentication methods.

Response

Users' roles updated successfully

Response body when users' roles are successfully updated

accountId

string<uuid>

required

A UUID string

Example:

"550e8400-e29b-41d4-a716-446655440000"

threshold

integer<int32>

required

The new threshold of unique approvals to reach quorum.

Required range: x >= 0

Example:

1

rootUserIds

string[]

required

The unique identifiers of users who now comprise the quorum set.

Step 1 Get update role payload (passkey)List all products

Integrator API

API endpoints

Step 2 Update users role (passkey)

Authorizations

Headers

Body

Response