Conta

Operações do workspace (agente/API)

POSTgratuito
Cobrança: gratuita, não consome créditos. Fonte: tabela de operações da API TAMZ, 12/11/2026.

Entrypoint multiplex das operações do workspace por API key: capabilities, ICPs, dashboard, listas, jobs, memória e exports — o mesmo contrato de executeWorkspaceOperation da web e do MCP. O entrypoint não tem preço próprio: cada operation cobra a sua chave (ver Configurações → Planos). Autentica por API key com escopo workspace.

Membros de lista (grátis): lists.items.add / lists.items.remove com input: { list_id, company_ids?, person_ids? } (até 500 ids); lists.items.add_from_list põe na lista list_id todos os membros ativos da lista source_list_id, e lists.items.remove_from_list tira de list_id quem está em source_list_id — input: { list_id, source_list_id }, as duas listas do workspace (senão 404), do mesmo tipo (senão 422), até 10.000 membros na origem; lista dinâmica de origem sem membros gravados devolve 422 (materialize antes). Resposta: count_before, count_after, added, removed.

Rate limit: 20 req/min

01

Testar ao vivo

Autorização

Sua API key, gerada em /developer/api-keys. Gratuita para começar.

Sua requisição

curl -X POST 'https://tamz.ai/api/v1/workspace' \
  -H 'Authorization: Bearer tamz_SUA_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "operation": "capabilities"
}'
02

Corpo da requisição

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

operation*string

Operação do workspace (ex: capabilities, icps.list, dashboard.read, lists.create, jobs.preview)

03

Exemplo de retorno

{
  "contractVersion": 1,
  "result": {}
}
Empty
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing API key. Use Authorization: Bearer tamz_xxx or X-API-Key header"
  }
}
{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits",
    "required": 10,
    "available": 3,
    "upgrade_path": "/settings/plans",
    "next_action": "Top up credits and retry — zero-result searches are never charged."
  }
}
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded",
    "retry_after": 42
  }
}
04

Respostas e códigos

Response Body

application/json

application/json

application/json

application/json

Começar grátis