Users and Tokens

/user/list

List all users and associated metadata.

• rights: admin
• verbs: GET
• parameters: none

curl

curl https://test-m1.minusonedb.com/user/list \
-H "m1-auth-token: $myToken"

m1 client

m1 test-m1 user/list

▶200 OKList of users

[
  {
    "username": "user",
    "rights": [
      "schema",
      "get",
      "publish"
    ]
  },
  {
    "username": "admin",
    "rights": [
      "schema",
      "sessionQuery",
      "get",
      "publish",
      "admin",
      "sessionUpdate"
    ]
  }
]

/user/get

Retrieve metadata for specified user.

• rights: admin
• verbs: GET

Parameter	Type	Required
username	String	Yes

curl

curl https://test-m1.minusonedb.com/user/get?username=user \
-H "m1-auth-token: $myToken"

m1 client

m1 test-m1 user/get -username user

▶200 OKUser metadata

[
  {
    "username": "user",
    "rights": [
      "schema",
      "get",
      "publish"
    ]
  }
]

/user/add

Add new user and specify rights.

• rights: admin
• verbs: POST

Parameter	Type	Required
username	String	Yes. Must be unique.
password	String	Yes
rights	Array	Yes. List of rights to grant to user.

curl

curl https://test-m1.minusonedb.com/user/add \
-d 'username=newUser&password=passphrase&rights=schema,get' \
-H "m1-auth-token: $myToken"

m1 client

m1 test-m1 user/add -username newUser \
-password passphrase -rights '["schema","get"]'

No response when successful.

/user/update

Update user metadata.

• rights: admin
• verbs: POST

Parameter	Type	Required
username	String	Yes
rights	Array	Yes. List of rights to grant to user.

curl

curl https://test-m1.minusonedb.com/user/update \
-d 'username=user&rights=get,publish' \
-H "m1-auth-token: $myToken"

m1 client

m1 test-m1 user/update -username user -rights '["get", "publish"]'

No response when successful.

/user/remove

Remove user; the user will no longer be able to access the associated environment.

• rights: admin
• verbs: POST

Parameter	Type	Required
username	String	Yes

curl

curl https://test-m1.minusonedb.com/user/remove \
-d "username=user" \
-H "m1-auth-token: $myToken"

m1 client

m1 test-m1 user/remove -username user

No response when successful.

/token/list

List all tokens.

• rights: admin
• verbs: GET
• parameters: none

curl

curl https://ops.minusonedb.com/token/list \
-H "m1-auth-token: $myToken"

m1 client

m1 ops token/list

▶200 OKList of active tokens

[
  {
    "expires": 1637190931886,
    "id": "f4946f10-c6d6-4345-9a8f-de6aec884186",
    "ip": "120.1.88.123",
    "username": "user@email.com"
  }
]

/token/data

Decodes the elements that make up a token.

• rights: admin
• verbs: POST

Parameter	Type	Required
token	String	Yes

curl

curl https://test-m1.minusonedb.com/token/data \
-d "token=eFRxichv7cTeqks99XD+iNBqR3LlgILIZ3nhKieS8c8qajV9+JcNqSqZfngvS+gJM3IBKnvI2Crd66WOIswtlr7ps5DnOtCp5KjJu/lUKN2bCiUUGKJKHc8wYgUKienHOoL00LIbsLvCMQjcjoW9U+u88ZEqqvyE/qhSmTJSONdnEicbHYzy9pjJ0+RcrFyP" \
-H "m1-auth-token: $myToken"

m1 client

m1 test-m1 token/data -token eFRxichv7cTeqks99XD+iNBqR3LlgILIZ3nhKieS8c8qajV9+JcNqSqZfngvS+gJM3IBKnvI2Crd66WOIswtlr7ps5DnOtCp5KjJu/lUKN2bCiUUGKJKHc8wYgUKienHOoL00LIbsLvCMQjcjoW9U+u88ZEqqvyE/qhSmTJSONdnEicbHYzy9pjJ0+RcrFyP

▶200 OKDecoded token data

{
  "expires": 1637456697412,
  "ip": "96.253.115.241",
  "id": "687569bd-dfde-463f-b85d-dd8b1a7ea50c",
  "user": "delete"
}

/token/delete

Deletes all active tokens in an environment. This will require that all users reauthenticate.

• rights: admin
• verbs: POST
• parameters: none

curl

curl -X POST https://test-m1.minusonedb.com/token/delete \
-H "m1-auth-token: $myToken"

m1 client

m1 test-m1 token/delete

No response when successful.