Caderninho / guias
Assistentes e ferramentasFerramentas MCPTransações e compras

move_transactions

Mover projeções de transações para outro espaço da mesma instalação.

Transações e compras · Mover · Escrita local

Efeito da chamada

Esta ferramenta altera dados locais da instalação. Confirme a ação e o espaço com o proprietário antes de enviar confirmed: true e uma chave de idempotência. Ela não altera registros nem executa pagamentos no banco.

Parâmetros

CampoObrigatórioTipoUso
confirmedSimtrueDeve ser true somente depois da confirmação explícita do proprietário.
idempotency_keySimtextoChave única para esta solicitação. Reutilize apenas para repetir exatamente a mesma operação.
spaceIdSimtextoEspaço da instalação. Consulte get_spaces; o espaço inicial é personal.
idsSimlista de textoIDs de transações devolvidos por get_transactions. Confira a seleção antes de confirmar a escrita. Até 500 itens.
targetSpaceIdSimtextoID de outro espaço existente na mesma instalação, obtido em get_spaces. Substitua familia pelo ID do destino desejado.

Filtros compostos e limites estão no schema completo. Campos não listados são recusados.

Exemplo de chamada

Substitua os IDs fictícios pelos da sua instalação, obtidos nas consultas indicadas nos parâmetros.


{
  "name": "move_transactions",
  "arguments": {
    "confirmed": true,
    "idempotency_key": "docs:move_transactions:01",
    "spaceId": "personal",
    "ids": [
      "transacao-exemplo"
    ],
    "targetSpaceId": "familia"
  }
}

Interpretar o resultado

Confira o resultado da chamada antes de dar a alteração como concluída. Se a rede falhar, repita somente os mesmos argumentos com a mesma chave. Atualize a leitura se a revisão estiver obsoleta antes de confirmar outra operação.

O registro desta ferramenta não declara outputSchema. Consulte as regras de resposta no guia de contratos.

Contrato completo

Ver JSON Schema de entrada

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "confirmed": {
      "type": "boolean",
      "const": true
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160
    },
    "spaceId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160
    },
    "ids": {
      "minItems": 1,
      "maxItems": 500,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 160
      }
    },
    "targetSpaceId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160
    }
  },
  "required": [
    "confirmed",
    "idempotency_key",
    "spaceId",
    "ids",
    "targetSpaceId"
  ],
  "additionalProperties": false
}

Voltar para Transações e compras · Confirmações e contratos

Nesta página