> ## Documentation Index
> Fetch the complete documentation index at: https://docs.refy.to/llms.txt
> Use this file to discover all available pages before exploring further.

# Areas de trabalho e projetos

> Como o Refy organiza seu escopo operacional.

# Areas de trabalho e projetos

A area de trabalho e o escopo principal de operacao do Refy.

## Area de trabalho

A area de trabalho concentra:

* membros
* API keys
* cobranca
* eventos
* notificações
* conectores
* projetos

Rotas principais:

* `GET /v1/workspaces`
* `POST /v1/workspaces`
* `GET /v1/workspaces/{workspaceId}/members`
* `POST /v1/workspaces/{workspaceId}/members`
* `GET /v1/workspaces/{workspaceId}/api-keys`
* `POST /v1/workspaces/{workspaceId}/api-keys`

## Tenancy

Existe também uma superfície de inspeção de tenancy:

* `GET /v1/workspaces/{workspaceId}/tenancy`

Ela e util para operacao interna, observabilidade e entendimento do modo de persistencia atual.

## Projeto

O projeto é o contêiner operacional das análises.

É nele que vivem:

* domínio principal
* histórico de análises
* monitoramento
* membros vinculados ao projeto

Rotas principais:

* `GET /v1/workspaces/{workspaceId}/projects`
* `POST /v1/workspaces/{workspaceId}/projects`
* `GET /v1/workspaces/{workspaceId}/projects/{projectId}/members`
* `POST /v1/workspaces/{workspaceId}/projects/{projectId}/members`

## Quando usar membros de projeto

Use membros por projeto quando voce precisar restringir ou declarar responsabilidade operacional dentro de uma area de trabalho maior.

## Observação prática

Se você quer reproduzir o caminho feliz do produto:

1. crie ou descubra a area de trabalho
2. crie ou descubra o projeto
3. só então inicie análises