Skip to content

AddUser

Request

Add user by specifying relevant fields. User must have a valid token with required permissions.

Endpoint: POST /v1/user. Authentication: requires AuthorizationHeader bearer token unless this operation's security is changed. Required AuthMind permission/scope: admin/user (grant this scope on the API token in Admin > API Tokens; a token without it receives 403 Forbidden). No query or path parameters are documented for this operation. Request body: send JSON matching the referenced request schema. Response parsing: inspect success; on failure inspect error, errors, or message depending on the referenced schema.

Security
AuthorizationHeader
Bodyapplication/jsonrequired
namestringrequired

Display name or resource name, depending on the schema context.

Example:"Jane Doe"
emailstringrequired

User email address.

Example:"jane.doe@example.com"
rolestringrequired

AuthMind user role. Valid values should be retrieved from GET /v1/roles unless documented otherwise.

Example:"Admin"
passwordstring or null

Password value used by the user-management operation when applicable.

Example:"DummyPassw0rd!"
localestring or null

User locale. Only "English" is currently accepted; any other non-empty value is rejected with 400 Bad Request (Only 'English' locale is supported.). An empty value is allowed.

curl -i -X POST \
  https://apidoc.authmind.com/_mock/v1/docs/v1/user \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Jane Doe",
    "email": "jane.doe@example.com",
    "role": "Admin",
    "password": "DummyPassw0rd!",
    "locale": "en-US"
  }'

Responses

Request completed successfully. See the referenced schema for the response envelope and result payload.

Bodyapplication/json
errorsstring

Error message returned when the request fails. This is free-form, human-readable text intended for logging/display -- AuthMind does not define a stable, cross-endpoint error-code contract for it. Branch integration logic on the HTTP status code and the success boolean, not on the contents of this string.

successboolean

Indicates whether the request was successful.

Response
{
  "errors": "",
  "success": true
}