Set page expiry

PUT

/pages/{slug}/expiry

Set the page's hard expiry: a future ISO 8601 timestamp, or null to never
expire. Choosing a custom expiry requires a plan with flexible retention (Pro
and above by default); the value is clamped to a 10-year ceiling.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Expiry updated.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠429TooManyRequests

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://upload.tf/api/v1/pages/mysite/expiry' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "expiresAt": "2019-08-24T14:15:22.123Z"
}'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "expiresAt": "2019-08-24T14:15:22.123Z"
    }
}

Modified at 2026-08-08 15:20:28

Get page expiry

Get email-gate config