Create user field history
POST
/v1/communities/{communityId}/user-fields/{fieldId}/users/{userId}/histories
/v1/communities/{communityId}/user-fields/{fieldId}/users/{userId}/histories. Authorization: Bearer <apiKey> or an admin bearer token, depending on the owning API surface. The key must be scoped to the community and have user-field access.data with status and message.400 invalid request body, query, ObjectId, pagination, file format, or missing required field.401 missing, invalid, expired, or insufficient API key/token.403 key is valid but cannot access this community/channel/user/resource, where supported by the service.404 target resource, route, or community-scoped record was not found.409 duplicate or conflicting state for create/update operations, where applicable.500 unexpected Returning.AI service error.Request
Path Params
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.returning.ai/v1/communities//user-fields//users//histories' \
--header 'Content-Type: application/json' \
--data '{
"value": 10,
"action": "increase"
}'Response Response Example
201 - Success
{
"meta": {
"status": "success",
"statusCode": 201,
"sum": 500
},
"message": "User field history created successfully",
"data": {
"_id": "685957701ff244c62bd2e5b4",
"fieldId": "6857de260f3c24d98fd7ca89",
"value": 500,
"action": "overwrite",
"createdAt": "2025-06-23T13:32:32.950Z"
}
}Modified at 2026-05-18 17:03:37