Skip to main content

Submit self-service change request

Submits a change request from the beneficiary. Standalone forms (life_event, grievance) are stored for review without entity side-effects. Entity update forms go through the review pipeline when requireReview is enabled; otherwise they are applied directly.

Request​

Method: POST
Path: /api/auth/self-service/submit

Authentication: Required (Bearer JWT)

Request Body​

Content Type: application/json

Schema: See component schemas below

Responses​

200 - Submitted​

400 - Invalid request or token missing entityGuid​

403 - Form type not allowed for this program​

404 - Tenant not found​

Examples​

cURL​

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  http://localhost:3000/api/auth/self-service/submit \
  -d '{"example": "data"}'

JavaScript​

const response = await fetch('http://localhost:3000/api/auth/self-service/submit', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer ' + token,
  },
  body: JSON.stringify({
    // Request data
  }),
});

const data = await response.json();
console.log(data);

This documentation is automatically generated from the OpenAPI specification.