Users

List users

get
Responses
200

OK

application/json
get
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

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
post
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
get
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

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

No content

Was this helpful?