---
title: "Force a tool-catalog sync for one connected account"
method: POST
path: "/v1/admin/integrations/accounts/{account_id}/syncs"
tags: ["admin"]
---

# Force a tool-catalog sync for one connected account

`POST /v1/admin/integrations/accounts/{account_id}/syncs`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/admin/integrations/accounts/{account_id}/syncs`
- Auth: HTTP bearer

Queues a background tool-catalog sync for one connected integration account. The account's owning tenant is resolved from the account record. Answers 503 when the queue broker will not take the work, so a dropped dispatch is never reported as queued. Internal admin users only.

## Path parameters

- `account_id` string, uuid, required: Connected integration account to sync.

## Response `202`

Successful Response

- AdminAccountSyncResult: Queued tool-catalog sync for one connected integration account. ``status`` is only ever ``queued`` because the dispatch is ``critical``: a broker that refused the work raises before this model is built, so the operator gets a 503 rather than a receipt to wait on.
  - `status` string
  - `account` string, required
  - `tenant_id` string, required
  - `task_id` string, nullable: Broker task id for the queued sync, for tracing its worker logs.

## Other responses

- `401`: Unauthorized
- `403`: Permission denied (PERMISSION_DENIED) or email not verified (EMAIL_NOT_VERIFIED)
- `404`: Not found
- `409`: Conflict: admin write rejected on a state invariant. Inspect ``errors[0].type`` for the specific case (for example: ``self_action_forbidden``, ``already_disabled``, ``not_disabled``, ``last_internal_admin``, ``value_error``)
- `422`: Validation error
- `503`: Service unavailable: the task queue could not accept the sync.

---

[API](https://skmtc.dev/patricia/apis/patricia-api.md) · [All operations](https://skmtc.dev/patricia/apis/patricia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patricia/apis/patricia-api/revisions/0dfb44495ea1?raw)