Summary of Content

Requirements
Authenticate using cuRL
Related Resources

Requirements

  • You must have a valid API token and Client Id. Learn more.

Authenticate using cURL

  1. Open your terminal. 
  2. Identify your target /auth endpoint
    For GCP organizations, use:
    POST https://api.sigmacomputing.com/v2/auth/token
    For AWS organizations, use:
    POST https://aws-api.sigmacomputing.comv2/auth/token

    Help me identify my cloud.

  3. Run the following command:
    curl --location --request POST '{endpoint-url}' \
    --header 'Content-Type: application/x-www-form-urlencoded' \
    --data-urlencode 'grant_type=client_credentials' \
    --data-urlencode 'client_id={client_id}' \
    --data-urlencode 'client_secret={api_token}'

Expected Response:

{
  "access_token": {access_token},
  "refresh_token": {refresh_token},
  "token_type": "bearer",
  "expires_in": 3600
}


Now what?

  • Use the access_token from the response in future API calls. Try it with the WhoAmI endpoint.
  • Use the refresh_token to refresh expired auth.
    Note: An access token lasts for 1 hour.

 

Related Resources

Get an API Token and Client Id