---
title: "GET /api/v1/two-way-sync/{spaceId}/commits"
method: GET
path: "/api/v1/two-way-sync/{spaceId}/commits"
---

# GET /api/v1/two-way-sync/{spaceId}/commits

`GET /api/v1/two-way-sync/{spaceId}/commits`

## Request

- Base URL: `https://falconer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://falconer.com/api/v1/two-way-sync/{spaceId}/commits`
- Auth: none declared

## Path parameters

- `spaceId` integer, required: Space id, from GET /spaces.

## Query parameters

- `cursor` integer: nextCursor from the previous page.

## Headers

- `x-organization-id` string: Required when using OAuth bearer tokens.

## Response `200`

Repository commits pulled into the folder, newest first.

- TwoWaySyncCommitPage
  - `status` 'ok' | 'not_connected' | 'reconnect_required' | 'repo_unreadable', required: Commit history is read with your personal GitHub account; anything but ok means it could not be.
  - `firstSyncedAt` string, nullable, required
  - `data` TwoWaySyncCommit[], required
    - `sha` string, required
    - `shortSha` string, required
    - `url` string, required
    - `message` string, required
    - `authoredAt` string, nullable, required
    - `author` object, nullable, required
      - `name` string, nullable, required
      - `login` string, nullable, required
      - `avatarUrl` string, nullable, required
    - `pr` object, nullable, required
      - `number` integer, required
      - `title` string, required
      - `url` string, required
  - `nextCursor` integer

## Other responses

- `400`: Bad request, or a folder that is not the sync root
- `403`: Two-way sync is not enabled or permission is missing
- `404`: Folder not synced, or file not found

---

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