# Get Agent source status

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

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

# Get Agent source status

Preview

Show the Agent’s continuous GitHub source binding and sync status.

Public APIEverruns Cloud and self-hosted Platform

GET`/v1/agents/{agent_id}/source`

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

One of:

* object

  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

* null

  null

### 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';
const options = {method: 'GET'};


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

Request

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

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