Child Requests Feature
POST {{url}}/api/consent
Creates additional child feature consent requests for the currently authenticated child User, thus requires an authentication token for access. Use case for this request is when a child wants some additional consent for a feature not previously consented to.
The API requires that the desired featureId(s) are provided in the body of the request. Note: this API does not send out the consent email to the parent for approval. In order for the consent email to be sent to the Granter (i.e. Parent), the Resend Consent Request API must be run.
The request body must contain the desired feature(s) being requested. Features are defined in an array by their ** featureId**.
A correct request will generate a HTTP response code of 200 (Ok) and the consent request will exist for the User. If the Granter then lands on the PRIVO permission page they will be able to grant the additional consent. This can be achieved by either resending the consent email or by the Granter, on their own, managing their account.
User Requests Feature Endpoint:
/api/consent
Sample Feature Consent Request:
POST {{url}}/api/consent
Request Body:
{
"features":[
{"featureId":441}
]
}
Sample JSON Response:
{
"entity":[
{
"status": "PENDING",
"consentRequestType": "FEATURE",
"approvedDate": null,
"deniedDate": null,
"expiredDate": null,
"accountOrigin": "PRIVO",
"childAccountId": null,
"childFirstName": "Frank",
"childBirthDate": null,
"description": "Some Child Feature",
"emailPlusVerified": null,
"feature": {
"added": 1415806315000,
"modified": null,
"id": 441,
"version": 10,
"optInDefault": false,
"allowHolderEmailAsOther": false,
"allowDuplicateRegistrations": false,
"emailPlusDays": 3,
"noResponseDeleteDays": 30,
"bounceEmailResendTimes": 3,
"optInDelayDays": 3,
"optInReminderDays": 3,
"optOutRetainDays": 0,
"emailCampaignId": null,
"identifier": "someFeatureIdentifier",
"campaignFieldMappings": null,
"category": "Optional",
"access": "Gated",
"featurePromotion": "Optional",
"activeByDefault": true,
"selfGrantorTier": "D",
"grantorTier": "D",
"webhooks": [],
"termsOfServiceUrl": "https://partnerSite.com/terms-of-use/",
"privacyPolicyUrl": "https://partnerSite.com/privacy-policy/",
"dataUsagePolicyUrl": "https://partnerSite.com/terms-of-use/",
"title": "Some Child Feature Name",
"summary": "Feature Summary",
"description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus et lorem posuere sem varius egestas a et elit. Quisque eu porta sapien. Nunc aliquet a nisl sed semper. Nulla purus felis, vehicula ac congue in, porttitor id sapien. Suspendisse condimentum facilisis dui non accumsan. In nec feugiat ligula, id suscipit metus. Vivamus sit amet velit ac quam ornare vulputate a a lorem. Nulla molestie eget tortor vel cursus.",
"dataUseDescription": "This is a data description section. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus et lorem posuere sem varius egestas a et elit. Quisque eu porta sapien. Nunc aliquet a nisl sed semper.",
"active": true,
"promoteAtRegistration": false,
"displayOrder": 5,
"price": 0.0,
"freemium": false,
"premium": false,
"premiumOptIn": false,
"consentRequestFreqDays": 1,
"siteId": 9999,
"optional": true,
"featureId": 441,
"standard": false,
"childAudience": false,
"minorAudience": false
},
}
]
}