Consent

Rotate a Consent runtime key

Changed on

Directly verifies tenant and project ownership, then atomically rerolls the key with its existing configuration. overlapSeconds is required, from 0 to 86400. Zero expires the old secret immediately; positive values allow deployment overlap. The replacement secret is returned once. Disabled or expired keys cannot be rotated. Do not retry blindly after an uncertain response. A current Consent runtime is required. Requires consent.keys.write, projects.read and projects.write, with an admin or owner role. Subject to rollout-agent-access-writes and allow-public-agent-writes. Organization API keys cannot call this operation.

post/v1/projects/{projectId}/consent/runtime-keys/{keyId}/rotate

Request

  • Base URL
    https://api.inth.com
  • URL
    https://api.inth.com/v1/projects/{projectId}/consent/runtime-keys/{keyId}/rotate
  • Auth
    HTTP bearer

Path parameters

projectIdstring required

Project ID returned by list_projects. Scoped to the caller's current memberships.

keyIdstring required

Key ID from runtime-key metadata. Do not pass the secret token.

Request body

overlapSecondsinteger required

Response

Success

successunknown required

Changes