{"schemaVersion":"1.0","sourceCommit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca","sourceVisibility":"private","article":{"id":"api-mansoq-core-otpresetpasswordview-77b86813","title":"OTPReset Password View API reference · mansoq-core","summary":"Static source contract for OTPReset Password View: 2 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** at `/api/v1/otp/password_reset/`. verified core mount in config/urls.py 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/otp/password_reset/send/` | send | @action declaration |\n| POST | `/api/v1/otp/password_reset/confirm/` | confirm | @action declaration |"},{"title":"send · POST","body":"**POST /api/v1/otp/password_reset/send/** — action `send`. static contract extracted; runtime/permission/payload behavior review pending.\n\n**decorator request: OTPResetSendSpec**. Declared fields below; inherited fields are retained in the schema inventory.\n\n| Field | Type | Required | Constraints |\n| --- | --- | --- | --- |\n| phone_number | str | true | No extra constraint extracted |\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: ."},{"title":"confirm · POST","body":"**POST /api/v1/otp/password_reset/confirm/** — action `confirm`. static contract extracted; runtime/permission/payload behavior review pending.\n\n**decorator request: OTPResetConfirmSpec**. Declared fields below; inherited fields are retained in the schema inventory.\n\n| Field | Type | Required | Constraints |\n| --- | --- | --- | --- |\n| phone_number | str | true | No extra constraint extracted |\n| otp | str | true | No extra constraint extracted |\n| password | str | true | min_length: 8 |\n| username | str \\| None | false | No extra constraint extracted |\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:** 409. Other branches/framework exception handling may differ.\n\n**Declared refusal/error evidence:** ValidationError (dynamic detail; inspect source); Throttled (dynamic detail; inspect source).\n\n**Conditional gates:** conditional/computed expression; inspect pinned declaration comparison settings.OTP_MAX_FAILURES; otp_obj.failed_attempts comparison settings.OTP_MAX_VERIFY_ATTEMPTS."},{"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/platform/mansoq-core/config/api_router.py","line":208,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":51,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":57,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-core/mansoq/emr/api/viewsets/base.py","line":322,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":27,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":68,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":45,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}],"related":["it-api-contract","it-api-auth","security-rcm-roles"],"verification":"Static API contract — behavior review pending","version":"f6e9f05f76d4","apiReferenceIds":["backend-resource-0c2a3fc177b86813","backend-resource-0c2a3fc177b86813:POST:send","backend-resource-0c2a3fc177b86813:POST:confirm"]},"backend":{"resources":[{"id":"backend-resource-0c2a3fc177b86813","localPrefix":"otp/password_reset","viewset":"OTPResetPasswordView","classId":"repositories/platform/mansoq-core:mansoq.users.api.otp_viewset.reset_password.OTPResetPasswordView","basename":"otp-password-reset","source":{"path":"repositories/platform/mansoq-core/config/api_router.py","line":208,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"conditions":[],"repository":"repositories/platform/mansoq-core","classSource":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":51,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"description":"","path":"/api/v1/otp/password_reset/","mountStatus":"verified core mount in config/urls.py","operationIds":["backend-resource-0c2a3fc177b86813:POST:send","backend-resource-0c2a3fc177b86813:POST:confirm"],"unresolvedViewset":false,"reviewStatus":"registered resource enumerated; behavioral review pending"}],"operations":[{"id":"backend-resource-0c2a3fc177b86813:POST:send","resourceId":"backend-resource-0c2a3fc177b86813","repository":"repositories/platform/mansoq-core","boundary":"primary-core","method":"POST","path":"/api/v1/otp/password_reset/send/","declaredPattern":"/api/v1/otp/password_reset/send/","action":"send","viewset":"OTPResetPasswordView","classId":"repositories/platform/mansoq-core:mansoq.users.api.otp_viewset.reset_password.OTPResetPasswordView","detail":false,"allowedByDeclaredHttpMethods":true,"mountStatus":"verified core mount in config/urls.py","routeEvidence":{"path":"repositories/platform/mansoq-core/config/api_router.py","line":208,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"handlerSource":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":57,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"registrationConditions":[],"evidenceKind":"@action declaration","methodEvidenceIds":["repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py:57:send","repositories/platform/mansoq-core/mansoq/emr/api/viewsets/base.py:322:get_queryset"],"schemaIds":{"decorator request":"repositories/platform/mansoq-core:mansoq.users.api.otp_viewset.reset_password.OTPResetSendSpec"},"classPermissionEvidence":[{"kind":"permission_classes","declaration":[],"source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":53,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"kind":"authentication_classes","declaration":[],"source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":52,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"filterEvidence":[],"reviewStatus":"static contract extracted; runtime/permission/payload behavior review pending","pathParameters":[]},{"id":"backend-resource-0c2a3fc177b86813:POST:confirm","resourceId":"backend-resource-0c2a3fc177b86813","repository":"repositories/platform/mansoq-core","boundary":"primary-core","method":"POST","path":"/api/v1/otp/password_reset/confirm/","declaredPattern":"/api/v1/otp/password_reset/confirm/","action":"confirm","viewset":"OTPResetPasswordView","classId":"repositories/platform/mansoq-core:mansoq.users.api.otp_viewset.reset_password.OTPResetPasswordView","detail":false,"allowedByDeclaredHttpMethods":true,"mountStatus":"verified core mount in config/urls.py","routeEvidence":{"path":"repositories/platform/mansoq-core/config/api_router.py","line":208,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"handlerSource":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":68,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"registrationConditions":[],"evidenceKind":"@action declaration","methodEvidenceIds":["repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py:68:confirm","repositories/platform/mansoq-core/mansoq/emr/api/viewsets/base.py:322:get_queryset"],"schemaIds":{"decorator request":"repositories/platform/mansoq-core:mansoq.users.api.otp_viewset.reset_password.OTPResetConfirmSpec"},"classPermissionEvidence":[{"kind":"permission_classes","declaration":[],"source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":53,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"kind":"authentication_classes","declaration":[],"source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":52,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"filterEvidence":[],"reviewStatus":"static contract extracted; runtime/permission/payload behavior review pending","pathParameters":[]}],"methodEvidence":[{"id":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py:57:send","name":"send","owner":"repositories/platform/mansoq-core:mansoq.users.api.otp_viewset.reset_password.OTPResetPasswordView","summary":"","source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":57,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"signatureParameters":[],"parametersRead":[],"permissionChecks":[],"declaredErrors":[],"explicitResponseStatuses":[],"conditions":[],"schemaIds":["repositories/platform/mansoq-core:mansoq.users.api.otp_viewset.reset_password.OTPResetSendSpec"],"schemaUsages":[{"purpose":"decorator request","schemaId":"repositories/platform/mansoq-core:mansoq.users.api.otp_viewset.reset_password.OTPResetSendSpec","source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":56,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"unconditionalRaise":false,"reviewStatus":"static declaration extracted; behavioral/security review pending"},{"id":"repositories/platform/mansoq-core/mansoq/emr/api/viewsets/base.py:322:get_queryset","name":"get_queryset","owner":"repositories/platform/mansoq-core:mansoq.emr.api.viewsets.base.EMRBaseViewSet","summary":"","source":{"path":"repositories/platform/mansoq-core/mansoq/emr/api/viewsets/base.py","line":322,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"signatureParameters":[],"parametersRead":[],"permissionChecks":[],"declaredErrors":[],"explicitResponseStatuses":[],"conditions":[],"schemaIds":[],"schemaUsages":[],"unconditionalRaise":false,"reviewStatus":"static declaration extracted; behavioral/security review pending"},{"id":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py:68:confirm","name":"confirm","owner":"repositories/platform/mansoq-core:mansoq.users.api.otp_viewset.reset_password.OTPResetPasswordView","summary":"","source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":68,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"signatureParameters":[],"parametersRead":[],"permissionChecks":[],"declaredErrors":[{"exception":"ValidationError","message":null,"dynamicMessage":true,"source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":105,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"exception":"ValidationError","message":null,"dynamicMessage":true,"source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":122,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"exception":"Throttled","message":null,"dynamicMessage":false,"source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":74,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"exception":"ValidationError","message":null,"dynamicMessage":true,"source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":100,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"exception":"ValidationError","message":null,"dynamicMessage":true,"source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":97,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"exception":"ValidationError","message":null,"dynamicMessage":true,"source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":110,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"explicitResponseStatuses":[{"value":409,"symbol":null,"source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":116,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"conditions":[{"condition":"conditional/computed expression; inspect pinned declaration comparison settings.OTP_MAX_FAILURES","source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":73,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"condition":"otp_obj.failed_attempts comparison settings.OTP_MAX_VERIFY_ATTEMPTS","source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":90,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"schemaIds":["repositories/platform/mansoq-core:mansoq.users.api.otp_viewset.reset_password.OTPResetConfirmSpec"],"schemaUsages":[{"purpose":"decorator request","schemaId":"repositories/platform/mansoq-core:mansoq.users.api.otp_viewset.reset_password.OTPResetConfirmSpec","source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":67,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"unconditionalRaise":false,"reviewStatus":"static declaration extracted; behavioral/security review pending"}],"schemas":[{"id":"repositories/platform/mansoq-core:mansoq.users.api.otp_viewset.reset_password.OTPResetSendSpec","name":"OTPResetSendSpec","source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":27,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"kind":"Python declared schema/model evidence","fields":[{"name":"phone_number","type":"str","required":true,"hasDefault":false,"source":{"path":"repositories/platform/mansoq-core/mansoq/emr/api/otp_viewsets/login.py","line":58,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"constraints":{}}],"validation":[{"methodId":"repositories/platform/mansoq-core/mansoq/emr/api/otp_viewsets/login.py:62:validate_phone_number","source":{"path":"repositories/platform/mansoq-core/mansoq/emr/api/otp_viewsets/login.py","line":62,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"baseTypes":["OTPRequestBaseSpec"],"reviewStatus":"declared fields extracted; runtime validation review pending","referencedSchemaIds":[]},{"id":"repositories/platform/mansoq-core:mansoq.users.api.otp_viewset.reset_password.OTPResetConfirmSpec","name":"OTPResetConfirmSpec","source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":45,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"kind":"Python declared schema/model evidence","fields":[{"name":"phone_number","type":"str","required":true,"hasDefault":false,"source":{"path":"repositories/platform/mansoq-core/mansoq/emr/api/otp_viewsets/login.py","line":58,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"constraints":{}},{"name":"otp","type":"str","required":true,"hasDefault":true,"source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":46,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"constraints":{}},{"name":"password","type":"str","required":true,"hasDefault":true,"source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":47,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"constraints":{"min_length":8}},{"name":"username","type":"str | None","required":false,"hasDefault":true,"source":{"path":"repositories/platform/mansoq-core/mansoq/users/api/otp_viewset/reset_password.py","line":48,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"constraints":{}}],"validation":[{"methodId":"repositories/platform/mansoq-core/mansoq/emr/api/otp_viewsets/login.py:62:validate_phone_number","source":{"path":"repositories/platform/mansoq-core/mansoq/emr/api/otp_viewsets/login.py","line":62,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"baseTypes":["OTPRequestBaseSpec"],"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/platform/mansoq-core/config/settings/base.py","line":372,"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/platform/mansoq-core/config/settings/base.py","line":372,"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/platform/mansoq-core/config/settings/base.py","line":372,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"scope":"source default; deployment overrides and action-level policies may differ"},{"name":"PAGE_SIZE","value":14,"source":{"path":"repositories/platform/mansoq-core/config/settings/base.py","line":372,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"scope":"source default; deployment overrides and action-level policies may differ"}]},"frontend":{"operations":[],"schemas":[]},"services":{"operations":[]},"boundaries":[]}