Auth API

In addition to the Zuar Runner API, Zuar Runner users also have access to the Auth API, which among other things, enables the ability to list, create, update, and delete users in the Zuar Runner UI.

Endpoints and Methods

Zuar Runner has Swagger documentation at https://{runner_url}/auth/docs. You can see all the Auth API endpoints and test them using the Swagger UI.

Zuar Runner Auth API Swagger docs

Auth API Usage

For more information about API usage and authorization please visit the Zuar Runner API help page.

Steps to Create A Zuar Runner User

  1. Browse to https://{runner_url}/auth/docs#/default/create_user_users_post

  2. Expand POST /api/users Create User endpoint

  3. Edit the input parameters so that the strings represent the appropriate user data

  4. Execute the Create User command

  5. Optional but usually necessary, create the user inside of Zuar Runner’s PostgreSQL database (see link below). A simple command to create a PostGreSQL Super User: CREATE USER "newuser" WITH PASSWORD 'password' SUPERUSER CREATEDB;

Note

A database user is not created. Please consult PostgreSQL Documentation on creating new users.

Steps to Delete a Zuar Runner User

  1. Browse to https://{runner_url}/auth/docs#/default/create_user_users_post

  2. Expand and Execute GET /api/users endpoint to list the users

  3. Retrieve the ID for the user you wish to delete

  4. Scroll down to the DELETE /api/users/{user_id} endpoint

  5. Enter the ID for the desired user into the user_id field

  6. Execute the DELETE /api/users/{user_id}

  7. Optional but usually necessary, remove the user from Zuar Runner’s PostgreSQL

Steps to List existing Zuar Runner Users

  1. Browse to https://{runner_url}/auth/docs#/default/list_users_users_get

  2. Execute the List Users command

  3. The output will contain information for all existing users.