Skip to contentDevelopersPrezly website
Domains

Share Domain Records Instructions

Generate a temporary link to DNS setup instructions.

Personal token scopes: sites:read. Your account must also have access to the requested data. Authentication

The 201 response contains sharable_dns_instructions with url and expires_at. The URL carries temporary delegated access; share it only with the intended DNS administrator.

Read the guide

POST
/newsrooms/{newsroom_id}/domains/{domain}/share

Returns a temporary instructions URL and expires_at. The URL embeds a token restricted to the domain instruction lookup/connect paths. Treat it as temporary access and use the returned expiry; this does not change DNS records.

Personal access tokens: sites:read. Every listed scope is required; the token owner's permissions, feature availability and newsroom access still apply.

Authorization

API_key
headerAuthorizationBearer <token>

Bearer authentication using an integration API key, or a personal access token only where the operation explicitly supports it. Every listed personal-token scope is required; owner permissions and newsroom access still apply.

Path Parameters

newsroom_id*string

Newsroom UUID or ID

Length1 <= length
domain*string

Domain name

Response Body

Created

application/json
  1. response
sharable_dns_instructions*
Example Request
curl -X POST 'https://api.prezly.com/v2/newsrooms/string/domains/string/share'
Example Response201
{  "sharable_dns_instructions": {    "url": "string",    "expires_at": "string"  }}