REST API - Users

Create

To create a user, send a POST request to /api/users

HTTP request

POST /api/users

Parameters

Parameter	Type	Description	Required	Notes
form_name	String	Name of the form configuration	Required
form	UserForm	UserForm parameters that corresponds with Form configuration	Required

User Parameters

Example request

"Authorization: Token token=[YOUR API TOKEN]"
"Accept: application/json"
"Content-Type: application/json"

{
  "form_name": "reference_rest_api_create_user",
  "form": {
    "first_name": "Example",
    "email": "example1@example.com",
    "password": "somepassword"
  }
}

Element	Type	Description	Required?
form_name	String	Name of the defined Form	Required
form	UserForm	Attributes for user, should match configuration defined in corresponding Form	Required

Example response

HTTP/1.1 201 Created
Content-Type: application/vnd.api+json

{
  "id": 1,
  "errors": {}
}

Element	Type	Description
id	Integer	Object identifier
errors	Object	Validation errors

Error and Status Codes

Code	Message	Meaning
201	Created	Resource was created
401	Unathorized	Invalid Authentication
406	Not Acceptable	Wrong parameters passed
422	Unprocessable Entity	Wrong values, not matched validations

Update

To update an user, send a PUT request to /api/users/:user_id

HTTP request

PUT /api/users/:user_id

Parameters

Parameter	Type	Description	Required	Notes
form_name	String	Name of the form configuration	Required
form	UserForm	UserForm parameters that corresponds with Form configuration	Required

User Parameters

Example request

"Authorization: Token token=[YOUR API TOKEN]"
"Accept: application/json"
"Content-Type: application/json"

{
  "form_name": "reference_rest_api_update_user",
  "form": {
    "first_name": "Example"
  }
}

Element	Type	Description	Required?
form_name	String	Name of the defined Form	Required
form	UserForm	Attributes for user, should match configuration defined in corresponding Form	Required

Example response

HTTP/1.1 201 Created
Content-Type: application/vnd.api+json

{}

Error and Status Codes

Code	Message	Meaning
204	No Content	Successfully fulfilled request
401	Unathorized	Invalid Authentication
404	Not Found	Can't find given resource
406	Not Acceptable	Wrong parameters passed

Was this page helpful?

Contribute to this page

Thank you. We have received your feedback.

If you would like to give us more details, please do so below.

We’re glad you liked our documentation page!
Why did you like it? How could we make it even better? We are continuously working on our docs to make them better.
How do you think we could improve this page? We’re sorry you didn’t like our documentation page.
What was the problem? How do you think we could fix it?

Would you like to get an answer from us?

Send