---
title: "Verify auth and get the targeted space, user, membership, and all spaces"
method: GET
path: "/api/v1/auth"
tags: ["Auth"]
---

# Verify auth and get the targeted space, user, membership, and all spaces

`GET /api/v1/auth`

## Request

- Base URL: `https://api-docs.busabase.com`
- URL: `https://api-docs.busabase.com/api/v1/auth`
- Auth: none declared

## Response `200`

The space this request targets, the acting user, their membership, and every space the user belongs to (`spaces`). Open source returns the local space/user; the cloud resolves the real ones from the user API key — when `spaces` has more than one entry, target a specific space with the `x-busabase-space` header instead of relying on the default. Next: call playbooks search with the user's intent before other work.

- object
  - `space` object, required
    - `id` string, required
    - `name` string, required
    - `slug` string, required
    - `plan` string, required
    - `nodeVisibilityMode` 'open' | 'restricted'
  - `user` object, required
    - `id` string, required
    - `name` string, required
    - `email` string, required
    - `image` string, required
  - `member` object, required
    - `userId` string, required
    - `spaceId` string, required
    - `role` string, required
  - `spaces` object[], required
    - `id` string, required
    - `name` string, required
    - `slug` string, required
    - `plan` string, required
    - `nodeVisibilityMode` 'open' | 'restricted'
  - `createdSpace` boolean
  - `bootstrapRequired` boolean
  - `credentialPermissionLevel` 'read' | 'changeRequest' | 'write' | 'manage'
  - `effectivePermissionLevel` 'read' | 'changeRequest' | 'write' | 'manage'

---

[API](https://skmtc.dev/busabase/apis/busabase-api.md) · [All operations](https://skmtc.dev/busabase/apis/busabase-api/llms.txt) · [OpenAPI document](https://skmtc.dev/busabase/apis/busabase-api/revisions/bc6a7d5ff4c1?raw)