auth.v1.AddressBookService
UpdateAddressBookEntry
Request
curl --request POST \ \
--url 'https://api.testnet.polyester.com/auth.v1.AddressBookService/UpdateAddressBookEntry' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{
"addressBookEntryId": "1",
"entry": {
"label": "Name Of My Subaccount",
"newTags": [
{
"color": "#7C3AED",
"name": "Treasury"
}
],
"note": "Primary treasury destination.",
"tagIds": [
"1"
]
},
"expectedRevision": "1",
"updateMask": {
"paths": [
"value"
]
}
}'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": "SCOPE_ROOT",
"subaccountId": "6789012345678"
},
"tags": [
{
"color": "#7C3AED",
"createdAt": "2025-01-01T00:00:00Z",
"name": "Treasury",
"scope": {
"rootAccountId": "7563897446546",
"scopeType": "SCOPE_ROOT",
"subaccountId": "6789012345678"
},
"tagId": "1",
"updatedAt": "2025-01-01T00:00:00Z"
}
],
"updatedAt": "2025-01-01T00:00:00Z"
}
}auth.v1.UpdateAddressBookEntryRequestauth.v1.UpdateAddressBookEntryResponseAddress-book entry id to update.
Display label. Empty clears the label when selected.
User-defined note. Empty clears the note when selected.
Complete replacement set of tag ids when selected.
New tags to create and attach in the same protected update. When tag_ids is also selected, the resulting set is tag_ids plus these tags. Otherwise, currently attached tags are preserved and these tags are appended.
The set of field mask paths.
Revision returned by the latest successful read.
Stable public id of the saved address-book entry.
Address-book scope type.
Root account that owns this address book.
Subaccount for subaccount-scoped books. Empty for root account books.
Type of saved destination.
User-defined display label.
Optional user-defined note.
Time this entry was created, as a UTC timestamp.
Time this entry was last updated, as a UTC timestamp.
External network identifier for the destination address.
Destination address on the selected external network: 1-256 characters, without whitespace or angle brackets.
Root 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.
Address-book scope type.
Root account that owns this address book.
Subaccount for subaccount-scoped books. Empty for root account books.
Human-readable tag name.
Optional UI color token for this tag.
Time the tag was created, as a UTC timestamp.
Time this tag was last updated, as a UTC timestamp.
Monotonic resource revision used for conditional updates.
| Key | HTTP status | Connect code | Error | When |
|---|---|---|---|---|
| unauthenticated | 401 | unauthenticated | Unauthenticated | Authentication required. |
| permission-denied | 403 | permission_denied | Permission Denied | Permission denied. |
| invalid-argument | 400 | invalid_argument | Invalid Argument | Invalid argument. |
| not-found | 404 | not_found | Not Found | Not found. |
| unavailable | 503 | unavailable | Unavailable | Service unavailable. |