Skip to main content

Legacy Customer Migration Guide

Migration Complete

As of January 28, 2026, we've migrated to our new petal.tech platform. This guide explains what changed and what you need to do.

Key Dates​

DateEvent
January 28, 2026Migration to petal.tech complete
February 27, 2026Grandfathered API access ends

Customer Types​

Metrics 0.5.3 Customers (One-Time Purchase)​

What you purchased: Desktop app license for Windows, Mac, or Linux

What's changed:

  • Your original purchase gave you lifetime access to Metrics 0.5.3
  • Metrics 0.5.3 continues to work exactly as before
  • The new Metrics 1.0+ requires a subscription from petal.tech

What you need to do:

  • Nothing, if you want to keep using Metrics 0.5.3
  • To upgrade to Metrics 1.0+, purchase a subscription at petal.tech/pricing

API Developer (Pro) Customers (Subscription)​

What you purchased: API access subscription (legacy)

What's changed:

  • Your API key continues to work during a 30-day grace period
  • Grace period ends: February 27, 2026
  • After that date, you'll need an active subscription to use the API

What you need to do:

  1. Before the grace period ends, purchase a Standard ($39.99/mo) or Advanced ($79.99/mo) plan at petal.tech/pricing
  2. Your existing API key will continue to work once you have an active subscription
  3. No need to generate a new key

API Error Codes​

If you're using the API, you may encounter these error codes during and after the migration:

SUBSCRIPTION_EXPIRED​

Message: "Subscription has expired. Please renew to continue using the API."

What it means: Your grandfathered access period has ended.

How to fix: Purchase a Standard or Advanced plan at petal.tech/pricing. Your existing API key will work again once your subscription is active.

Response example:

{
  "valid": false,
  "code": "SUBSCRIPTION_EXPIRED",
  "expires_at": "2026-02-27T00:00:00Z"
}

SUBSCRIPTION_INACTIVE​

Message: "Associated subscription is not active"

What it means: Your account exists but you don't have an active subscription.

How to fix: Purchase a plan at petal.tech/pricing.

INVALID_API_KEY​

Message: "Invalid API key"

What it means: The API key wasn't found in our system.

How to fix:

  1. Check that you're using the correct key
  2. Log in to petal.tech/account to view or generate your API key
  3. If you're a legacy customer, contact support@petal.tech

API_ACCESS_DISABLED​

Message: "Current plan does not include API access"

What it means: Your subscription plan (Basic) doesn't include API access.

How to fix: Upgrade to Standard or Advanced plan at petal.tech/account.

Successful Validation Response​

When an API key is valid, you'll receive:

{
  "valid": true,
  "plan": "standard",
  "features": {
    "real_time_visualization": true,
    "osc_lsl_streaming": true,
    "session_recording": true,
    "csv_export": true,
    "api_access": true,
    "signal_filtering": false,
    "custom_preprocessing": false,
    "mental_state_detection": false,
    "max_devices": 1
  },
  "subscription_active": true,
  "expires_at": "2026-02-27T00:00:00Z"
}
note

The expires_at field is only present for grandfathered subscriptions. Regular Stripe subscriptions renew automatically and don't include this field.

Frequently Asked Questions​

Do I need to create a new account?​

If you're a legacy customer, an account has been created for you using your original order email. Use "Forgot Password" at petal.tech/login to set your password.

Will my old API key still work?​

Yes, if you had an API Developer subscription. During the 30-day grace period (until February 27, 2026), your key works normally. After that, you need an active subscription.

What happens to my Metrics 0.5.3 license?​

Nothing changes. Metrics 0.5.3 continues to work as it always has. Only Metrics 1.0+ requires a subscription.

Which plan do I need for API access?​

Standard ($39.99/mo) or Advanced ($79.99/mo). The Basic plan does not include API access.

I'm getting SUBSCRIPTION_EXPIRED but I just subscribed​

There may be a brief delay after payment processing. Wait a few minutes and try again. If the issue persists, contact support@petal.tech.

Need Help?​

Contact us at support@petal.tech