Conta
Operações do workspace (agente/API)
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
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"
}'Corpo da requisição
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Operação do workspace (ex: capabilities, icps.list, dashboard.read, lists.create, jobs.preview)
Exemplo de retorno
{
"contractVersion": 1,
"result": {}
}{
"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
}
}Respostas e códigos
Response Body
application/json
application/json
application/json
application/json