'How to' Library

You can join an Aurora organization in two ways:

• Using an email invitation
• Joining directly through the Aurora interface

Follow the steps below based on the method available to you.

Option 1: Join via Email Invitation (Recommended)

If you’ve received an invitation email, this is the quickest way to join.

Step 1: Open the Invitation Email
Look for an email that includes an invitation to join an organization.

Step 2: Click “Accept Invitation”
This will automatically redirect you to Aurora.

Step 3: Complete the Joining Process
You’ll be taken to the screen where you can confirm and join the workspace.

Option 2: Join Through the Aurora Interface

If you prefer joining from within Aurora when you already have a workspace, follow these steps:

Step 1: Log in to Aurora
Use your credentials to sign in.

Step 2: Open the Organization Menu
Click on the Organization Logo located at the top-left corner of the dashboard.

Step 3: Select “Create or Join an Organization”
Choose this option from the dropdown.

Step 4: Click “Join”
Confirm that you want to join an existing workspace (same interface as Step 3 in the Email flow).

This guide walks you through the process of creating your Aurora account and setting up your organisation.

1. Visit Aurora

2. Enter the email address you want to register/ Use your google account to sign up

Click Continue with Email

3. Enter the OTP sent to your email ID:

Submit OTP to continue

4. Create Organisation

5. Enter your basic details and create your workspace

On clicking on "Create" you will enter the explore page of Aurora.

1. Visit Aurora

2. Enter the email address you want to register/ Use your google account to sign up

Click Continue with Email

3. Enter the OTP sent to your email ID:

Submit OTP to continue

You will enter the explore page of Aurora.

Pixxel's hyperspectral imaging satellites provide valuable Earth observation data with detailed spectral information. Here's a step-by-step guide on how to explore and access these images through the platform.

Getting Started with Pixxel Constellations

To begin exploring Pixxel's hyperspectral imagery:

1. Navigate to the Explore page on the platform
2. Look for the Heatmap icon in the tools panel on the right side of the screen

3. You can select any one or all satellites simultaneously by checking the corresponding boxes in the Heatmap panel.

Exploring Available Imagery

Once you've selected your preferred satellites:

1. Zoom out to a global view to see all available image locations
2. Red pins on the world map indicate locations where Pixxel imagery is available
3. Each pin represents a specific image capture from one of the Pixxel satellites

Viewing Image Details

To examine a specific image:

1. Click on a red pin of interest on the map
2. The selected area will be displayed with its boundaries outlined.

Accessing Full Image Data

To request access to the full hyperspectral image:

1. On the image preview panel, click the three-dot menu (⋮) and then select “View more information.”

1. Hover over the Image ID field and copy the Image ID from the highlighted value.

2. Share this ID with your contact person at Pixxel to gain access to the full hyperspectral dataset

Pixxel sends essential emails like OTPs, account alerts, and order updates. If you're on a corporate or institutional network, these may get filtered unless whitelisted.

Follow the steps below to whitelist our emails

Step 1: Ask Your IT Team to Whitelist the Following:

Domain to Whitelist:
pixxel.space

IP Address:

• 66.249.80.0/20
• 66.102.0.0/21
• 72.14.192.0/18
• 74.125.0.0/16
• 108.177.8.0/21
• 173.194.0.0/16
• 209.85.128.0/17
• 216.58.192.0/19
• 216.239.32.0/19
• 172.217.0.0/19
• 172.217.32.0/20
• 172.217.128.0/19
• 172.217.160.0/20
• 172.217.192.0/19
• 172.253.56.0/21
• 172.253.112.0/20

Email Addresses to Whitelist:

• @pixxel.space
• @stripe.com
• support@pixxel.space
• no-reply@pixxel.space

If you're using a personal email (like Gmail or Outlook), you may also want to mark Pixxel emails as "Not Spam" and add the above addresses to your contact list.

Step 2: Sign Up on the Pixxel Platform

Once whitelisting is complete:

1. Go to Aurora - Sign up page.
2. Fill out the signup form
3. Enter the OTP sent to your email to log in

Step 3: Check for Emails

If you do not see an email from Pixxel, try the following:

• Check your Spam, Junk, or Promotions folders
• Search your inbox for pixxel.space
• Confirm with your IT team that the domain and email addresses were successfully whitelisted

Why This Is Important

Our platform relies on timely email delivery for user authentication, tasking updates, and satellite capture confirmations. Missing these emails may impact your ability to access your account or monitor your AOIs effectively.

Need Help?

If you're still experiencing issues receiving emails, please contact us at:
support@pixxel.space

We're happy to help you troubleshoot further.

To access and interact with the Aurora API, you’ll first need to generate a project-specific API key to authenticate API requests. This article walks you through the process from start to finish.

Step 1: Create a Service Account and Generate an API Key

1. Log in to your organization.

2. Make sure you have a project that you have access to. If you do not, create a new project as shown below.
   
   Give Project title and name to complete the project creation
   

3. Navigate to Organization Settings → API.
   

4. Click on Create new service account. A small window will pop up, asking Name and the Project under which the service account should be created. After filling it up, click Create.
   

5. By default, the an initial API key is generated. Make sure to copy and store it securely, as you won’t be able to view it again later.
   

6. You can create multiple keys per service account. If you want to generate another key under the same service account, you can revoke the access to the previous one, and create a new key by giving it a name and  clicking Generate new key at the top.
   
   

7. You can also manage which projects this service account has access to by clicking on Manage access and selecting all the projects you want access for. Note that you can only select the projects you are part of.

IMPORTANT: Keep your API keys secure. Do not share them publicly.

Step 2: Test Your API Key

1. Open the Aurora API Documentation Portal.
   

2. Select an endpoint to test—for example, List all bandsets. Click on Try it to test. out the API Key.
   

3. In the Authentication field, paste your API key. and click Send to send your request
   
   
   

4. If you receive a response with code 200, it means that your request went through and your API key is working just fine. If you receive response code 40x, check your request parameters for some errors.

That’s It!

You’ve successfully generated and tested your API key. You’re now ready to build with the Aurora API!

Need help with specific endpoints or error handling? Visit the full API reference for more details.

This guide walks you through the process of switching organizations in your Aurora dashboard.

1. Visit Aurora.

2. Click the top-left icon to view all organizations linked to your account.

3. Select any organization that you would like to work with. 

To view the available subscription plans in Aurora:

1. Click on your email address in the top-left corner of the screen to open the dropdown menu

Select "Organization settings"

2. In the left sidebar menu, click on "Plans"

Alternatively
Click on the upgrade Icon on the left

Here you'll find three subscription tiers:

• Standard Plan 
• Professional Plan - Includes Analytics and 150 free tokens
• Enterprise Plan  - Includes Advanced features and 300 free tokens

Each paid plan offers monthly and yearly billing options, with a 10% discount when you choose annual billing.

For more information about billing and invoices, you can contact support@pixxel.space

Note: Both Professional and Enterprise plans include a 30-day free trial period and unlimited wallet recharge options.

1 min Video Tutorial -

What are tokens:

Tokens are Pixxel's virtual currency used to purchase imagery, perform visualisations, and create workflows on the Aurora platform.

Note: 1$- 1 Token

Checking and adding tokens:

Checking Token Balance

1. Navigate to "Tokens" in the organisation menu

Your available tokens are displayed prominently with a pink diamond icon and a numerical value next to it

Adding New Tokens

Click the "Add tokens" button in the top right of the Tokens page

Select the desired quantity (starts at $1.00)

Once the payment is completed, the tokens will reflect on the token section.

In this guide, you'll learn how to view and manage your billing information and invoices.

Accessing Billing Information

1. Navigate to "Organization" in the sidebar

2. Select "Billing" from the menu options

3. View your billing dashboard

4. Click on "View Invoice"

Note: The invoice number is present here. Choose between downloading the invoice or downloading the receipt.

Note: For additional support or questions, contact support@pixxel.space

In this guide, you'll learn how to browse and select satellite imagery from available options for your area of interest.

After selecting/uploading your AOI, you will be presented with this screen:

You can select several options based off your need:

Setting Date Range:

1. Look for the Date Range section at the top of the Filters panel
2. Use the calendar icons to select:
   • Start date
   • End date
3. The system will display images within your selected range for your AOI

Access the Satellites section to select from:

• Landsat 8-9
• Sentinel-2
• Modis NBAR Daily
• Pixel-TD01
• Pixel-TD02
• Sentinel-1 (RTC)
• MODIS LST/E 8-Day

• MODIS SR 8-Day 250m

• EO-01 Hyperion\

Cloud Percentage:

• Percentage of cloud cover

Spatial Resolution (GSD):

• Specific to each satellite

The Image information will be on the right side and it will inform the image you have selected

Once you have selected the image you need, click on Save:

You will then see this screen: 

Click Save to save your AOI

Note: You can create a new Project if no previous projects exist.

Great! you have now saved your AOI.

In this guide, you'll learn how to upload Area of Interest (AOI) files to visualize and analyze specific geographic regions in our platform.

How to Upload Files

1. Navigate to the "Explore" section

2. Click the "Upload AOI" button in the top right corner

Note: Supported File Formats The platform accepts the following file formats:

• GeoJSON
• KML
• KMZ
• Zipped SHP files
• Single SHP files

You will receive an error like this if you upload the wrong file:

3. Select your file from your local system

4. Wait for the file to process and appear on the map

Note: When defining your Area of Interest (AOI), keep in mind the following size restrictions:

• Maximum AOI size is 5000 km²
• Attempting to exceed this limit will trigger an "Area Limit Reached!" warning
• You will need to either:
  • Reduce your selected area to stay within limits
  • Click "Upgrade Plan" for larger area analysis capabilities
• AOI with holes (donuts) are not supported.
• Only WGS84 [EPSG:4326] projection is supported