From ce25fdcb912c18832502d6d7349f1ba86a493c1c Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Thu, 28 May 2026 08:11:10 +0000
Subject: [PATCH] docs: remove 501 limitation for visibility:public on
 /v1/data/prepare

The daemon now supports visibility:"public" on POST /v1/data/prepare.
The 501 guard (blocked on ant-client #73) was removed at ant-sdk
7853b76; data_prepare_upload_with_visibility is now called for all
visibility values on that endpoint.

Update the REST API reference and the external-signer how-to guide
to reflect the current behavior: "public" bundles the serialized
DataMap into the same payment batch and publishes it on finalize,
with data_map_address returned in the finalize response.

Verified against ant-sdk@7853b76d99ef9e308140b763f23d043559b204c4
---
 .../use-external-signers-for-upload-payments.md            | 6 +++---
 docs/sdk/reference/rest-api.md                             | 7 +++----
 2 files changed, 6 insertions(+), 7 deletions(-)

diff --git a/docs/sdk/how-to-guides/use-external-signers-for-upload-payments.md b/docs/sdk/how-to-guides/use-external-signers-for-upload-payments.md
index b7ffabd..a341206 100644
--- a/docs/sdk/how-to-guides/use-external-signers-for-upload-payments.md
+++ b/docs/sdk/how-to-guides/use-external-signers-for-upload-payments.md
@@ -3,8 +3,8 @@
 <!-- verification:
   source_repo: ant-sdk
   source_ref: main
-  source_commit: 7a113b390522d76d28b8f3e5b4078f9c9418d46f
-  verified_date: 2026-05-26
+  source_commit: 7853b76d99ef9e308140b763f23d043559b204c4
+  verified_date: 2026-05-28
   verification_mode: current-merged-truth
 -->
 <!-- verification:
@@ -107,7 +107,7 @@ curl -X POST http://localhost:8082/v1/data/prepare \
   -d "{\"data\":\"$DATA_B64\"}"
 ```
 
-The in-memory data prepare endpoint supports only private uploads: `visibility` is accepted but `"public"` returns `501`. To prepare a public upload with an external signer, use `POST /v1/upload/prepare` with a file path and `"visibility":"public"` instead.
+The in-memory data prepare endpoint accepts `"private"` (default) or `"public"` for `visibility`. When `"public"`, the serialized DataMap is bundled into the same external-signer payment batch and published on-network on finalize; the finalize response then includes a `data_map_address` field with its network address.
 
 The prepare endpoints return a `payment_type` discriminator. Use that value to decide which on-chain call to make and which finalize payload to send back.
 
diff --git a/docs/sdk/reference/rest-api.md b/docs/sdk/reference/rest-api.md
index ad2d59c..b525e56 100644
--- a/docs/sdk/reference/rest-api.md
+++ b/docs/sdk/reference/rest-api.md
@@ -3,8 +3,8 @@
 <!-- verification:
   source_repo: ant-sdk
   source_ref: main
-  source_commit: 7a113b390522d76d28b8f3e5b4078f9c9418d46f
-  verified_date: 2026-05-26
+  source_commit: 7853b76d99ef9e308140b763f23d043559b204c4
+  verified_date: 2026-05-28
   verification_mode: current-merged-truth
 -->
 
@@ -591,7 +591,7 @@ Prepares an in-memory data upload for external signing.
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
 | `data` | string | Yes | Base64-encoded payload |
-| `visibility` | string | No | `"private"` (default) or `"public"`. `"public"` returns `501` on this endpoint. Use `/v1/upload/prepare` with a file path for public external-signer uploads. |
+| `visibility` | string | No | `"private"` (default) or `"public"`. When `"public"`, the serialized DataMap is bundled into the same external-signer payment batch and published on-network on finalize; `data_map_address` is then present in the finalize response. |
 
 **Response:**
 
@@ -731,7 +731,6 @@ curl -X POST http://localhost:8082/v1/upload/finalize \
 | `404` | Not found | Check the address or `upload_id` |
 | `413` | Payload too large | Split the upload or switch to file endpoints |
 | `500` | Internal server error | Check daemon logs and retry |
-| `501` | Not implemented | `visibility:"public"` is not supported on `/v1/data/prepare`; use `/v1/upload/prepare` with a file path instead |
 | `502` | Network unreachable | Confirm the daemon can reach the Autonomi network |
 | `503` | Service unavailable | Configure a wallet before calling wallet or write endpoints |