# Request an Agent source check

Source: <https://everruns.com/docs/api/operations/sync_agent_source/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Agents & authoring](https://everruns.com/docs/api/groups/agents-authoring/)/Request an Agent source check

# Request an Agent source check

Preview

Queue an immediate check of this Agent’s GitHub source.

Public APIEverruns Cloud and self-hosted Platform

POST`/v1/agents/{agent_id}/source/sync`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Parameters

### Path Parameters

**agent_id**

required

string

Prefixed public identifier

## Responses

200Success

### 200

Success

Media typeapplication/json

Continuous GitHub source binding, applied revision and reconciliation status.

object

**applied_commit**

Last successfully applied commit; retained when a later revision fails.

string | null

**branch**

required

Branch monitored for source updates.

string

**error**

Safe diagnostic for the latest failed check, without upstream credentials.

string | null

**generation**

required

Binding generation used to detect a concurrent reconnect or disconnect.

string format: uuid

**github_account**

required

GitHub account the source reads through: personal, organization, or agent for a binding made before sync stopped using the Agent’s identity.

string

**last_checked_at**

UTC time when the source was last checked.

string | null format: date-time

**last_synced_at**

UTC time when a source revision was last applied successfully.

string | null format: date-time

**local_dirty**

required

Local edits are waiting for GitHub synchronization.

boolean

**managed_channels**

required

Package channel names whose configuration is managed by the source.

Array\<string>

**mode**

required

Direction of synchronization: pull or two_way.

string

**path**

required

Repository-relative package folder or manifest; empty means the root.

string

**repository**

required

Selected GitHub repository in owner/name form.

string

**status**

required

Current reconciliation state, including conflict when both sides changed.

string

### Example

```json
{
  "applied_commit": "0123456789abcdef0123456789abcdef01234567",
  "branch": "main",
  "error": "Source package validation failed: missing capability",
  "generation": "018f30c8-c970-7cb5-a8c9-9348aa71ba8c",
  "github_account": "organization",
  "last_checked_at": "2026-10-23T12:00:00Z",
  "last_synced_at": "2026-10-23T12:00:00Z",
  "local_dirty": false,
  "managed_channels": [
    "chat"
  ],
  "mode": "two_way",
  "path": "agents/support",
  "repository": "acme/agents",
  "status": "synced"
}
```

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/agents/example/source/sync';
const options = {method: 'POST'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request POST \
  --url https://app.everruns.com/api/v1/agents/example/source/sync
```

Additional language examples require JavaScript. The default request example is available above.

200

200 · Success

```json
{
  "applied_commit": "0123456789abcdef0123456789abcdef01234567",
  "branch": "main",
  "error": "Source package validation failed: missing capability",
  "generation": "018f30c8-c970-7cb5-a8c9-9348aa71ba8c",
  "github_account": "organization",
  "last_checked_at": "2026-10-23T12:00:00Z",
  "last_synced_at": "2026-10-23T12:00:00Z",
  "local_dirty": false,
  "managed_channels": [
    "chat"
  ],
  "mode": "two_way",
  "path": "agents/support",
  "repository": "acme/agents",
  "status": "synced"
}
```

## Matching endpoints