{"schemaVersion":"1.0","sourceCommit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca","sourceVisibility":"private","article":{"id":"api-mansoq-super-batch-be-superbatchrequestview-7467cb99","title":"Super Batch Request View API reference · mansoq-super-batch-be","summary":"Static source contract for Super Batch Request View: 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-super-batch-be** at `/api/{installed_plugin_prefix}//`. plugin/local mount; actual prefix and enablement require deployment verification 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/{installed_plugin_prefix}/` | create | declared/inherited method |"},{"title":"create · POST","body":"**POST /api/{installed_plugin_prefix}/** — action `create`. static contract extracted; runtime/permission/payload behavior review pending.\n\nPath and deployment-context parameters:\n\n| Location | Parameter | Type | Required |\n| --- | --- | --- | --- |\n| deployment mount | installed_plugin_prefix | deployment-selected mount prefix | true |\n\n**decorator request: BatchRequest**. Declared fields below; inherited fields are retained in the schema inventory.\n\n| Field | Type | Required | Constraints |\n| --- | --- | --- | --- |\n| requests | list[Request] | true | min_length: 1 |\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**Explicit response statuses in observed code:** 400, 500. Other branches/framework exception handling may differ.\n\n**Declared refusal/error evidence:** ValidationError (dynamic detail; inspect source); ValidationError: Source request must come before the current request.."},{"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-super-batch-be/super_batch_request/urls.py","line":6,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":56,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":87,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":60,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":40,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}],"related":["it-api-contract","it-api-auth","security-rcm-roles"],"verification":"Static API contract — behavior review pending","version":"f6e9f05f76d4","apiReferenceIds":["backend-resource-0cc15aab7467cb99","backend-resource-0cc15aab7467cb99:POST:create"]},"backend":{"resources":[{"id":"backend-resource-0cc15aab7467cb99","localPrefix":"","viewset":"SuperBatchRequestView","classId":"repositories/platform/mansoq-super-batch-be:super_batch_request.api.viewsets.batch_request.SuperBatchRequestView","basename":"super_batch_request","source":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/urls.py","line":6,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"conditions":[],"repository":"repositories/platform/mansoq-super-batch-be","classSource":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":56,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"description":"","path":"/api/{installed_plugin_prefix}//","mountStatus":"plugin/local mount; actual prefix and enablement require deployment verification","operationIds":["backend-resource-0cc15aab7467cb99:POST:create"],"unresolvedViewset":false,"reviewStatus":"registered resource enumerated; behavioral review pending"}],"operations":[{"id":"backend-resource-0cc15aab7467cb99:POST:create","resourceId":"backend-resource-0cc15aab7467cb99","repository":"repositories/platform/mansoq-super-batch-be","boundary":"optional-plugin/local-service","method":"POST","path":"/api/{installed_plugin_prefix}/","declaredPattern":"/api/{installed_plugin_prefix}/","action":"create","viewset":"SuperBatchRequestView","classId":"repositories/platform/mansoq-super-batch-be:super_batch_request.api.viewsets.batch_request.SuperBatchRequestView","detail":false,"allowedByDeclaredHttpMethods":true,"mountStatus":"plugin/local mount; actual prefix and enablement require deployment verification","routeEvidence":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/urls.py","line":6,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"handlerSource":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":87,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"registrationConditions":[],"evidenceKind":"declared/inherited method","methodEvidenceIds":["repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py:87:create","repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py:60:validate_replacements"],"schemaIds":{"decorator request":"repositories/platform/mansoq-super-batch-be:super_batch_request.api.viewsets.batch_request.BatchRequest"},"classPermissionEvidence":[],"filterEvidence":[],"reviewStatus":"static contract extracted; runtime/permission/payload behavior review pending","pathParameters":[{"name":"installed_plugin_prefix","in":"deployment mount","type":"deployment-selected mount prefix","required":true,"source":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/urls.py","line":6,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}]}],"methodEvidence":[{"id":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py:87:create","name":"create","owner":"repositories/platform/mansoq-super-batch-be:super_batch_request.api.viewsets.batch_request.SuperBatchRequestView","summary":"","source":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":87,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"signatureParameters":[],"parametersRead":[],"permissionChecks":[],"declaredErrors":[],"explicitResponseStatuses":[{"value":400,"symbol":null,"source":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":117,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"value":500,"symbol":null,"source":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":119,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"conditions":[],"schemaIds":["repositories/platform/mansoq-super-batch-be:super_batch_request.api.viewsets.batch_request.BatchRequest"],"schemaUsages":[{"purpose":"decorator request","schemaId":"repositories/platform/mansoq-super-batch-be:super_batch_request.api.viewsets.batch_request.BatchRequest","source":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":86,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"unconditionalRaise":false,"reviewStatus":"static declaration extracted; behavioral/security review pending"},{"id":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py:60:validate_replacements","name":"validate_replacements","owner":"repositories/platform/mansoq-super-batch-be:super_batch_request.api.viewsets.batch_request.SuperBatchRequestView","summary":"","source":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":60,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"signatureParameters":[{"name":"requests","type":"unspecified","required":true,"source":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":60,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"parametersRead":[],"permissionChecks":[],"declaredErrors":[{"exception":"ValidationError","message":null,"dynamicMessage":true,"source":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":73,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"exception":"ValidationError","message":"Source request must come before the current request.","dynamicMessage":false,"source":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":75,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}},{"exception":"ValidationError","message":null,"dynamicMessage":true,"source":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":84,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"}}],"explicitResponseStatuses":[],"conditions":[],"schemaIds":[],"schemaUsages":[],"unconditionalRaise":false,"reviewStatus":"static declaration extracted; behavioral/security review pending"}],"schemas":[{"id":"repositories/platform/mansoq-super-batch-be:super_batch_request.api.viewsets.batch_request.BatchRequest","name":"BatchRequest","source":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":40,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"kind":"Python declared schema/model evidence","fields":[{"name":"requests","type":"list[Request]","required":true,"hasDefault":true,"source":{"path":"repositories/platform/mansoq-super-batch-be/super_batch_request/api/viewsets/batch_request.py","line":41,"commit":"f6e9f05f76d443b26ebd2369f67d3c3bd52257ca"},"constraints":{"min_length":1}}],"validation":[],"baseTypes":["BaseModel"],"reviewStatus":"declared fields extracted; runtime validation review pending","referencedSchemaIds":["repositories/platform/mansoq-super-batch-be:super_batch_request.api.viewsets.batch_request.Request"]}],"frameworkSettings":[]},"frontend":{"operations":[],"schemas":[]},"services":{"operations":[]},"boundaries":[]}