Entity Secret Reset

Environment

Environment	IAM Base URL
Saafe Hackathon	https://api.sandbox.sahamati.org.in/iam
Saafe Sandbox	https://api.uat.sahamati.org.in/iam

API Request

POST {{IAM Base URL}}/v1/entity/secret/reset

Lets the FIU reset the entity id's secret on a specific interval.

Note:

1. If you fail to reset the secret before the expiry token generation will fail

2. Old Secret will not working immediately after the new secret is generated

3. Token generated using the old token will be still active as long as the token is not expired.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <IAM User Token>

Body

{
    "ver": "1.0.0",
    "timestamp": "2024-10-10T10:48:45.030353256Z", //Current timestamp
    "txnId": "79ecd03d-867a-491d-8f5d-ec521a31c159", //unique UUID
    "entityId": "your entity id" //Entity ID under the user
}

Response

200

{
    "ver": "1.0.0",
    "timestamp": "2024-10-10T10:48:45.030353256Z",
    "txnId": "79ecd03d-867a-491d-8f5d-ec521a31c159",
    "entityId": "your entity id",
    "secret": "string", //Your Entity ID's secret key
    "expiresOn": 1733226041466
}