Create a managed PDF preview link

POST

/v1/pdfs/{pdfId}/preview

curl --request POST \
  --url https://api.presscloud.example/v1/pdfs/example/preview \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "expiresInSeconds": 1 }'

Returns a short-lived signed preview URL for a managed PDF asset.

Authorizations

• bearerAuth

Parameters

Path Parameters

pdfId

required

string

>= 1 characters

Request Body

Media type application/json

object

expiresInSeconds

Optional signed URL lifetime in seconds. When omitted, the default lifetime is 10 minutes.

integer

>= 1

Example ^generated

{
  "expiresInSeconds": 1
}

Responses

200

Managed PDF preview link.

Media type application/json

object

access

required

object

url

required

string format: uri

>= 1 characters

expiresAt

required

Unix epoch time in milliseconds. The signed URL expires 10 minutes after the webhook delivery attempt is generated.

integer

Example ^generated

{
  "access": {
    "url": "https://example.com",
    "expiresAt": 1
  }
}

400

Invalid request payload or parameters.

Media type application/json

object

error

required

string

message

required

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

404

Requested resource was not found.

Media type application/json

object

error

required

string

message

required

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

503

Service or provider configuration is not ready for the requested operation.

Media type application/json

object

error

required

string

message

required

string

Example ^generated

{
  "error": "example",
  "message": "example"
}