Read YouTube connection status

GET/sites/{site_id}/youtube/connectionyoutube:read

Requires youtube:read and an explicit site grant. Uses the same canonical normalized-data reader as the dashboard. Reads never contact Google, refresh tokens, queue collection, or deduct Satellite credits. No provider credentials are exposed. An authorized site with no YouTube connection returns status=not_connected. A company administrator connects/selects the channel in /youtube/.

RequestGET https://satelliteai.io/api/v1/sites/{site_id}/youtube/connection
Permissionyoutube:read
ResponseA single object: data is YouTubeConnection.
Operation IDgetYouTubeConnection

More context and worked examples are in the developer guide.

Example request

cURL · Bash
curl --fail-with-body \
  'https://satelliteai.io/api/v1/sites/123/youtube/connection' \
  -H "Authorization: Bearer $SATELLITE_API_KEY"

Replace the example IDs with values returned by the discovery endpoints. Example values are placeholders, not real records.

Parameters

NameInTypeDescription
site_idrequiredpathinteger

Unknown or repeated query parameters return 400.

Data dictionary

Connection state, including status=not_connected for an authorized site without a grant.

[] marks an array element. nullable means the value can be null; treat it as unknown, not zero. always present means the key is always included in the object.

Fields in data
FieldTypeDescription
data.site_idintegerSatellite site ID (from GET /sites).
data.statusstring
one of: not_connected, connected_unselected, active, needs_reauth, revoking, disconnected
data.channel_idstringnullable
data.last_synced_atstringnullableUTC timestamp of last completed publication, ISO8601 without timezone suffix.

Response metadata

Fields in meta
FieldTypeDescription
meta.sourcestring
one of: stored
meta.request_idstringRequest identifier; also returned in X-Request-ID. Include it in support requests.
meta.api_versionstringAPI version that produced the response.
one of: v1

Error responses

Errors return {"error": {"code", "message", "request_id"}}. See error handling for retry guidance.

HTTPWhen
400Invalid dates or unsupported source
403Missing youtube:read, disabled integration, or company API access disabled.
404Site not found or not granted
401Missing, invalid, expired or revoked Bearer API key.
429Rate limit reached; respect Retry-After.