Quickstart
This guide walks you through making your first request to the Stacked API.
Base URL
All API requests use the following base:
Get an API key
- Log in to the Stacked web app.
- Navigate to Settings → API.
- Click Create to generate a new key.
- Copy the key immediately — it won't be shown again.
Make your first request
Use the X-API-Key header to authenticate. This example fetches the list of users in your organization:
Read the response
A successful response follows this envelope structure:
Your results are in the data field. Note that not all endpoints use this exact envelope — endpoint reference pages document each controller's response shape.
Common mistakes
| Mistake | Response |
|---|---|
Missing X-API-Key header | 401 — Invalid token format |
| Using a regenerated or old key | 401 — Invalid API key |
See Authentication for the full list of auth error responses.