Admin
Update User Service
Update user service entitlement (admin only)
PATCH
Update User Service
Endpoint
Overview
Updates or creates a service entitlement for a specific user. Requires admin access via DROP serviceaccessFlags or INTERNAL_SECRET.
Request
string
required
User ID to update
ServiceIdentifier
required
Service identifier:
DROP, MAILS, VAULT, or DBstring
Access tier (e.g., “free”, “premium”, “enterprise”)
Premium access flag
object
Custom access flags (JSON object)
object
Service-specific metadata (JSON object)
number
Custom storage limit in bytes
number
Custom API key limit
Response
object
Updated or created service entitlement
Authentication
Admin Access via DROP Service
User must have DROP service entitlement with:accessFlags.isNullDropTeam:trueaccessFlags.nullDropTeamRole:"founder"or"dev"
Internal Secret
Alternatively, usex-internal-secret header with INTERNAL_SECRET value.
Implementation Details
Code Reference
Status Codes
OK
Success
Bad Request
Validation error
Unauthorized
Missing or invalid authentication
Forbidden
Admin access required
Not Found
User not found
Example Request
Example Response
Audit Events
- SERVICE_ACCESS_GRANT: Service entitlement updated (only if authenticated via Bearer token, not internal secret)
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
application/json
Response
200 - application/json
Entitlement updated
Update User Service