Check a source's status

llm prompts Build the sources screen Reconcile my records

This endpoint lists every source one customer has connected, and what each one is doing right now. It is also how you discover connections you have no uid stored for. That happens after a connection_type.revoked, or when you are reconciling a partial signup.

GET /api/v1/api_accounts/:uid/connections/:connection_uid returns the same shape for one row. An unknown connection uid, or one belonging to another customer, is a 404.

Response fields

idinteger

Context Link's own id for the connection.

uidstring

The uid you chose when you connected it. The website connection is the exception: it is created from site_url when you provision the account, so its uid is always site.

connection_typestring

The type, in the same form you sent it.

namestring

The type's display name. Never partner-supplied.

statusstring

The three-value summary: redirect_required, pending or connected.

auth_statusstring

pending_auth, authorised, auth_failed or disconnected.

sync_statusstring

unsynced, syncing, synced or error_syncing. A source that has not yet attempted a fetch is unsynced, never null.

post_countinteger

Documents currently indexed from this source.

post_request_limitinteger

The ceiling on documents fetched per sync for this connection: 500 for most types, 30 for YouTube, 50 for Web Mentions. Always a number on a fleet connection, and lower than the default if we have turned this one down for you.

last_synced_attimestamp

When it last finished a sync, null if it never has.

The customer's memory connection is deliberately not listed. It holds what your product pushed, rather than a source the customer connected.

Reading the two statuses together

auth_status answers "can we still reach the source". sync_status answers "how did the last fetch go". They move independently, so a support screen should show both.

Combination	What has happened
`pending_auth` + `null`	Waiting on the customer at the provider's consent screen.
`authorised` + `syncing`	Connected, first or subsequent fetch in flight.
`authorised` + `synced`	Healthy.
`authorised` + `error_syncing`	The source itself failed: an API outage, a removed folder. It retries on the next scheduled sync.
`auth_failed` + anything	The grant died. Content is kept; the customer must re-authorise.

Polling is the fallback, not the plan. The connection.authorised and connection.auth_failed webhooks fire the moment either happens, and the per-organisation rate limit is shared across your entire fleet.

curl "https://context-link.ai/api/v1/api_accounts/tf-cust-8841/connections" \
  -H "Authorization: Bearer $PROVISIONING_TOKEN"

require "net/http"

uri = URI("https://context-link.ai/api/v1/api_accounts/tf-cust-8841/connections")

request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("PROVISIONING_TOKEN")}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

import os
import requests

url = "https://context-link.ai/api/v1/api_accounts/tf-cust-8841/connections"

headers = {
    "Authorization": f"Bearer {os.environ['PROVISIONING_TOKEN']}",
}

response = requests.get(url, headers=headers, timeout=30)
print(response.text)

// Runs on your server only: the token must never reach the browser.
const url = new URL("https://context-link.ai/api/v1/api_accounts/tf-cust-8841/connections");

const response = await fetch(url, {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${process.env.PROVISIONING_TOKEN}`,
  },
});

console.log(await response.text());

// Runs on your server only: the token must never reach the browser.
async function main() {
  const url = new URL("https://context-link.ai/api/v1/api_accounts/tf-cust-8841/connections");

  const response = await fetch(url, {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.PROVISIONING_TOKEN}`,
    },
  });

  console.log(await response.text());
}

main();

Response

{
  "connections": [
    {
      "id": 9012,
      "uid": "acme-yt-main",
      "connection_type": "youtube",
      "name": "Youtube",
      "status": "connected",
      "auth_status": "authorised",
      "sync_status": "synced",
      "post_count": 214,
      "last_synced_at": "2026-09-12T11:42:07Z"
    },
    {
      "id": 9013,
      "uid": "acme-gdrive",
      "connection_type": "google_doc",
      "name": "GoogleDoc",
      "status": "redirect_required",
      "auth_status": "auth_failed",
      "sync_status": "error_syncing",
      "post_count": 1893,
      "last_synced_at": "2026-09-01T09:03:44Z"
    }
  ]
}

← Back to Docs Raw markdown guide for AI