API referencePlatformProject.settings
Update project node-key policy
The project Owner (or a global SuperAdmin via the D-006 bypass) can configure node-key rotation lifetime and grace settings for their project.
Authorization
bearer_auth AuthorizationBearer <token>
In: header
Header Parameters
X-Project-Id*string
UUID of the project that scopes consumer accounts, devices, sessions, and VSpaces for the request.
Format
uuidRequest Body
application/json
Project-level node-key policy settings.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X PUT "https://example.com/platform/v1/project/settings/node-key-policy" \ -H "X-Project-Id: 11111111-1111-1111-1111-111111111111" \ -H "Content-Type: application/json" \ -d '{ "force_rotation_on_relogin": true, "grace_period_minutes": 5, "key_lifetime_days": 90 }'{ "created_at": "2026-04-22T12:00:00Z", "force_rotation_on_relogin": true, "grace_period_minutes": 5, "key_lifetime_days": 90, "project_id": "11111111-1111-1111-1111-111111111111", "updated_at": "2026-04-22T12:00:00Z"}{ "detail": "Pool slug must be unique.", "instance": "urn:forestvpn:trace:a1b2c3d4", "title": "Validation Error", "type": "https://fvpn.net/errors/validation"}{ "detail": "Pool slug must be unique.", "instance": "urn:forestvpn:trace:a1b2c3d4", "title": "Validation Error", "type": "https://fvpn.net/errors/validation"}{ "detail": "Pool slug must be unique.", "instance": "urn:forestvpn:trace:a1b2c3d4", "title": "Validation Error", "type": "https://fvpn.net/errors/validation"}