# pipelines.stage_cards Cards de uma etapa, com paginação (visão em lista). Oportunidades de uma etapa na ordem do quadro, filtradas pelo `query` (busca, status, atendente, coorte). `page` a partir de 1; `perPage` até 200 (padrão 50). `meta.countItens` é o total da etapa com o filtro, `valueCents` a soma, `countPages` as páginas. Cada card traz as tags do contato e a próxima tarefa aberta. - Endpoint: `POST https://app.atomiks.com.br/api/v1/pipelines.stage_cards` (corpo JSON) - Quem pode chamar: membro da conta - Escopo da chave: `crm:read` - Grava dados: não - Pela chave de API: sim - Ferramenta MCP: `pipelines_stage_cards` - Ficha em JSON: `https://app.atomiks.com.br/api/v1/openapi.json` (operationId `pipelines.stage_cards`) ## Entrada | Campo | Tipo | Obrigatório | Nota | |---|---|---|---| | `pipelineId` | string (uuid) | sim | | | `stageId` | string (uuid) | sim | | | `query` | object | não | | | `page` | integer | não | | | `perPage` | integer | não | |
JSON Schema ```json { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "pipelineId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "stageId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "query": { "type": "object", "properties": { "q": { "type": "string", "maxLength": 120 }, "attendantId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "attendantIds": { "maxItems": 200, "type": "array", "items": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "cohort": { "type": "string", "maxLength": 64 }, "status": { "type": "string", "enum": [ "open", "won", "lost", "all" ] }, "filter": { "maxItems": 30, "type": "array", "items": { "type": "object", "properties": { "matcher": { "type": "string", "enum": [ "all", "any" ] }, "connector": { "type": "string", "enum": [ "and", "or" ] }, "conditions": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string", "maxLength": 60 }, "operator": { "type": "string", "maxLength": 30 }, "value": { "anyOf": [ { "anyOf": [ { "type": "string", "maxLength": 4000 }, { "maxItems": 500, "type": "array", "items": { "type": "string", "maxLength": 200 } }, { "type": "number" }, { "type": "boolean" } ] }, { "type": "null" } ] }, "lead": { "maxItems": 200, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "maxLength": 64 }, "order": { "type": "integer", "minimum": 0, "maximum": 1000 }, "field": { "type": "string", "maxLength": 60 }, "operator": { "type": "string", "maxLength": 30 }, "negation": { "default": false, "type": "boolean" }, "parentId": { "anyOf": [ { "type": "string", "maxLength": 64 }, { "type": "null" } ] }, "valueString": { "anyOf": [ { "type": "string", "maxLength": 4000 }, { "type": "null" } ] }, "valueNumber": { "type": [ "number", "null" ] }, "valueDate": { "anyOf": [ { "type": "string", "maxLength": 40 }, { "type": "null" } ] }, "valueBool": { "type": [ "boolean", "null" ] }, "valueUuid": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ] } }, "required": [ "field", "operator" ], "additionalProperties": false } } }, "required": [ "field", "operator" ] } } }, "required": [ "matcher", "connector", "conditions" ] } }, "priorities": { "maxItems": 4, "type": "array", "items": { "type": "string", "enum": [ "low", "normal", "high", "urgent" ] } }, "origins": { "maxItems": 100, "type": "array", "items": { "type": "string", "maxLength": 120 } }, "tagIds": { "maxItems": 100, "type": "array", "items": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "productIds": { "maxItems": 100, "type": "array", "items": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "companyIds": { "maxItems": 100, "type": "array", "items": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "contactIds": { "maxItems": 500, "type": "array", "items": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "valueMinCents": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "valueMaxCents": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expectedClosingDateFrom": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "expectedClosingDateTo": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "cardOrder": { "type": "string", "enum": [ "manual", "createdAtDesc", "createdAtAsc", "stageTimeAsc", "stageTimeDesc" ] } } }, "page": { "type": "integer", "minimum": 1, "maximum": 10000 }, "perPage": { "type": "integer", "minimum": 1, "maximum": 200 } }, "required": [ "pipelineId", "stageId" ] } ```
## Exemplo ```bash curl -X POST https://app.atomiks.com.br/api/v1/pipelines.stage_cards \ -H "Authorization: Bearer $ATOMIKS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"pipelineId":"00000000-0000-0000-0000-000000000000","stageId":"00000000-0000-0000-0000-000000000000"}' ``` CLI: ```bash node cli/atomiks.mjs pipelines.stage_cards --json '{"pipelineId":"00000000-0000-0000-0000-000000000000","stageId":"00000000-0000-0000-0000-000000000000"}' ``` MCP: ferramenta `pipelines_stage_cards` com a mesma entrada. ## Saída Sucesso: `{"data": ...}` com o formato abaixo. ```json { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "pipelineId": { "type": "string" }, "stageId": { "type": "string" }, "status": { "type": "string", "enum": [ "open", "won", "lost" ] }, "title": { "type": "string" }, "valueCents": { "type": [ "number", "null" ] }, "product": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name" ], "additionalProperties": false }, { "type": "null" } ] }, "contact": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": [ "string", "null" ] }, "phone": { "type": [ "string", "null" ] } }, "required": [ "id", "name", "phone" ], "additionalProperties": false }, "owner": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": [ "string", "null" ] } }, "required": [ "id", "name" ], "additionalProperties": false }, { "type": "null" } ] }, "openTasks": { "type": "number" }, "updatedAt": { "type": "string" }, "priority": { "anyOf": [ { "type": "string", "enum": [ "low", "normal", "high", "urgent" ] }, { "type": "null" } ] }, "expectedCloseDate": { "type": [ "string", "null" ] }, "probability": { "type": [ "number", "null" ] }, "origin": { "type": [ "string", "null" ] }, "lostReason": { "type": [ "string", "null" ] }, "company": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name" ], "additionalProperties": false }, { "type": "null" } ] }, "createdAt": { "type": [ "string", "null" ] }, "wonAt": { "type": [ "string", "null" ] }, "lostAt": { "type": [ "string", "null" ] }, "tags": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "color": { "type": "string" } }, "required": [ "id", "name", "color" ], "additionalProperties": false } }, "nextTask": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "dueAt": { "type": [ "string", "null" ] }, "kind": { "type": "string" }, "assignee": { "type": [ "string", "null" ] } }, "required": [ "id", "title", "dueAt", "kind", "assignee" ], "additionalProperties": false }, { "type": "null" } ] } }, "required": [ "id", "pipelineId", "stageId", "status", "title", "valueCents", "product", "contact", "owner", "openTasks", "updatedAt", "priority", "expectedCloseDate", "probability", "origin", "lostReason", "company", "createdAt", "wonAt", "lostAt", "tags", "nextTask" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "countItens": { "type": "number" }, "countPages": { "type": "number" }, "valueCents": { "type": "number" } }, "required": [ "countItens", "countPages", "valueCents" ], "additionalProperties": false } }, "required": [ "items", "meta" ], "additionalProperties": false } ``` ## Erros `{"error": {"code", "message", "requestId"}}`. Códigos: `invalid_input` (400), `unauthorized` (401), `forbidden` / `account_pending` / `scope_missing` (403), `not_found` (404), `limit_reached` (409), `internal` (500).