Share Links

Share Links provide a way to share any deployment with external stakeholders (clients, designers, PMs) without giving them access to the deploybase dashboard.

How Share Links Work

1. Create a Share Link for a specific deployment
2. System generates a unique token
3. Link URL: https://share.deploybase.eu/{token}
4. All requests are proxied through the backend (CDN URLs are never exposed)
5. If password-protected, viewers see a password form first

Creating a Share Link

curl -X POST https://api.deploybase.eu/api/v1/draft-shares \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "deployment_id": "DEPLOYMENT_ID",
    "password": "optional-password",
    "expires_in": "7d"
  }'

Field	Required	Description
deployment_id	Yes	The deployment to share
password	No	Minimum 8 characters. Viewers must enter it to access the site.
expires_in	No	24h, 7d, or 30d. No expiry if omitted.

The response includes the full share_url.

Share Links vs Previews

Aspect	Share Link	Preview
Creation	Manual	Automatic (on non-default branch deploy)
URL	share.deploybase.eu/{token}	{branch}-{slug}.previews.deploybase.eu
Password	Optional	Not available
Delivery	Backend proxy	CDN-direct
Target	Any deployment	Latest deployment on a branch
Audience	External stakeholders	Development team

Revoking a Share Link

curl -X DELETE https://api.deploybase.eu/api/v1/draft-shares/SHARE_ID \
  -H "Authorization: Bearer $TOKEN"

Revocation is instant — viewers lose access immediately.

Use Cases

• Client review: Share a staging deployment with a client for feedback before promoting to production
• Design review: Share a feature branch deployment with designers
• Stakeholder demos: Password-protect a deployment for a presentation
• Time-limited access: Set an expiry so links automatically become inactive