Documentation Documentation

Admin API Users

In order to make it easier to create and manage users in Tyk Dashboard, there is an Admin API version of the Users API that is not Organisation specific.

Get User

Property Description
Resource URL /admin/users/{user-id}}
Method GET
Type None
Body None
Param None

Sample Request

    GET /admin/users/54bd0ad9ff4329b88985aafb HTTP/1.1
    Host: localhost:3000
    admin-auth: 12345

Sample Response

    {
        "api_model": {},
        "first_name": "Test",
        "last_name": "User",
        "email_address": "[email protected]",
        "password": "",
        "org_id": "54b53d3aeba6db5c35000002",
        "active": true,
        "id": "54bd0ad9ff4329b88985aafb",
        "access_key": "f81ee6f0c8f2467d539c132c8a422346"
    }

Add user

If a user is created and the password is set to empty, it will be hashed.

Property Description
Resource URL /admin/users
Method POST
Type None
Body User Object
Param None

Sample Request

    POST /admin/users HTTP/1.1
    Host: localhost:3000
    admin-auth: 12345
    
    {
        "first_name": "Jason",
        "last_name": "Jasonson",
        "email_address": "[email protected]",
        "active": true,
        "password": "plaintext_password"
    }

Sample Response

    {
        "Status": "OK",
        "Message": "User created",
        "Meta": ""
    }

Update user

Warning: It is not possible to reset a user’s password by updating the user record - please use the reset password functionality for this.

Property Description
Resource URL /admin/users/{uid}
Method PUT
Type None
Body User Object
Param None

Sample Request

    PUT /admin/users/54c25e845d932847067402e2 HTTP/1.1
    Host: localhost:3000
    admin-auth: 12345
    
    {
        "first_name": "Jason",
        "last_name": "File",
        "email_address": "[email protected]",
        "active": true,
        "password": "plaintext_password"
    }

Sample Response

    {
        "Status": "OK",
        "Message": "User created",
        "Meta": ""
    }