Authentication

Authenticate with the Fusioncat API

Fusioncat is currently in its alpha stage. The main API server is located at: https://api.staging.fusioncatalyst.io/

Please note that breaking changes and bugs are to be expected, as the product is still under active development.

Authentication Commands

The paw auth commands allow you to authenticate with the Fusioncat API.

Commands

auth signin

Sign in to an existing Fusioncat account.

paw auth signin --email <email> --password <password>

# This call will return an authentication token that can be used for subsequent API calls.
# export FC_ACCESS_TOKEN="your-auth-token"

Options

• --email (required): Your email address
• --password (required): Your password

Examples

# Sign in without saving token (one-time use)
paw auth signin --email [e-mail] --password mypassword

# This call will return an authentication token that can be used for subsequent API calls.
# export FC_ACCESS_TOKEN="your-auth-token"

auth signup

Create a new Fusioncat account.

paw auth signup --email <email> --password <password>

# This call will return an authentication token that can be used for subsequent API calls.
# export FC_ACCESS_TOKEN="your-auth-token"

Options

• --email (required): Your email address
• --password (required): Your password (must be secure)

Examples

# Create new account and save token
paw auth signup --email [e-mail] --password securepassword
export FC_ACCESS_TOKEN="your-auth-token"

auth me

Get information about the current authenticated user.

paw auth me

This command requires a valid authentication token in the FC_ACCESS_TOKEN environment variable.

Examples

# Check current user
paw auth me

Token Management

Using Environment Variables

# View your current token
echo $FC_ACCESS_TOKEN

# Manually set a token
export FC_ACCESS_TOKEN="your-auth-token"

# Remove authentication
unset FC_ACCESS_TOKEN

Token Security

• Tokens expire after a certain period (check with your administrator)
• Never commit tokens to version control
• Use environment-specific token management for CI/CD

Troubleshooting

Invalid Credentials

If you receive an authentication error:

1. Verify your email and password are correct
2. Check if your account is active
3. Ensure you’re using the correct server URL

Token Expired

If your token has expired:

# Sign in again to get a new token
paw auth signin --email [e-mail] --password yourpassword --save-token

No Token Found

If you see “authentication required” errors:

# Ensure you have a token set
echo $FC_ACCESS_TOKEN

# If empty, sign in again
paw auth signin --email [e-mail] --password yourpassword --save-token