CLIENT API / V1 CONTENT, BRIEFS & CAMPAIGNS

Read campaign strategies, briefs, intake, assets or linked claim snapshots

GET/sites/{site_id}/content-campaigns/{campaign_id}/{section}/{record_id}campaigns:read

OVERVIEW

Read campaign strategies, briefs, intake, assets or linked claim snapshots. Only explicitly granted sites and permissions are accessible. No credentials or raw worker payloads are returned. Lists omit large bodies; detail calls return stored payloads with bounded exports. Parent/child ownership is checked before artifact retrieval. GET never generates, revises, reviews or publishes content.

Request	`GET https://satelliteai.io/api/v1/sites/{site_id}/content-campaigns/{campaign_id}/{section}/{record_id}`
Permission	`campaigns:read`
Response	A single object: `data` is `CampaignSection`.
Operation ID	`getContentCampaignRecord`

More context and worked examples are in the developer guide.

REQUEST

Example request

cURL · Bash

curl --fail-with-body \
  'https://satelliteai.io/api/v1/sites/123/content-campaigns/123456789/strategies/123' \
  -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

Name	In	Type	Description
`site_id`required	path	integer	Authorized site id. Parent and site grants must also match. min 1 · max 9223372036854775807
`campaign_id`required	path	integer	Authorized campaign id. Parent and site grants must also match. min 1 · max 9223372036854775807
`section`required	path	string	Authorized section. Parent and site grants must also match. one of: assets, strategies, claims, intakes
`record_id`required	path	integer	Authorized record id. Parent and site grants must also match. min 1 · max 9223372036854775807

Unknown or repeated query parameters return 400.

RESPONSE

Data dictionary

Scoped result. Lists return pagination metadata; unavailable records return 404. Shape selected by section: assets, strategies, intakes or claims. Claims are saved campaign snapshots, not the company claim library.

[] 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
Field	Type	Description
`data.id`	integernullable	Id.
`data.site_id`	integernullable	Site id.
`data.campaign_id`	integernullable	Campaign id.
`data.name`	stringnullable	Name.
`data.description`	stringnullable	Description.
`data.asset_type`	stringnullable	Asset type.
`data.status`	stringnullable	Status.
`data.position`	integernullable	Position.
`data.site_content_id`	integernullable	Site content id.
`data.job_id`	stringnullable	Job id.
`data.strategy_version`	integernullable	Strategy version.
`data.word_count_target`	integernullable	Word count target.
`data.target_user_site_id`	integernullable	Target user site id.
`data.destination_label`	stringnullable	Destination label.
`data.publish_at`	stringnullable	Publish at. Stored UTC ISO 8601 timestamp; legacy values may omit a timezone suffix.
`data.published_at`	stringnullable	Published at. Stored UTC ISO 8601 timestamp; legacy values may omit a timezone suffix.
`data.created_at`	stringnullable	Created at. Stored UTC ISO 8601 timestamp; legacy values may omit a timezone suffix.
`data.updated_at`	stringnullable	Updated at. Stored UTC ISO 8601 timestamp; legacy values may omit a timezone suffix.
`data.truncated_fields`	array of string	Scalar text fields truncated at 200000 characters. Empty when no scalar was truncated.
`data.id`	integernullable	Id.
`data.site_id`	integernullable	Site id.
`data.campaign_id`	integernullable	Campaign id.
`data.version`	integernullable	Version.
`data.status`	stringnullable	Status.
`data.job_id`	stringnullable	Job id.
`data.decision_call`	stringnullable	Decision call.
`data.decision_alternative`	stringnullable	Decision alternative.
`data.decision_rationale`	stringnullable	Decision rationale.
`data.confidence`	number \| stringnullable	Confidence. Decimal values may be serialized as strings.
`data.positioning`	stringnullable	Positioning. Stored text; JSON-encoded fields are returned as strings.
`data.document_markdown`	stringnullable	Document markdown. Detail only; omitted from list rows.
`data.brief_markdown`	stringnullable	Brief markdown. Detail only; omitted from list rows.
`data.brief_status`	stringnullable	Brief status.
`data.brief_generated_at`	stringnullable	Brief generated at. Stored UTC ISO 8601 timestamp; legacy values may omit a timezone suffix.
`data.generated_at`	stringnullable	Generated at. Stored UTC ISO 8601 timestamp; legacy values may omit a timezone suffix.
`data.created_at`	stringnullable	Created at. Stored UTC ISO 8601 timestamp; legacy values may omit a timezone suffix.
`data.updated_at`	stringnullable	Updated at. Stored UTC ISO 8601 timestamp; legacy values may omit a timezone suffix.
`data.truncated_fields`	array of string	Scalar text fields truncated at 200000 characters. Empty when no scalar was truncated.
`data.id`	integernullable	Id.
`data.site_id`	integernullable	Site id.
`data.campaign_id`	integernullable	Campaign id.
`data.mode`	stringnullable	Mode.
`data.intent_text`	stringnullable	Intent text.
`data.asset_mix`	anynullable	Asset mix. Stored structured JSON; shape depends on the generation pipeline.
`data.story_text`	stringnullable	Story text.
`data.outcome_text`	stringnullable	Outcome text.
`data.user_site_id`	integernullable	User site id.
`data.page_url`	stringnullable	Page url.
`data.brief_id`	integernullable	Brief id.
`data.use_brief`	booleannullable	Use brief.
`data.created_at`	stringnullable	Created at. Stored UTC ISO 8601 timestamp; legacy values may omit a timezone suffix.
`data.updated_at`	stringnullable	Updated at. Stored UTC ISO 8601 timestamp; legacy values may omit a timezone suffix.
`data.truncated_fields`	array of string	Scalar text fields truncated at 200000 characters. Empty when no scalar was truncated.
`data.id`	integernullable	Id.
`data.campaign_id`	integernullable	Campaign id.
`data.claim_source`	stringnullable	Claim source.
`data.claim_id`	integernullable	Claim id.
`data.claim_text_snapshot`	stringnullable	Claim text snapshot.
`data.position`	integernullable	Position.
`data.created_at`	stringnullable	Created at. Stored UTC ISO 8601 timestamp; legacy values may omit a timezone suffix.
`data.updated_at`	stringnullable	Updated at. Stored UTC ISO 8601 timestamp; legacy values may omit a timezone suffix.
`data.truncated_fields`	array of string	Scalar text fields truncated at 200000 characters. Empty when no scalar was truncated.

Response metadata

Fields in meta
Field	Type	Description
`meta.request_id`	stringalways present	Request identifier; also returned in X-Request-ID. Include it in support requests.
`meta.api_version`	stringalways present	API version that produced the response. one of: v1
`meta.limit`	integer	Maximum records per page applied to this request. min 1 · max 100
`meta.has_more`	boolean	True when another page is available.
`meta.next_cursor`	stringnullable	Opaque cursor for the next page; send as cursor. Null on the last page.
`meta.availability`	string	available when stored data exists; not_available when it does not. one of: available, not_available
`meta.billing`	object	Present for paid live SERP requests; replayed receipts describe the original debit, not an additional charge.
`meta.billing.operation`	stringalways present	one of: client_api_serp_refresh
`meta.billing.credits_charged`	integeralways present	min 0
`meta.billing.transaction_id`	integeralways present
`meta.billing.replayed`	booleanalways present

ERRORS

Error responses

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

HTTP	When
`400`	Invalid parameters
`401`	Invalid credentials
`403`	Missing permission
`404`	Missing or inaccessible resource
`413`	artifact_too_large: the authorized stored export exceeds 2 MiB or bounded retrieval limits.
`503`	artifact_unavailable or ownership_unavailable: stored artifact cannot be safely retrieved.