> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Atualizar um binding de origem > Atualiza campos de um binding de origem por ID. O rail (kind) é imutável. ## OpenAPI ````yaml pt/openapi/v3-current/matcher.yaml patch /v1/contexts/{contextId}/sources/{sourceId}/bindings/{bindingId} openapi: 3.1.0 info: title: Matcher APIs description: >- Referência completa de API para o motor de conciliação Matcher, que fornece conciliação automática de transações entre o Midaz Ledger e sistemas externos. version: 4.1.0 license: name: Elastic License 2.0 url: https://www.elastic.co/licensing/elastic-license servers: - url: https://matcher.sandbox.lerian.net security: [] paths: /v1/contexts/{contextId}/sources/{sourceId}/bindings/{bindingId}: patch: tags: - Configuration summary: Atualizar um binding de origem description: >- Atualiza campos de um binding de origem por ID. O rail (kind) é imutável. operationId: updateSourceBinding parameters: - description: Context ID in: path name: contextId required: true schema: description: ID do contexto format: uuid type: string - description: Source ID in: path name: sourceId required: true schema: description: ID da origem format: uuid type: string - description: Binding ID in: path name: bindingId required: true schema: description: ID do binding format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateSourceBindingRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/SourceBindingResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Erro security: - BearerAuth: [] components: schemas: UpdateSourceBindingRequest: additionalProperties: false properties: connectionId: description: >- Referência de conexão do engine de query-rail (UUID). Aplica-se apenas a bindings de query-rail. examples: - 550e8400-e29b-41d4-a716-446655440000 format: uuid type: string enabled: description: Se o binding é executado. examples: - false type: boolean format: description: >- Formato declarado que o binding produz, como uma chave descritora com namespace de região/família. O rail (kind) é imutável na atualização. examples: - br/cnab400/default maxLength: 255 type: string scheduleSpec: description: >- Especificação de agendamento por intervalo que o scheduler do binding lê (cron ou duração @every). examples: - '@every 30m' maxLength: 100 type: string transportConfig: $ref: '#/components/schemas/SourceBindingTransportConfigRequest' description: >- Configuração de transporte do file-rail. Aplica-se apenas a bindings de file-rail. type: object SourceBindingResponse: additionalProperties: false properties: connectionId: description: >- Referência de conexão do engine de query-rail (UUID). Omitida para bindings de file-rail. examples: - 550e8400-e29b-41d4-a716-446655440000 type: string contextId: description: Identificador do contexto ao qual este binding pertence. examples: - 550e8400-e29b-41d4-a716-446655440000 type: string createdAt: description: Timestamp de criação no formato RFC 3339. examples: - '2025-01-15T10:30:00Z' type: string enabled: description: Se o binding é executado. examples: - true type: boolean format: description: >- Formato declarado que o binding produz, como uma chave descritora com namespace de região/família. examples: - br/cnab400/default type: string id: description: Identificador único do binding. examples: - 550e8400-e29b-41d4-a716-446655440000 type: string kind: description: >- Rail no qual a origem é puxada. file obtém arquivos via um transporte; query puxa linhas por uma conexão de discovery-engine. enum: - file - query examples: - file type: string scheduleSpec: description: >- Especificação de agendamento por intervalo que o scheduler do binding lê (cron ou duração @every). examples: - '@every 1h' type: string sourceId: description: Identificador da origem à qual este binding pertence. examples: - 550e8400-e29b-41d4-a716-446655440000 type: string transportConfig: $ref: '#/components/schemas/SourceBindingTransportConfigResponse' description: >- Configuração de transporte do file-rail. Omitida para bindings de query-rail. updatedAt: description: Timestamp da última atualização no formato RFC 3339. examples: - '2025-01-15T10:30:00Z' type: string required: - id - contextId - sourceId - kind - format - scheduleSpec - enabled - createdAt - updatedAt type: object Detail: additionalProperties: false properties: code: description: >- Código de erro de domínio estável e legível por máquina com escopo no serviço emissor (formato: -NNNN). examples: - ERR-0001 type: string detail: description: >- Uma explicação legível por humanos específica para esta ocorrência do problema. examples: - Property foo is required but is missing. type: string errors: description: Lista opcional de detalhes de erro individuais items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- Uma referência URI que identifica a ocorrência específica do problema. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: Código de status HTTP examples: - 400 format: int64 type: integer title: description: >- Um resumo curto e legível por humanos do tipo do problema. Este valor não deve mudar entre ocorrências do erro. examples: - Bad Request type: string type: default: about:blank description: >- Uma referência URI para documentação legível por humanos sobre o erro. examples: - https://example.com/errors/example format: uri type: string type: object SourceBindingTransportConfigRequest: additionalProperties: false properties: connectOptions: additionalProperties: type: string description: >- Opções de ajuste de transporte não secretas (específicas do adaptador). type: object credentialRef: description: >- Referência a uma credencial armazenada resolvida no momento da busca. Esta é uma referência, nunca o material secreto em si. examples: - cred-bank-sftp maxLength: 255 type: string glob: description: Filtro glob opcional aplicado dentro do caminho. examples: - '*.csv' maxLength: 255 type: string host: description: Hostname ou IP do endpoint remoto. examples: - sftp.bank.example.com maxLength: 255 type: string kind: description: >- Tipo de adaptador de transporte. sftp puxa por SFTP; https por HTTP(S); s3 de um bucket S3; imap de uma caixa de e-mail. enum: - sftp - https - s3 - imap examples: - sftp type: string path: description: Diretório remoto para listar e obter. examples: - /statements maxLength: 1024 type: string port: description: Porta do endpoint remoto. examples: - 22 format: int64 maximum: 65535 minimum: 1 type: integer required: - kind - host type: object SourceBindingTransportConfigResponse: additionalProperties: false properties: connectOptions: additionalProperties: type: string description: >- Opções de ajuste de transporte não secretas (específicas do adaptador). type: object credentialRef: description: >- Referência a uma credencial armazenada resolvida no momento da busca. Esta é uma referência, nunca o material secreto em si. examples: - cred-bank-sftp type: string glob: description: Filtro glob opcional aplicado dentro do caminho. examples: - '*.csv' type: string host: description: Hostname ou IP do endpoint remoto. examples: - sftp.bank.example.com type: string kind: description: >- Tipo de adaptador de transporte. sftp puxa por SFTP; https por HTTP(S); s3 de um bucket S3; imap de uma caixa de e-mail. enum: - sftp - https - s3 - imap examples: - sftp type: string path: description: Diretório remoto para listar e obter. examples: - /statements type: string port: description: Porta do endpoint remoto. examples: - 22 format: int64 type: integer required: - kind - host type: object ErrorDetail: additionalProperties: false properties: location: description: 'Onde o erro ocorreu, ex.: ''body.items[3].tags'' ou ''path.thing-id''' type: string message: description: Texto da mensagem de erro type: string value: description: O valor na localização informada type: object securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'Autenticação por Bearer token (formato: "Bearer {token}")' ````