---
title: "Lista os workspaces autorizados para esta chave"
method: GET
path: "/api/v1/workspaces"
tags: ["Workspaces"]
---

# Lista os workspaces autorizados para esta chave

`GET /api/v1/workspaces`

## Request

- Base URL: `https://snabber.com.br`
- URL: `https://snabber.com.br/api/v1/workspaces`
- Auth: HTTP bearer

Retorna os workspaces que esta chave de API está autorizada a acessar, e qual deles é o padrão (usado pelos demais endpoints quando `workspace_id` não é informado). Consulte antes de passar `workspace_id` explicitamente, para ter certeza de estar apontando para o workspace certo.

## Response `200`

Lista de workspaces

- WorkspaceList
  - `data` Workspace[]
    - `id` integer
    - `name` string
    - `is_default` boolean: Workspace usado quando um endpoint não recebe `workspace_id` explicitamente
  - `meta` object
    - `default_workspace_id` integer

## Other responses

- `401`: Chave de API ausente, inválida, revogada ou expirada
- `403`: Plano do usuário não tem acesso à API (downgrade para free)
- `429`: Limite de requisições excedido

---

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