AddressBookService
Copy Address Book Entry
Copy one address-book entry into another visible root or subaccount book. Interactive callers with enrolled MFA need recent assurance; API keys need MANAGE_ADDRESS_BOOK.
Request
curl --request POST \ \
--url 'https://api.testnet.polyester.com/v1/auth/address-book-entries/1:copy' \
--header 'Accept: */*' \
--header 'X-API-KEY-ID: YOUR_API_KEY_ID' \
--header 'X-API-TIMESTAMP: YOUR_API_TIMESTAMP' \
--header 'X-API-SIGNATURE: YOUR_API_SIGNATURE' \
--header 'Content-Type: application/json' \
--data '{
"targetSubaccountId": "6789012345678"
}'Responses
{
"entry": {
"addressBookEntryId": "1",
"createdAt": "2025-01-01T00:00:00Z",
"external": {
"address": "0x3333333333333333333333333333333333333333",
"polychainChainId": 1
},
"kind": "EXTERNAL_CHAIN",
"label": "Treasury Wallet",
"note": "Primary treasury destination.",
"revision": "1",
"scope": {
"rootAccountId": "7563897446546",
"scopeType": "ROOT",
"subaccountId": "37HAHbBRCeY"
},
"tags": [
{
"color": "#7C3AED",
"createdAt": "2025-01-01T00:00:00Z",
"name": "Treasury",
"scope": {
"rootAccountId": "7563897446546",
"scopeType": "ROOT",
"subaccountId": "37bbZLLApNf"
},
"tagId": "1",
"updatedAt": "2025-01-01T00:00:00Z"
}
],
"updatedAt": "2025-01-01T00:00:00Z"
}
}Address-book entry id to copy.
Optional destination subaccount. Omit to copy into the root account address book.
Stable public id of the saved address-book entry.
1Address-book scope type.
ROOTRoot account that owns this address book.
7563897446546Subaccount for subaccount-scoped books. Empty for root account books.
37HAHbBRCeYType of saved destination.
EXTERNAL_CHAINUser-defined display label.
Treasury WalletOptional user-defined note.
Primary treasury destination.Time this entry was created, as a UTC timestamp.
2025-01-01T00:00:00ZTime this entry was last updated, as a UTC timestamp.
2025-01-01T00:00:00ZExternal network identifier for the destination address.
1Destination address on the selected external network.
0x3333333333333333333333333333333333333333Root account that owns the target internal account.
Target account or subaccount public id.
Whether target_account_id identifies a root account or a subaccount.
Smart account address for the internal transfer destination.
Username for the destination root account, when available.
Label for the destination subaccount, when the destination is a subaccount.
Stable public id of the tag.
1Address-book scope type.
ROOTRoot account that owns this address book.
7563897446546Subaccount for subaccount-scoped books. Empty for root account books.
37bbZLLApNfHuman-readable tag name.
TreasuryOptional UI color token for this tag.
#7C3AEDTime the tag was created, as a UTC timestamp.
2025-01-01T00:00:00ZTime this tag was last updated, as a UTC timestamp.
2025-01-01T00:00:00ZMonotonic resource revision used for conditional updates.
1| Key | Status | Error | When |
|---|---|---|---|
| unauthenticated | 401 | Unauthenticated | Authentication required. |
| permission-denied | 403 | Permission Denied | Permission denied. |
| invalid-argument | 400 | Invalid Argument | Invalid argument. |
| not-found | 404 | Not Found | Not found. |
| unavailable | 503 | Unavailable | Service unavailable. |