Users

List users

get

Responses

200

OK

application/json

401

Unauthorized

application/json

500

Internal Server Error

application/json

get

/users

HTTPcURLJavaScriptPython

GET /v1/users HTTP/1.1
Host: 
Accept: */*

{
  "users": [
    {
      "apiVersion": "string",
      "kind": "string",
      "metadata": {
        "additionalInfo": {
          "documentation": [
            {
              "text": "text",
              "url": "text"
            }
          ],
          "message": "string"
        },
        "dateModified": "text",
        "deprecated": true,
        "description": "string",
        "displayName": "string",
        "hash": "text",
        "icon": "string",
        "id": "string",
        "labels": {},
        "name": "string",
        "resourceDocLink": "string",
        "stability": "string",
        "version": 1,
        "warning": "string"
      },
      "spec": {
        "activeAccount": "text",
        "email": "text",
        "nextLoginAccount": "text",
        "requestedMFA": true
      },
      "status": {}
    }
  ]
}

Add User to Current Project

post

The /users route will add a new user to an existing project. If the create flag is set, and the user doesn't already exist, it will create the user and add a new login in addition to the the project binding.

Body

application/json

Body of the request to add a user to an account

createbooleanOptional

Create should be true if the user should be created if they do not exist

emailstringOptional

Email address of the user to add

namestringOptional

Name of the user to add

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

422

Tried to update a non-existing user, use the create flag to create a new user

application/json

500

Internal Server Error

application/json

post

/users

HTTPcURLJavaScriptPython

POST /v1/users HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 44

{
  "create": true,
  "email": "text",
  "name": "text"
}

{
  "updates": [
    {
      "before": null,
      "reason": "string",
      "resource": null,
      "status": "error"
    }
  ]
}

Get user by id

get

Path parameters

idstringRequired

the id of the user

Responses

200

OK

application/json

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get

/users/{id}

HTTPcURLJavaScriptPython

GET /v1/users/{id} HTTP/1.1
Host: 
Accept: */*

{
  "user": {
    "apiVersion": "string",
    "kind": "string",
    "metadata": {
      "additionalInfo": {
        "documentation": [
          {
            "text": "text",
            "url": "text"
          }
        ],
        "message": "string"
      },
      "dateModified": "text",
      "deprecated": true,
      "description": "string",
      "displayName": "string",
      "hash": "text",
      "icon": "string",
      "id": "string",
      "labels": {},
      "name": "string",
      "resourceDocLink": "string",
      "stability": "string",
      "version": 1,
      "warning": "string"
    },
    "spec": {
      "activeAccount": "text",
      "email": "text",
      "nextLoginAccount": "text",
      "requestedMFA": true
    },
    "status": {}
  }
}

Delete user by id

delete

Path parameters

idstringRequired

the id of the user to delete

Responses

204

Successful Delete, no content

No content

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

delete

/users/{id}

HTTPcURLJavaScriptPython

DELETE /v1/users/{id} HTTP/1.1
Host: 
Accept: */*

No content