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. Your Bucket has its own read and write keys for restricted access.

Parameter Required Type Description
email required String Your Cosmic JS login email
password required String Your Cosmic JS login password

    Use your token

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

    Example Request with CURL

    curl "https://api.cosmicjs.com/v1/buckets" \
    -H "Authorization: Bearer <ACCESS_TOKEN>" \
    -H "Content-Type: application/json"
    # Gets all Buckets connected to your account. Your authorization token in the header request is the only required property.
    

    Example Request with the NPM module

    const Cosmic = require('cosmicjs')({
      token: 'your-token-from-auth-request'
    })
    Cosmic.getBuckets()
    .then(data => {
      console.log(data)
    })
    .catch(err => {
      console.log(err)
    })