> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mesa.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# mesa.repos.getUpstreamSync()

> Get one sync for a repository upstream remote.

Fetch a sync by id through the repository's upstream.

```ts theme={null}
const run = await mesa.repos.getUpstreamSync({ repo: 'app', syncId: 'sync_...' });
console.log(run.id, run.status);
```

## Options

<ParamField path="repo" type="string" required>
  Repository name.
</ParamField>

<ParamField path="syncId" type="string" required>
  Sync ID.
</ParamField>

<ParamField path="org" type="string | undefined">
  Organization override.
</ParamField>

## Response

Returns a sync object with fields such as `id`, `repo_id`, `direction`, `status`, `attempt`, `stats`, `error`, `created_at`, `started_at`, and `finished_at`.

## Required scope

`read`