Skip to content

Authentication

Get your token

You can get your authentication token in your user account settings located in Account Settings > Authentication. You can also make requests to the API with your email and password.

Send your email and password to receive your access token. Your access token will be used to add Buckets to your account as well as other account-related access.

⚠

Note
You do not need to use the token to access your Bucket content. Your Bucket has its own read and write keys for restricted access.

ParameterRequiredTypeDescription
emailrequiredStringYour Cosmic login email
passwordrequiredStringYour Cosmic login password

Methods

POST $BASE_URL/authenticate

Example Body (JSON)

{
  "email": "you@youremail.com",
  "password": "yourpassword"
}

Example Response

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXV.eyJlbWFpbCI6InNwaXJvbnl..."
}

Use your token

You can use the Authentication token using REST requests to the API

Example -> Get Buckets

⚠

Required
token must be passed as Authorization Bearer in the header of the request.

Methods

GET $BASE_URL/buckets

Header

{
  "Authorization": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXV.eyJlbWFpbCI6InNwaXJvbnl..."
}