SDK — add a signer to a wallet in a workspace (stubbed)

curl --request POST \ --url https://app.dynamicauth.com/api/v0/sdk/{environmentId}/businessAccounts/{businessAccountId}/wallets/{walletId}/signers \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "identifier": "<string>" } '

{ "id": "95b11417-f18f-457f-8804-68e361f9164f", "businessAccountId": "95b11417-f18f-457f-8804-68e361f9164f", "walletId": "95b11417-f18f-457f-8804-68e361f9164f", "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "shareSetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "derivedFromUserId": "3c90c3cc-0d44-4b50-8888-8dd25736052a", "apiKeyIdentityRef": "<string>", "expiresAt": "2023-11-07T05:31:56Z", "revokedAt": "2023-11-07T05:31:56Z", "createdAt": "2023-11-07T05:31:56Z" }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

environmentId

string

required

ID of the environment

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

businessAccountId

string

required

ID of the business account

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

walletId

string

required

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

Body

application/json

SDK addSigner body. Same user resolution shape as addMember (userId OR identifier + type), plus signerType for the signer-role enum (endUser/server). type here is the user-resolution type, NOT the signer type — signerType lives on a dedicated field.

signerType

enum<string>

required

Type of a business account signer

Available options:

endUser,

server

userId

string<uuid> | null

identifier

string | null

type

enum<string>

Available options:

email,

id,

externalUserId,

phoneNumber,

socialUsername,

socialAccountId

Response

Signer accepted; reshare pending

Signing-reach assignment (per signer-wallet pair)

string

required

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

businessAccountId

string

required

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

walletId

string

required

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

type

enum<string>

required

Type of a business account signer

Available options:

endUser,

server

userId

string<uuid> | null

Required when type=endUser; null for type=server

Set after reshare ceremony completes

derivedFromUserId

string<uuid> | null

apiKeyIdentityRef

string | null

Required when type=server

expiresAt

string<date-time> | null

revokedAt

string<date-time> | null

createdAt

string<date-time>