---
title: "Sync Convenios"
method: POST
path: "/v1/banking/bank_accounts/{bank_account_id}/convenios/sync"
tags: ["Convenio"]
---

# Sync Convenios

`POST /v1/banking/bank_accounts/{bank_account_id}/convenios/sync`

## Request

- Base URL: `https://api.cardda.com`
- URL: `https://api.cardda.com/v1/banking/bank_accounts/{bank_account_id}/convenios/sync`
- Auth: HTTP bearer

Triggers an asynchronous job that re-fetches the account's convenios from the
bank. Returns immediately once the job is enqueued.

Requires a `bank_key_id` selecting the approved bank key (crawler credential)
whose manager links to this account. Available to members of the account's
company.

## Path parameters

- `bank_account_id` string, required

## Parameters

- `#/paths/~1v1~1banking~1bank_keys/get/parameters/0` (unresolved $ref)

## Request body

- object
  - `bank_key_id` string, uuid, required: UUID of the approved bank key whose manager links to this account.

## Response `200`

The sync job was enqueued.

- object
  - `message` string

## Other responses

- `401`: Unauthorized — the bank key could not be resolved for your user.
- `404`: The bank account or an approved bank key was not found.
- `422`: No manager links the given bank key to this bank account.

---

[API](https://skmtc.dev/cardda/apis/banking-api.md) - [All operations](https://skmtc.dev/cardda/apis/banking-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cardda/apis/banking-api/revisions/ff1aeb3fda8b?raw)