curl --request POST \
--url https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/wallets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"connectionId": "<string>",
"displayName": "<string>",
"networks": [
"<string>"
],
"ownerGroup": {
"members": [
{
"factors": [
{
"kind": "passkey"
}
],
"needed": 1,
"person": "<string>",
"walletId": "<string>"
}
],
"threshold": 1,
"countedPerMember": [
"<string>"
],
"minMemberFactors": 1
},
"returnUrl": "<string>"
}
'import requests
url = "https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/wallets"
payload = {
"connectionId": "<string>",
"displayName": "<string>",
"networks": ["<string>"],
"ownerGroup": {
"members": [
{
"factors": [{ "kind": "passkey" }],
"needed": 1,
"person": "<string>",
"walletId": "<string>"
}
],
"threshold": 1,
"countedPerMember": ["<string>"],
"minMemberFactors": 1
},
"returnUrl": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
connectionId: '<string>',
displayName: '<string>',
networks: ['<string>'],
ownerGroup: {
members: [
{
factors: [{kind: 'passkey'}],
needed: 1,
person: '<string>',
walletId: '<string>'
}
],
threshold: 1,
countedPerMember: ['<string>'],
minMemberFactors: 1
},
returnUrl: '<string>'
})
};
fetch('https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/wallets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/wallets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'connectionId' => '<string>',
'displayName' => '<string>',
'networks' => [
'<string>'
],
'ownerGroup' => [
'members' => [
[
'factors' => [
[
'kind' => 'passkey'
]
],
'needed' => 1,
'person' => '<string>',
'walletId' => '<string>'
]
],
'threshold' => 1,
'countedPerMember' => [
'<string>'
],
'minMemberFactors' => 1
],
'returnUrl' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/wallets"
payload := strings.NewReader("{\n \"connectionId\": \"<string>\",\n \"displayName\": \"<string>\",\n \"networks\": [\n \"<string>\"\n ],\n \"ownerGroup\": {\n \"members\": [\n {\n \"factors\": [\n {\n \"kind\": \"passkey\"\n }\n ],\n \"needed\": 1,\n \"person\": \"<string>\",\n \"walletId\": \"<string>\"\n }\n ],\n \"threshold\": 1,\n \"countedPerMember\": [\n \"<string>\"\n ],\n \"minMemberFactors\": 1\n },\n \"returnUrl\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/wallets")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"connectionId\": \"<string>\",\n \"displayName\": \"<string>\",\n \"networks\": [\n \"<string>\"\n ],\n \"ownerGroup\": {\n \"members\": [\n {\n \"factors\": [\n {\n \"kind\": \"passkey\"\n }\n ],\n \"needed\": 1,\n \"person\": \"<string>\",\n \"walletId\": \"<string>\"\n }\n ],\n \"threshold\": 1,\n \"countedPerMember\": [\n \"<string>\"\n ],\n \"minMemberFactors\": 1\n },\n \"returnUrl\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/wallets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"connectionId\": \"<string>\",\n \"displayName\": \"<string>\",\n \"networks\": [\n \"<string>\"\n ],\n \"ownerGroup\": {\n \"members\": [\n {\n \"factors\": [\n {\n \"kind\": \"passkey\"\n }\n ],\n \"needed\": 1,\n \"person\": \"<string>\",\n \"walletId\": \"<string>\"\n }\n ],\n \"threshold\": 1,\n \"countedPerMember\": [\n \"<string>\"\n ],\n \"minMemberFactors\": 1\n },\n \"returnUrl\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"signingRequest": {
"id": "<string>",
"approvalUrl": "<string>"
},
"status": "pending",
"wallet": {
"connectionId": "<string>",
"countedPerMember": [
"<string>"
],
"createdAt": "2023-11-07T05:31:56Z",
"displayName": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"family": "evm",
"homeProvider": "privy",
"id": "<string>",
"members": [
{
"choosing": true,
"factors": [
{
"class": "heldByYou",
"kind": "passkey",
"curve": "secp256k1",
"identity": "<string>"
}
],
"needed": 1,
"person": "<string>",
"proven": true,
"approvesWithWallet": true,
"memberWallet": {
"address": "<string>",
"payload": "<string>",
"walletId": "<string>",
"providerOrganizationId": "<string>"
},
"memberWalletOffers": [
{
"address": "<string>",
"payload": "<string>",
"walletId": "<string>",
"providerOrganizationId": "<string>"
}
],
"memberWalletOffersUnavailable": "<string>",
"memberWalletUnavailable": "<string>",
"memberWalletsRefused": [
{
"address": "<string>",
"code": "<string>",
"message": "<string>",
"walletId": "<string>"
}
],
"name": "<string>",
"ownerMatches": [
{
"kind": "passkey",
"address": "<string>",
"credentialId": "<string>",
"curve": "secp256k1",
"identity": "<string>",
"matchToken": "<string>",
"publicKey": "<string>"
}
],
"ownerMatchesUnavailable": "<string>",
"ownersConfirmedAt": "2023-11-07T05:31:56Z",
"yours": true
}
],
"missing": [
"<string>"
],
"networks": [
"<string>"
],
"scope": "personal",
"status": "pending",
"threshold": 1,
"workspaceId": "<string>",
"address": "<string>",
"approvalUrl": "<string>",
"createdBy": "<string>",
"creatorTradeGrant": {
"status": "notRequested",
"accountId": "<string>",
"entitlementId": "<string>",
"reason": "<string>"
},
"endedBy": "<string>",
"failureCode": "<string>",
"home": {
"providerWalletId": "<string>",
"providerOrganizationId": "<string>"
},
"networkNames": {},
"registeredAt": "2023-11-07T05:31:56Z",
"registrationFailure": "<string>",
"returnTo": {
"integratorName": "<string>",
"origin": "<string>",
"url": "<string>"
},
"signingRequestId": "<string>",
"startedWithApiKey": {
"label": "<string>",
"creatorSteppedUpAt": "2023-11-07T05:31:56Z"
}
},
"walletId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}Create a wallet
Starts a wallet (scope: organisation, or personal for the key’s own member) on a wallet connection (connectionId: a workspace connection, or platform-turnkey for the one TetraFi provides) with the owner group you choose (ownerGroup: the people who approve and the threshold; send each person with an empty factors list, since each chooses their own sign-in methods on TetraFi’s page). Everything is checked before anything is recorded: the connection’s capabilities, the threshold and each person’s current membership. The answer is 202 with the pending wallet and the signing request’s id. An API key never receives an approval capability, never approves and never names a person’s sign-in methods (an owner sent with factors is 403 API_KEY_WALLET_FACTORS_REFUSED, nothing recorded): each person, the key’s own member included, chooses and proves their own on their own signing page, so no wallet exists at the provider until the owners have approved. Read the creation with GET …/wallets/{walletId} until its status is active (or failed, cancelled or declined).
Send the person to signingRequest.approvalUrl (also wallet.approvalUrl): TetraFi’s own page, where they sign in, choose their sign-in methods and set them up. With returnUrl, an https URL whose exact origin (scheme, host and port) is one of the workspace’s registered wallet callback origins, the page sends them back there with signingRequestId and outcome added to its query: approved or pending (their part is recorded; pending while the wallet waits for others) at once, and refused only after the page has shown why and the person chose to go back. The creation’s returnTo echoes it. An origin that is not registered, or TetraFi’s own app or signing origin, is 400 RETURN_URL_NOT_REGISTERED.
A member’s own API key may call this, checked as that member’s permissions and standing are now, with the scope the body needs: orders_write for the member’s own personal wallet (with View wallets), treasury_write for an organisation wallet (with Manage wallets). A key without it is 403 INSUFFICIENT_SCOPE, details.requiredScope naming the one it needs. A key sends no stepUpProof, tradeFromThisWallet or initialAccess (403 API_KEY_WALLET_GRANT_REFUSED); access and grants are set in the app. A service account’s key is 403 API_KEY_WALLET_CREATOR_NOT_A_PERSON.
An end user’s wallet: a member’s own key sends scope personal with an owner group of that member alone, no factors (another owner is 409 WALLET_CREATION_PERSONAL_OWNER). Only that member, signed in on the approval page, chooses its sign-in methods and approves it; send them to approvalUrl with your returnUrl. End-user wallets need Advanced on this platform (403 ADVANCED_MODE_DISABLED otherwise).
For an organisation wallet, the key’s own member confirms it was them (an authenticator app or security key) when they first open the approval page, before the wallet can be completed; startedWithApiKey names the key. Send an Idempotency-Key: the same key and body make one creation, and the same key with another body is 409 IDEMPOTENCY_CONFLICT.
curl --request POST \
--url https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/wallets \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"connectionId": "<string>",
"displayName": "<string>",
"networks": [
"<string>"
],
"ownerGroup": {
"members": [
{
"factors": [
{
"kind": "passkey"
}
],
"needed": 1,
"person": "<string>",
"walletId": "<string>"
}
],
"threshold": 1,
"countedPerMember": [
"<string>"
],
"minMemberFactors": 1
},
"returnUrl": "<string>"
}
'import requests
url = "https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/wallets"
payload = {
"connectionId": "<string>",
"displayName": "<string>",
"networks": ["<string>"],
"ownerGroup": {
"members": [
{
"factors": [{ "kind": "passkey" }],
"needed": 1,
"person": "<string>",
"walletId": "<string>"
}
],
"threshold": 1,
"countedPerMember": ["<string>"],
"minMemberFactors": 1
},
"returnUrl": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
connectionId: '<string>',
displayName: '<string>',
networks: ['<string>'],
ownerGroup: {
members: [
{
factors: [{kind: 'passkey'}],
needed: 1,
person: '<string>',
walletId: '<string>'
}
],
threshold: 1,
countedPerMember: ['<string>'],
minMemberFactors: 1
},
returnUrl: '<string>'
})
};
fetch('https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/wallets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/wallets",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'connectionId' => '<string>',
'displayName' => '<string>',
'networks' => [
'<string>'
],
'ownerGroup' => [
'members' => [
[
'factors' => [
[
'kind' => 'passkey'
]
],
'needed' => 1,
'person' => '<string>',
'walletId' => '<string>'
]
],
'threshold' => 1,
'countedPerMember' => [
'<string>'
],
'minMemberFactors' => 1
],
'returnUrl' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/wallets"
payload := strings.NewReader("{\n \"connectionId\": \"<string>\",\n \"displayName\": \"<string>\",\n \"networks\": [\n \"<string>\"\n ],\n \"ownerGroup\": {\n \"members\": [\n {\n \"factors\": [\n {\n \"kind\": \"passkey\"\n }\n ],\n \"needed\": 1,\n \"person\": \"<string>\",\n \"walletId\": \"<string>\"\n }\n ],\n \"threshold\": 1,\n \"countedPerMember\": [\n \"<string>\"\n ],\n \"minMemberFactors\": 1\n },\n \"returnUrl\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/wallets")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"connectionId\": \"<string>\",\n \"displayName\": \"<string>\",\n \"networks\": [\n \"<string>\"\n ],\n \"ownerGroup\": {\n \"members\": [\n {\n \"factors\": [\n {\n \"kind\": \"passkey\"\n }\n ],\n \"needed\": 1,\n \"person\": \"<string>\",\n \"walletId\": \"<string>\"\n }\n ],\n \"threshold\": 1,\n \"countedPerMember\": [\n \"<string>\"\n ],\n \"minMemberFactors\": 1\n },\n \"returnUrl\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tetrafi.io/api/v1/workspaces/{workspaceId}/wallets")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"connectionId\": \"<string>\",\n \"displayName\": \"<string>\",\n \"networks\": [\n \"<string>\"\n ],\n \"ownerGroup\": {\n \"members\": [\n {\n \"factors\": [\n {\n \"kind\": \"passkey\"\n }\n ],\n \"needed\": 1,\n \"person\": \"<string>\",\n \"walletId\": \"<string>\"\n }\n ],\n \"threshold\": 1,\n \"countedPerMember\": [\n \"<string>\"\n ],\n \"minMemberFactors\": 1\n },\n \"returnUrl\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"signingRequest": {
"id": "<string>",
"approvalUrl": "<string>"
},
"status": "pending",
"wallet": {
"connectionId": "<string>",
"countedPerMember": [
"<string>"
],
"createdAt": "2023-11-07T05:31:56Z",
"displayName": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"family": "evm",
"homeProvider": "privy",
"id": "<string>",
"members": [
{
"choosing": true,
"factors": [
{
"class": "heldByYou",
"kind": "passkey",
"curve": "secp256k1",
"identity": "<string>"
}
],
"needed": 1,
"person": "<string>",
"proven": true,
"approvesWithWallet": true,
"memberWallet": {
"address": "<string>",
"payload": "<string>",
"walletId": "<string>",
"providerOrganizationId": "<string>"
},
"memberWalletOffers": [
{
"address": "<string>",
"payload": "<string>",
"walletId": "<string>",
"providerOrganizationId": "<string>"
}
],
"memberWalletOffersUnavailable": "<string>",
"memberWalletUnavailable": "<string>",
"memberWalletsRefused": [
{
"address": "<string>",
"code": "<string>",
"message": "<string>",
"walletId": "<string>"
}
],
"name": "<string>",
"ownerMatches": [
{
"kind": "passkey",
"address": "<string>",
"credentialId": "<string>",
"curve": "secp256k1",
"identity": "<string>",
"matchToken": "<string>",
"publicKey": "<string>"
}
],
"ownerMatchesUnavailable": "<string>",
"ownersConfirmedAt": "2023-11-07T05:31:56Z",
"yours": true
}
],
"missing": [
"<string>"
],
"networks": [
"<string>"
],
"scope": "personal",
"status": "pending",
"threshold": 1,
"workspaceId": "<string>",
"address": "<string>",
"approvalUrl": "<string>",
"createdBy": "<string>",
"creatorTradeGrant": {
"status": "notRequested",
"accountId": "<string>",
"entitlementId": "<string>",
"reason": "<string>"
},
"endedBy": "<string>",
"failureCode": "<string>",
"home": {
"providerWalletId": "<string>",
"providerOrganizationId": "<string>"
},
"networkNames": {},
"registeredAt": "2023-11-07T05:31:56Z",
"registrationFailure": "<string>",
"returnTo": {
"integratorName": "<string>",
"origin": "<string>",
"url": "<string>"
},
"signingRequestId": "<string>",
"startedWithApiKey": {
"label": "<string>",
"creatorSteppedUpAt": "2023-11-07T05:31:56Z"
}
},
"walletId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}{
"docUrl": "<string>",
"error": "<string>",
"message": "<string>",
"retryable": true,
"timestamp": "2023-11-07T05:31:56Z",
"details": {
"capabilityBlockers": [
{
"code": "WORKSPACE_NOT_FOUND",
"estimate": "minutes",
"message": "<string>",
"unlockStep": "finishOnboarding",
"currentlyDue": [
"<string>"
]
}
],
"conflicts": [
"<string>"
],
"consentedWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"currentWindow": {
"cadence": {
"dayBasis": "calendarDays",
"kind": "intraday",
"everyHours": 1,
"localTimes": [
"<string>"
]
},
"scheduleId": "<string>",
"scheduleLabel": "<string>",
"scheduleVersion": 123,
"snapshotAt": "2023-11-07T05:31:56Z",
"windowId": "<string>",
"assumedBoundary": {
"lpName": "<string>",
"source": "<string>",
"timeZone": "<string>"
},
"cutoffAt": "2023-11-07T05:31:56Z",
"paymentDeadlineAt": "2023-11-07T05:31:56Z",
"settlementBasis": "clock",
"settlesBy": "2023-11-07T05:31:56Z",
"statementIssuer": "<string>"
},
"field": "<string>",
"reason": "clockUnavailable",
"remediation": "<string>",
"retryAfter": "PT120S",
"value": "<string>"
},
"next": {
"kind": "order"
},
"requestId": "<string>"
}Authorizations
Headers
The dated API version to answer this request in. Without it, an API key's requests use the version the key pinned when it was created, and a member session uses the current version. A value that is not exactly one supported date answers 400 API_VERSION_UNSUPPORTED before anything runs. The response's TetraFi-Version header names the version used.
2026-11-17 Body
An organisation wallet to create (scope organisation): the wallet connection, family, networks and name, the owner group that approves it, and optionally the registered URL the approval page returns each person to.
Where TetraFi's approval page sends each person of an organisation wallet
back once the signing page has recorded their part: an https URL (plain
http only on localhost) whose exact origin (scheme, host and port) is one
of the workspace's registered embedded-wallet callback origins. The person
returns to it with signingRequestId and outcome added to its query:
approved (their part is recorded), pending (recorded, the wallet waits
for others) or refused (the signing page refused to finish; the person is
shown why first and goes back only when they choose). Any other URL, and one
on TetraFi's own app or signing origin, is refused with 400
RETURN_URL_NOT_REGISTERED.
Response
A creation body: the pending wallet and the caller's signing request. Nothing exists at the provider until the signing page completes it
202 for a creation body: the pending wallet and the caller's signing request.
The state of a wallet being created. Clients must read a value they do not know as not usable yet.
New values may be added; treat unknown values as other.
pending, creating, uncertain, created, active, readbackMismatch, failed, expired, cancelled, declined