GOgorest
Users

Create a user

post/users

Request

  • Base URL
    https://gorest.co.in/public/v3
  • URL
    https://gorest.co.in/public/v3/users
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring

A unique key (a UUID is fine) that makes a POST safe to retry for 24 hours. A retry with the same key, path and body gets the first answer again with Idempotent-Replayed: true and creates nothing; a retry while the first is still running gets 409 conflict with Retry-After: 1. The same key with another request gets 422 idempotency_key_mismatch. Only a 2xx answer is kept, so after an error the retry runs again. An answer over 64 KiB, or one that holds a new token's value, is not kept: its retry gets 409 conflict with the Location of what the first request made.

Request body

emailstring email required
namestring required

Not blank; spaces at the ends are dropped.

status'active' | 'inactive'

Response

The new user.

created_atstring date-time
emailstring email
idstring uuid required
namestring
read_onlyboolean

True for sample data (the seed); it cannot be changed.

status'active' | 'inactive'
updated_atstring date-time

Example response

{
  "email": "aarav.sharma@example.com",
  "name": "Aarav Sharma"
}

Changes

No recorded changes to this operation across all 1 revision of this API.