PilotFoxDocs

Create or replace the proxy secret

POST
/api/v1/sites/{siteId}/proxy-secret

A new first-party proxy secret, replacing the previous one at once. This answer is the only one that carries it. The proxy sends it in X-PilotFox-Proxy-Secret, with the visitor's address in X-PilotFox-IP. Send {} as the body: a request without one is 400.

Requires site:update on the site (an API key, or a signed-in member's role). Share links: 401.

Authorization

headerx-api-key<token>

An organization API key (ak_…), with the permissions and the sites it was created with. For servers and scripts: no cookie and no Origin check. Also accepted as Authorization: Bearer ak_… (apiKeyBearer). A request carries one credential: a key sent with a share token or a live session cookie is 400 (details.reason: ambiguous_credentials).

Scope: site:update

Path Parameters

siteId*string

Request Body

application/json
  1. body

Response Body

Created

application/json
  1. response
data*
Example Request
curl -X POST 'https://pilotfox.app/api/v1/sites/string/proxy-secret' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response201
{  "data": {    "secret": "string",    "hint": "string",    "createdAt": "2019-08-24T14:15:22Z"  }}