Update a member's profile progress
PUT /api/members/{memberId}/profile-progress
- Products: Operator (
FOH), Consumer (CONSUMER) (any one of these products, not all) - Features: Online Bookings (
ONLINEBOOK), Online Joining (ONLINEJOIN), Front of House Generic Access (FOHGENERIC) (any one of these features, not all)
Overview
Records how complete a member considers their profile to be, as a single percentage. It is a display value that your application owns: the platform stores the number you send and never calculates or adjusts it, so nothing else in Gladstone will move it when the member fills in a field elsewhere.
The value is stored on a profile-data record attached to the member. If the member has no such record yet, one is created on the first call, so you do not need to initialise anything.
Each call overwrites the previous percentage outright; there is no history, and the value can go down as well as up.
Linked members are permitted — a token issued for a member linked to {memberId} may call this endpoint.
Endpoint
PUT {base_url}/api/members/{memberId}/profile-progress
{base_url} is the environment URL issued to your integration. See Authenticating with Gladstone APIs.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
memberId | integer (int32) | Yes | The member whose profile progress is recorded. Must match the member id in your access token, or be a member linked to it. |
Request body
| Field | Type | Required | Description |
|---|---|---|---|
completedPercentage | integer (int32) | Yes | How complete the profile is, as a whole number from 0 to 100 inclusive. Anything outside that range, a non-integer, or a missing value is rejected with 400. Send 0 to reset the indicator — omitting the field is not the same thing and fails validation. The meaning of the number is entirely yours; the platform does not derive it from any profile field. |
Sample request
curl -X PUT '{base_url}/api/members/{memberId}/profile-progress' \
-H 'Authorization: Bearer {accessToken}' \
-H 'X-Use-SSO: true' \
-H 'Content-Type: application/json' \
-d '{
"completedPercentage": 1
}'Errors
A successful call returns 204 No Content.
| Status | Meaning | When |
|---|---|---|
400 | Bad request | completedPercentage is missing, or outside 0–100. Returned as a model-state object rather than a plain string. |
404 | Not found | No member exists with that id: {memberId} is an invalid member ID |
500 | Internal server error | Saving the change failed, or another unexpected server-side failure occurred. No detail is returned in the body. |