{"schemaVersion":"1.0","sourceCommit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca","sourceVisibility":"private","article":{"id":"api-mansoq-core-teleicu-resetpasswordrequesttoken-c8d72b26","title":"Reset Password Request Token API reference · mansoq-core-teleicu","summary":"Static source contract for Reset Password Request Token: 1 declared or inherited operation mappings, schema/field evidence and authorization/refusal references. Deployment and behavioral review remain explicit.","module":"IT & integrations","roles":["IT administrator","Developer","Integration engineer"],"facilities":["All configured facility types"],"kind":"reference","minutes":3,"prerequisites":["Use the API contract from the installed deployment and an authorized synthetic test environment.","Confirm facility/organization scope, action permissions and optional app enablement.","This reference is static source evidence; complete payload, authorization, failure and end-to-end review remains recorded as pending."],"steps":[],"sections":[{"title":"Declared route and availability","body":"This resource is declared in **mansoq-core-teleicu** at `/api/v1/password_reset/`. project URL declaration This is an alternative core contract, not proof that the primary core uses the same behavior. A registered path and an indexed handler do not prove deployment availability, user permission or production readiness."},{"title":"Operation map","body":"| Method | Path | Action | Evidence |\n| --- | --- | --- | --- |\n| POST | `/api/v1/password_reset/` | post | explicit Django path/view declaration |"},{"title":"post · POST","body":"**POST /api/v1/password_reset/** — action `post`. static contract extracted; runtime/permission/payload behavior review pending.\n\n**decorator request: ResetPasswordRequestTokenRequest**. Declared fields below; inherited fields are retained in the schema inventory.\n\n| Field | Type | Required | Constraints |\n| --- | --- | --- | --- |\n| username | str | true | No extra constraint extracted |\n\n**decorator responses: ResetPasswordResponse**. Declared fields below; inherited fields are retained in the schema inventory.\n\n| Field | Type | Required | Constraints |\n| --- | --- | --- | --- |\n| detail | str | true | No extra constraint extracted |\n\n**decorator responses 2: ResetPasswordResponse**. Declared fields below; inherited fields are retained in the schema inventory.\n\nThe declared field table is shown at its first occurrence in this reference; this operation links the same schema.\n\n**decorator responses 3: ResetPasswordResponse**. Declared fields below; inherited fields are retained in the schema inventory.\n\nThe declared field table is shown at its first occurrence in this reference; this operation links the same schema.\n\n**decorator responses 4: ResetPasswordResponse**. Declared fields below; inherited fields are retained in the schema inventory.\n\nThe declared field table is shown at its first occurrence in this reference; this operation links the same schema.\n\n**Authorization:** no literal permission name was resolved in the bounded handler/helper traversal. Authentication, inherited policies, object/facility scoping and middleware still require review; this does not mean public access.\n\n**Class policy declarations:** permission_classes: ; authentication_classes: .\n\n**Explicit response statuses in observed code:** status.HTTP_429_TOO_MANY_REQUESTS, status.HTTP_400_BAD_REQUEST. Other branches/framework exception handling may differ.\n\n**Declared refusal/error evidence:** exceptions.ValidationError (dynamic detail; inspect source); ValidationError: Failed to send password reset email. Please try again.."},{"title":"Integration review checklist","body":"Confirm the installed route and full schema; review authentication, organization/facility scoping, all accepted fields, value-state and date/time semantics, idempotency, pagination, response/exception branches and the allowed correction/reversal workflow. Test positive and negative cases with synthetic data. This source reference does not establish external certification or replace an illustrated user procedure."}],"troubleshooting":[{"problem":"A declared route is unavailable or a request is rejected","solution":"Compare the installed revision, actual API schema, optional plugin mount, HTTP-method restrictions and recorded validation/permission evidence. Do not bypass a refusal or send a production transaction to test documentation."}],"sources":[{"path":"repositories/teleicu/mansoq-core-teleicu/config/urls.py","line":45,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py","line":160,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/emr/resources/user/spec.py","line":230,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/emr/resources/user/spec.py","line":226,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}],"related":["it-api-contract","it-api-auth","security-rcm-roles"],"verification":"Static API contract — behavior review pending","version":"f6e9f05f76d4","apiReferenceIds":["backend-path-86027e57c8d72b26","backend-path-86027e57c8d72b26:POST:post"]},"backend":{"resources":[{"id":"backend-path-86027e57c8d72b26","declaredPath":"api/v1/password_reset/","dynamicPath":false,"source":{"path":"repositories/teleicu/mansoq-core-teleicu/config/urls.py","line":45,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"conditions":[],"kind":"view","view":"ResetPasswordRequestToken","classId":"repositories/teleicu/mansoq-core-teleicu:mansoq.users.reset_password_views.ResetPasswordRequestToken","actionMapping":null,"operationIds":["backend-path-86027e57c8d72b26:POST:post"],"path":"/api/v1/password_reset/","mountStatus":"project URL declaration","reviewStatus":"direct route enumerated; behavioral review pending"}],"operations":[{"id":"backend-path-86027e57c8d72b26:POST:post","resourceId":"backend-path-86027e57c8d72b26","repository":"repositories/teleicu/mansoq-core-teleicu","boundary":"alternative-core","method":"POST","path":"/api/v1/password_reset/","declaredPattern":"api/v1/password_reset/","action":"post","viewset":"ResetPasswordRequestToken","classId":"repositories/teleicu/mansoq-core-teleicu:mansoq.users.reset_password_views.ResetPasswordRequestToken","detail":null,"mountStatus":"project URL declaration","routeEvidence":{"path":"repositories/teleicu/mansoq-core-teleicu/config/urls.py","line":45,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"handlerSource":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py","line":160,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"registrationConditions":[],"evidenceKind":"explicit Django path/view declaration","decoratorStatus":null,"decoratorPolicy":{},"methodEvidenceIds":["repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py:160:post"],"schemaIds":{"decorator request":"repositories/teleicu/mansoq-core-teleicu:mansoq.emr.resources.user.spec.ResetPasswordRequestTokenRequest","decorator responses":"repositories/teleicu/mansoq-core-teleicu:mansoq.emr.resources.user.spec.ResetPasswordResponse","decorator responses 2":"repositories/teleicu/mansoq-core-teleicu:mansoq.emr.resources.user.spec.ResetPasswordResponse","decorator responses 3":"repositories/teleicu/mansoq-core-teleicu:mansoq.emr.resources.user.spec.ResetPasswordResponse","decorator responses 4":"repositories/teleicu/mansoq-core-teleicu:mansoq.emr.resources.user.spec.ResetPasswordResponse"},"classPermissionEvidence":[{"kind":"permission_classes","declaration":[],"source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py","line":148,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"kind":"authentication_classes","declaration":[],"source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py","line":147,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"filterEvidence":[],"reviewStatus":"static contract extracted; runtime/permission/payload behavior review pending","pathParameters":[]}],"methodEvidence":[{"id":"repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py:160:post","name":"post","owner":"repositories/teleicu/mansoq-core-teleicu:mansoq.users.reset_password_views.ResetPasswordRequestToken","summary":"","source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py","line":160,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"signatureParameters":[],"parametersRead":[],"permissionChecks":[],"declaredErrors":[{"exception":"exceptions.ValidationError","message":null,"dynamicMessage":true,"source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py","line":193,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"exception":"ValidationError","message":"Failed to send password reset email. Please try again.","dynamicMessage":false,"source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py","line":186,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"explicitResponseStatuses":[{"value":null,"symbol":"status.HTTP_429_TOO_MANY_REQUESTS","source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py","line":172,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"value":null,"symbol":"status.HTTP_400_BAD_REQUEST","source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py","line":167,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"conditions":[],"schemaIds":["repositories/teleicu/mansoq-core-teleicu:mansoq.emr.resources.user.spec.ResetPasswordRequestTokenRequest","repositories/teleicu/mansoq-core-teleicu:mansoq.emr.resources.user.spec.ResetPasswordResponse"],"schemaUsages":[{"purpose":"decorator request","schemaId":"repositories/teleicu/mansoq-core-teleicu:mansoq.emr.resources.user.spec.ResetPasswordRequestTokenRequest","source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py","line":150,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"purpose":"decorator responses","schemaId":"repositories/teleicu/mansoq-core-teleicu:mansoq.emr.resources.user.spec.ResetPasswordResponse","source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py","line":150,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"purpose":"decorator responses","schemaId":"repositories/teleicu/mansoq-core-teleicu:mansoq.emr.resources.user.spec.ResetPasswordResponse","source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py","line":150,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"purpose":"decorator responses","schemaId":"repositories/teleicu/mansoq-core-teleicu:mansoq.emr.resources.user.spec.ResetPasswordResponse","source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py","line":150,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"purpose":"decorator responses","schemaId":"repositories/teleicu/mansoq-core-teleicu:mansoq.emr.resources.user.spec.ResetPasswordResponse","source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/users/reset_password_views.py","line":150,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"unconditionalRaise":false,"reviewStatus":"static declaration extracted; behavioral/security review pending"}],"schemas":[{"id":"repositories/teleicu/mansoq-core-teleicu:mansoq.emr.resources.user.spec.ResetPasswordRequestTokenRequest","name":"ResetPasswordRequestTokenRequest","source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/emr/resources/user/spec.py","line":230,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"kind":"Python declared schema/model evidence","fields":[{"name":"username","type":"str","required":true,"hasDefault":false,"source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/emr/resources/user/spec.py","line":231,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"constraints":{}}],"validation":[],"baseTypes":["BaseModel"],"reviewStatus":"declared fields extracted; runtime validation review pending","referencedSchemaIds":[]},{"id":"repositories/teleicu/mansoq-core-teleicu:mansoq.emr.resources.user.spec.ResetPasswordResponse","name":"ResetPasswordResponse","source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/emr/resources/user/spec.py","line":226,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"kind":"Python declared schema/model evidence","fields":[{"name":"detail","type":"str","required":true,"hasDefault":false,"source":{"path":"repositories/teleicu/mansoq-core-teleicu/mansoq/emr/resources/user/spec.py","line":227,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"constraints":{}}],"validation":[],"baseTypes":["BaseModel"],"reviewStatus":"declared fields extracted; runtime validation review pending","referencedSchemaIds":[]}],"frameworkSettings":[{"name":"DEFAULT_AUTHENTICATION_CLASSES","value":["config.authentication.CustomJWTAuthentication","config.authentication.CustomBasicAuthentication","rest_framework.authentication.SessionAuthentication","rest_framework.authentication.TokenAuthentication"],"source":{"path":"repositories/teleicu/mansoq-core-teleicu/config/settings/base.py","line":366,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"scope":"source default; deployment overrides and action-level policies may differ"},{"name":"DEFAULT_PERMISSION_CLASSES","value":["rest_framework.permissions.IsAuthenticated","mansoq.security.utils.permission_class.MansoqAuthentication"],"source":{"path":"repositories/teleicu/mansoq-core-teleicu/config/settings/base.py","line":366,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"scope":"source default; deployment overrides and action-level policies may differ"},{"name":"DEFAULT_PAGINATION_CLASS","value":"mansoq.utils.pagination.mansoq_pagination.MansoqLimitOffsetPagination","source":{"path":"repositories/teleicu/mansoq-core-teleicu/config/settings/base.py","line":366,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"scope":"source default; deployment overrides and action-level policies may differ"},{"name":"PAGE_SIZE","value":14,"source":{"path":"repositories/teleicu/mansoq-core-teleicu/config/settings/base.py","line":366,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"scope":"source default; deployment overrides and action-level policies may differ"}]},"frontend":{"operations":[],"schemas":[]},"services":{"operations":[]},"boundaries":[]}