Authentication and Access

/signup

curl

curl https://ops.minusonedb.com/signup \
  -d "username=youremail@email.com&password=passphrase"

m1 client

m1 signup

Parameter	Type	Required
username	String	Yes
password	String	Yes

• Rights: none
• Verb: POST

Creates a user for you on ops. If successful, you can immediately authenticate using the username and password you supplied.

/auth

curl

curl https://ops.minusonedb.com/auth \
  -d "username=admin@email.com&password=passphrase"

m1 client

m1 auth

Parameter	Type	Required
username	String	Yes
password	String	Yes

• Rights: none
• Verb: POST

Log in and retrieve a token for service access.

▶200 OKReturns an authentication token

{
  "token": "eFRxichv7cTeqks99XD+iNBqR3Llg..."
}

/user/code

curl

curl https://ops.minusonedb.com/user/code \
  -d "username=youremail@email.com"

m1 client

m1 ops user/code -username youremail@email.com

Parameter	Type	Required
username	String	Yes. The account email address.

• Rights: none
• Verb: POST

Email the user a one-time verification code — the forgotten-password workflow. The code expires in 5 minutes and can be used once. The response is 200 OK whether or not the username exists, so the endpoint does not reveal which addresses have accounts.

Use the emailed code to authenticate via /auth, then set a new password with /user/password.

200 OK with no body — returned even for unknown usernames.

/user/password

curl

curl https://ops.minusonedb.com/user/password \
  -d "password=newPassphrase" \
  -H "m1-auth-token: $myToken"

m1 client

m1 ops user/password -password newPassphrase

Parameter	Type	Required
password	String	Yes
username	String	No. Specify user if admin is changing another user's password.

• Rights: none, admin if setting on behalf of another user
• Verb: POST

Change user password. A correct auth token must be included in the request.