Create a consent record
Records a parental consent status for a student in the append-only audit trail. When guardianId is supplied it must belong to a guardian with an active relationship to the student (otherwise 400); guardianId may be null only for a pending record whose metadata.consentMethod is awaiting_guardian.
Authorizations
OAuth 2.0 client credentials flow. Contact timeback@trilogy.com to request credentials for your application.
Path Parameters
Unique identifier of the student
Body
Status of the consent. Note: the platform does not produce expired automatically; a request that lapses unsigned stays pending. expired is accepted only as a createConsentRecord input. voided is written when a request is superseded (re-request, name correction, sibling grant) or the DocuSign envelope is voided.
pending, granted, denied, expired, voided, withdrawn Timestamp when the consent status change occurred
UUID of the parent/guardian providing consent. Nullable only for pending records where metadata.consentMethod is awaiting_guardian.
Free-form audit context. Common keys the platform reads/writes: consentMethod, docusignEnvelopeId, docusignStatus, emailConsentInitiatedAt, returnUrl, and (on voided records) supersededBy and originalEnvelopeId. Additional keys are allowed.
Response
Consent record created successfully