title: Trigger Connector Sync
keywords:

- trigger connector sync
- post
- trigger
- connector
- sync


# Trigger Connector Sync

Trigger connector tool catalog sync.

#### Query Parameters

**`force_full_sync`** boolean optional · Defaults to `false`

Force full sync, ignoring incremental checks and interval

## Returns

**`job_id`** string

Job Id

**`status`** string

Status

**`tools_synced`** integer

Tools Synced

**`tools_created`** integer

Tools Created

**`tools_updated`** integer

Tools Updated

**`tools_unchanged`** integer

Tools Unchanged

**`sync_mode`** string

Sync Mode

**`message`** string or null

Message

Example

```bash cURL
curl -X POST "https://api.aitronos.com/v1/admin/composio/sync" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.post(
    "https://api.aitronos.com/v1/admin/composio/sync",
    headers={"X-API-Key": api_key}
)

print(response.json())
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;

const response = await fetch('https://api.aitronos.com/v1/admin/composio/sync', {
  method: 'POST',
  headers: {
    'X-API-Key': apiKey
  }
});

const data = await response.json();
console.log(data);
```

**Response:**


```json 200 OK
{
  "job_id": "job_abc123def456",
  "status": "active",
  "tools_synced": 15,
  "tools_created": 15,
  "tools_updated": 15,
  "tools_unchanged": 0,
  "sync_mode": "full",
  "message": "Operation completed successfully"
}
```

Errors

```json 401 Unauthorized
{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "Authentication required. Please provide a valid API key.",
    "system_message": "Missing or invalid authorization header",
    "type": "authentication_error",
    "status": 401,
    "trace_id": "req_abc123xyz",
    "timestamp": "2025-11-11T10:30:00Z",
    "details": {}
  }
}
```


```json 403 Forbidden
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_PERMISSIONS",
    "message": "You do not have permission to access this resource.",
    "system_message": "Insufficient permissions for this operation",
    "type": "authorization_error",
    "status": 403,
    "trace_id": "req_def456uvw",
    "timestamp": "2025-11-11T10:30:00Z",
    "details": {}
  }
}
```

## Related Resources

- [Get Sync Status](/docs/api-reference/admin/get-sync-status)
- [List Auth Configs](/docs/api-reference/admin/list-auth-configs)
- [Update Tool Status](/docs/api-reference/admin/update-tool-status)