Authentication

Encryption

Rotate the calling application's EC keypair

Changed on Apr 17, 2026

Generates a fresh EC P-256 keypair for the authenticated application and returns the new public key (JWK) and private key material (appPrivateJwk).

The private JWK is returned only once - store it securely. After rotation:

IDaaS will encrypt all outbound webhooks with the new public key.
Requests encrypted with the old public key will be rejected (Content-Encryption: JWE decryption will fail).
Allow a brief migration window for in-flight messages before destroying the old private key.

The keyVersion field is incremented on each rotation.

post/v1/applications/keys/rotate

Request

Base URL
https://idaas.yourflexpay.com/api
Auth
HTTP bearer
TypeScript
https://skmtc.dev/reflexpay/apis/idaas-identity-as-a-service-api/docs/v1/applications/keys/rotate/post.ts
A function with typed inputs. Its response is checked against the schema.

Response

Keypair rotated - new key material returned

successboolean

messagestring

errorCodestring

errorsstring[]

timestampstring date-time

Example response

{
  "data": {
    "appHandle": "walletapp",
    "keyVersion": 1
  }
}

Changes

Apr 17, 2026db1f954badfb Revision changes
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- warning
  removed the optional property / from the response with the status
- info
  api tag Authentication added
- info
  api tag Applications removed
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history