Skip to content

User

Create

As a maintainer of a rAPId you can create new users to interact with the API to upload or query data, generate their credentials and add permissions to them.

Permissions

USER_ADMIN

Path

POST /user

Inputs

Parameters Usage Example values Definition
User details JSON Request Body See below The name of the user application to onboard and the granted permissions
{
  "username": "john_doe",
  "email": "john.doe@email.com",
  "permissions": ["READ_ALL", "WRITE_PUBLIC"]
}

Username

The username must adhere to the following conditions:

  • Alphanumeric
  • Start with an alphabetic character
  • Can contain any symbol of . - _ @
  • Must be between 3 and 128 characters

Email address

The email must adhere to the following conditions:

  • The domain must be included on the ALLOWED_EMAIL_DOMAINS environment
  • Must satisfy the Email Standard Structure RFC5322 ( see Email Address in Wikipedia)

Outputs

Once the new user has been created, the following information will be shown in the response:

{
  "username": "jhon_doe",
  "email": "jhon.doe@email.com",
  "permissions": ["READ_ALL", "WRITE_PUBLIC"],
  "user_id": "some-generated-id-eq2e3q-eqwe32-12eqwe214q"
}

Delete

Given a user already exists you can delete them from rAPId.

Permissions

USER_ADMIN

Path

DELETE /user

Inputs

Parameters Usage Example values Definition
user details JSON Request Body See below The name and id of the user to delete
{
  "username": "John Doe",
  "user_id": "some-uuid-generated-string-asdasd0-2133"
}

Outputs

Confirmation Message:

{
  "message": "The user '{username}' has been deleted"
}