Usuarios

---
name: tray-usuarios
description: >
  API de Usuários da Tray. Utilize quando o desenvolvedor precisar
  listar os usuários administrativos da loja. API somente leitura.
when_to_use: >
  Use quando o desenvolvedor mencionar: usuário administrativo, usuário da loja,
  GET /users, listar usuários, administrador da Tray ou user_id da loja.
when_not_to_use: >
  Não use para clientes da loja (use tray-clientes) nem para parceiros (use
  tray-parceiros). API somente leitura para listar usuários administrativos.
---

## MANDATORY: Tool Call(s) Required Before Answering

- **OBRIGATÓRIO:** `node skills/tray-dev/scripts/search_docs.mjs "<termo>"` — confirme o comportamento da API antes de gerar código.

## Antes de responder

> Execute estas verificações antes de gerar qualquer payload ou código:

1. Confirme o método HTTP e endpoint correto para a operação solicitada.
2. Identifique os campos obrigatórios listados neste documento — não omita nenhum.
3. Verifique que `access_token` não aparece como literal string no código gerado.
4. Confirme que esta é a skill correta para o recurso (leia `when_not_to_use` no frontmatter).

# API de Usuários — Tray

Documentação oficial: https://developers.tray.com.br/#apis-de-usuario

## Endpoints

| Método | Endpoint | Descrição |
|:--|:--|:--|
| GET | `/users` | Listagem de usuários administrativos da loja |

**Autenticação:** `?access_token={token}`

**Somente leitura** — esta API não permite criação, atualização ou exclusão de usuários.

## Uso

Permite consultar os usuários com acesso administrativo à loja Tray. Útil para identificar responsáveis e configurar permissões na sua integração.

## Como Usar no Claude Code

### Exemplos de Prompt

- "lista os usuários administrativos da loja"
- "quais usuários têm acesso ao painel da loja?"

### O que o Claude faz

1. Gera o código para `GET /users?access_token={token}`
2. Itera pelos usuários retornados para exibição ou auditoria

### O que você recebe

- Código de listagem de usuários administrativos
- Nota de que a API é somente leitura (sem criação/atualização/exclusão)

### Pré-requisitos

- `access_token` configurado