Integrations

Sync an integration

Ask Ollive to read the agents on a platform now.

POSThttps://api.ollive.ai/api/integrations/sync/v1

How it works

The call returns once Ollive has finished reading, with an updated last_synced_at. Then use List assets to see what was found.

If the platform can’t be reached, you get a 502 and nothing changes.

Authorization

Authorizationheaderrequired
Your API key, after the word Bearer, like this: Bearer sk-…. Create a key.

Request body

application/json

idstring (uuid)required
The integration’s ID.

Response

The integration, freshly synced.

idstring (uuid)required
The integration’s ID.
typestringrequired
The platform type, such as RETELL.
kindstringrequired
What kind of platform it is.
agent_platformagent_observabilityalert_and_workflow
namestringrequired
The name you gave it.
keysobject[]required
The keys saved on this integration. Secret values are never shown, only whether they are set.
- namestringrequired
  The key’s name.
- is_secretbooleanrequired
  Whether the value is secret.
- is_setbooleanrequired
  Whether a value is saved.
- valuestringrequired
  The saved value. Always empty for secret keys.
created_atstring (date-time)required
When it was connected.
updated_atstring (date-time)required
When it was last changed.
last_synced_atstring (date-time)
When Ollive last read the agents on this platform. Missing until the first read.

← Test an integration List assets →

curl -X POST "https://api.ollive.ai/api/integrations/sync/v1" \  -H "Authorization: Bearer $OLLIVE_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "id": "8f14e45f-ceea-4b2a-9c1e-2a6f0e3d7b51"  }'

Response

{  "id": "8f14e45f-ceea-4b2a-9c1e-2a6f0e3d7b51",  "type": "RETELL",  "kind": "agent_platform",  "name": "Retell production",  "keys": [    {      "name": "api_key",      "is_secret": true,      "is_set": true,      "value": ""    }  ],  "created_at": "2026-10-02T14:21:07Z",  "updated_at": "2026-10-02T14:21:07Z",  "last_synced_at": "2026-10-14T09:31:02Z"}

{  "error": {    "code": "assets_not_supported",    "message": "ELEVENLABS integrations have no assets to sync.",    "param": "id",    "request_id": "4b1f0c9e2d7a48b6a3e5f19c0d8b7a26"  }}

{  "error": {    "code": "authentication_failed",    "message": "Invalid API key.",    "param": "",    "request_id": "4b1f0c9e2d7a48b6a3e5f19c0d8b7a26"  }}

{  "error": {    "code": "not_found",    "message": "Integration not found.",    "param": "",    "request_id": "4b1f0c9e2d7a48b6a3e5f19c0d8b7a26"  }}

{  "error": {    "code": "provider_error",    "message": "The provider could not be read. Check the keys with POST /api/integrations/test/v1, then try again.",    "param": "",    "request_id": "4b1f0c9e2d7a48b6a3e5f19c0d8b7a26"  }}