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

# Autenticação

> Como autenticar suas requisições e selecionar o workspace

Toda requisição à API precisa de uma **chave de API**.

## Gerando sua chave

Acesse [Chaves de API](https://cut.pro/studio/me/api-keys) nas configurações da sua conta e clique em **Nova chave**. Guarde a chave em local seguro — ela não é exibida novamente depois de criada.

## Enviando a chave

Envie a chave em **todas** as requisições, de uma das duas formas:

<CodeGroup>
  ```bash Header X-Api-Key theme={null}
  curl https://api.cut.pro/api/v1/workspace \
    -H "X-Api-Key: SUA_CHAVE"
  ```

  ```bash Authorization Bearer theme={null}
  curl https://api.cut.pro/api/v1/workspace \
    -H "Authorization: Bearer SUA_CHAVE"
  ```
</CodeGroup>

## Workspaces

Uma chave de API é vinculada a **um ou mais workspaces** (tokens com escopo, no estilo Cloudflare). Créditos, submissões, clipes e renders sempre pertencem ao workspace que a requisição resolver.

<Tabs>
  <Tab title="Chave de um workspace">
    Toda requisição opera nesse workspace automaticamente. **Nenhum header extra é necessário.**
  </Tab>

  <Tab title="Chave multi-workspace">
    Envie o header `X-Workspace-Id` em cada requisição para escolher qual workspace a chamada atinge:

    ```bash theme={null}
    curl https://api.cut.pro/api/v1/balance \
      -H "X-Api-Key: SUA_CHAVE" \
      -H "X-Workspace-Id: WORKSPACE_ID"
    ```

    Sem o header, a resposta é `400 MISSING_WORKSPACE_ID`, trazendo a lista de workspaces permitidos.
  </Tab>
</Tabs>

<Tip>
  Chame `GET /workspace` para inspecionar qual workspace a requisição atual resolveu, junto com o plano e o seu papel nele.
</Tip>

## Conexões sociais

As contas sociais conectadas (TikTok, Instagram, YouTube, etc.) são os IDs que você passa como `connection_id` ao criar um post. O ciclo de vida das conexões **não é exposto pela API** — para conectar uma nova conta, entre em [cut.pro](https://cut.pro) e use o fluxo de OAuth dentro do app.