Skip to content
nsin docs
EN فا

Enable developer mode

POST
/domains/{domain}/developer-mode
 
curl --request POST \
  --url https://api.nsin.ir/domains/example.com/developer-mode \
  --header 'Authorization: Bearer <token>'

Bypasses all cache reads and writes for this domain at the edge, so you always see the origin’s current response. Auto-expires — the response carries the expiry — so a forgotten toggle can never permanently disable caching. Requires domain.settings.

It also adds a temporary error page rule (managed_by: developer_mode): origin mode for every 5xx on every path, evaluated before the domain’s own error page rules. The origin’s own error responses reach visitors instead of an error page. The rule is removed when developer mode ends, whether it is disabled or expires.

Calling this while developer mode is already on restarts the window from now. If the temporary rule was deleted, it is added back. If it was only switched off, it stays off.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
domain
required
string

The domain name (for example example.com) — not a numeric id.

Example 
example.com

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Developer mode enabled.

Media type application/json
object
active
boolean
expires_at

When developer mode switches itself off. Absent when inactive.

string format: date-time
Example generated
{
  "active": true,
  "expires_at": "2026-04-15T12:00:00Z"
}

401

Section titled “401 ”

Missing, malformed, revoked or expired API key. (A valid key whose account has been deactivated gets 403 account is inactive instead.)

Media type application/json

The single error shape used by every endpoint.

object
error
required

Human-readable description of what went wrong.

string
Examples
Example invalidKey 
{
  "error": "invalid API key"
}

403

Section titled “403 ”

The key is read-only, your role on the domain lacks the required permission, or the domain’s plan does not include the feature.

Media type application/json

The single error shape used by every endpoint.

object
error
required

Human-readable description of what went wrong.

string
Example 
{
  "error": "read-only API key"
}

404

Section titled “404 ”

No such domain, or it is not visible to this account. Domains you cannot access are reported as not found rather than forbidden.

Media type application/json

The single error shape used by every endpoint.

object
error
required

Human-readable description of what went wrong.

string
Example 
{
  "error": "read-only API key"
}

429

Section titled “429 ”

The key exceeded its request budget (300 requests per minute by default).

Media type application/json

The single error shape used by every endpoint.

object
error
required

Human-readable description of what went wrong.

string
Examples
Example limited 
{
  "error": "rate limit exceeded"
}