📋 Available on: Startup, Growth, Enterprise, Agency, and Custom 2026 plans (API access).
Archive uses the term Workspace ID in two different places, and they are not the same value. If you're setting up an API integration, this is the most common thing to get tripped up on.
The Two Workspace IDs
App Workspace ID — a short number (for example 12345) shown in the Archive app's account menu. This identifies your workspace inside the product. The API does not use this number.
API Workspace ID — a UUID, a long hyphenated string like
a9f2e8b1-0c7d-4a09-b265-18e0f9dx42a7. This is the value the API needs — it goes in theWORKSPACE-IDheader on your requests.
⚠️ Caution: The short number from the app (e.g. 76570) will not work as your WORKSPACE-ID. The API only accepts the UUID. If you use the app number, your requests will fail.
How to Find Your API Workspace ID (UUID)
The UUID isn't shown in the app — you retrieve it by running the workspaces query. This is the one query that doesn't need a WORKSPACE-ID header; it only needs your API token. It returns every workspace your token can access:
query ListWorkspaces {
workspaces(first: 20) {
nodes {
id
name
}
totalCount
}
}Each id in the response is a workspace UUID. Pick the workspace you want and copy its id — that's the value you set as your WORKSPACE-ID header for every other request.
For the full walkthrough, see the Workspaces page in the API docs, and Generating an API Token for getting your token.
Common Questions
Why doesn't the ID number from the app work in the API?
The number in the app's account menu (e.g.
76570) is an internal app identifier. The API identifies workspaces by their UUID instead, so it won't accept the app number. Run the workspaces query to get the UUID.Where do I put the UUID?
In the
WORKSPACE-IDheader of your API requests. The one exception is the workspaces query itself, which doesn't need the header.I have multiple workspaces — which UUID do I use?
The workspaces query returns all of them with their names. Use the
idof whichever workspace holds the data you want to query. Agency tokens cover all workspaces under the agency.