← Back

The Hatchbox API has a new, simpler structure

Improvement

We've reorganized the Hatchbox API around your apps directly. Endpoints that previously required an account ID in the URL — like /api/v1/accounts/:account_id/apps/:app_id/domains — now live at /api/v1/apps/:app_id/domains.

Since your API token already identifies you and your app ID is unique, the account ID was redundant. Along the way we've filled in some gaps: you can now list your apps, list and inspect your processes, and read individual domains. Check out the API documentation for the full reference.

The old account-scoped endpoints still work, so nothing you've built will break today. That said, they're now deprecated and we'd encourage you to move over when you get a chance — the new endpoints are a straight swap in most cases, just drop the /accounts/:account_id segments. We'll give you plenty of notice before anything is turned off.