Valid view name is missing in transientDocuments views API

[shree_0050]

Hi,
I am calling this API to retrieve the uploaded documents for viewing directly in Adobe, but it returns the following error. I have already added the required scopes. Could someone please help me with this?

{
    "code": "MISSING_REQUIRED_PARAM",
    "message": "Valid view name is missing"
}

Curl:

curl --location 'https://secure.na3.adobesign.com/api/rest/v6/transientDocuments/${transientDocId}/views' \
--header 'accept: application/json' \
--header 'Authorization: Bearer 3AAABLblqZhBDBX3b7dV_X-83VdteEAlNNO31k_44HgHLc67tv3ck' \
--header 'Content-Type: application/json' \
--header 'Cookie: JSESSIONID=813D69CA084F54D276AC29AB2232FF00.webapp-prod-b-2' \
--data '{
    "name":"SIGNING_VIEW"
}'

 Thanks
Shree

[S. S · Accepted solution]

Hi @shree_0050,

Hope you are doing well. Thanks for writing in!

The error message usually means that the “name” parameter in your request body is either missing, misspelled, or not one of the valid values accepted by the API.

You’re hitting the wrong place for what you want. transientDocuments don’t support a “view” you can open. A transient document is only a temporary upload token you use to create something viewable (like an Agreement, Library Document, or Web Form). That’s why the API says “Valid view name is missing” — for this resource, the view you’re asking for (e.g., SIGNING_VIEW) isn’t valid.

Try this:

Create a DRAFT agreement using that transient ID
POST /agreements with:

{
  "fileInfos":[{"transientDocumentId":"<YOUR_TRANSIENT_ID>"}],
  "name":"My Test Agreement",
  "state":"DRAFT"
}

Save the returned agreementId.

Get a view URL for prepare/authoring preview:

POST /agreements/{agreementId}/views
Body: { "name": "AUTHORING" }

For embedded signing (signer point-of-view):

• Easiest: GET /agreements/{agreementId}/signingUrls (returns a signing link)

• Or: POST /agreements/{agreementId}/views with a supported signing view (only available when the agreement is in the right state).

Note: There is no viewer for a bare transient document. If you only need read-only display, you can GET /agreements/{agreementId}/documents/{documentId} to download the PDF and show it with the PDF Embed API in your app.

More information here: https://adobe.ly/3Lur8Yl

Let us know if this works.

Regards,
Souvik.

[shree_0050]

Thanks @S. S for you quick help on this .