---
title: "Refresh from office"
method: PATCH
path: "/filings/{id}/refresh_from_office"
tags: ["Filings"]
---

# Refresh from office

`PATCH /filings/{id}/refresh_from_office`

## Request

- Base URL: `https://api.markmesh.com/v1`
- URL: `https://api.markmesh.com/v1/filings/{id}/refresh_from_office`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Trigger an asynchronous refresh of this filing against the
trademark office's API. Returns immediately after enqueueing
the sync job; the filing's data fields are updated in the
background once the office responds.

Caller-safe: no input is accepted. Internally enqueues
`FilingSyncWorker` which fetches fresh data from the office
adapter and applies it via the system-only `:sync_from_office`
action.

This is the public-API counterpart to `:sync_from_office` —
the latter accepts raw office data and is for internal
workers only.

## Path parameters

- `id` string, uuid, required

## Response `200`

Success

## Other responses

- `401`: API key or session credential missing, invalid, expired, or revoked
- `404`: Resource not found, or not visible to this actor
- `422`: Validation error — field-level detail in the response body

---

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