businesses

Get planning snapshot

Read everything a batch plan needs in one call: schedule, queue, topics, recent posts and library matches.

Call this once before planning several posts, instead of get_posting_schedule, get_queue_summary, list_topics, list_posts and search_media_library one by one. Each block says the same as its own tool, trimmed for planning: topics are titles by category (no ids), and each recent post is one line with its day, status and caption start. Call the individual tool when you need full records or ids.

Errors: 400 invalid_value: The business_id is not a valid UUID. 401 authentication_required: API key or token is missing, invalid, or revoked. 403 permission_denied: Your plan does not include API access, or this business is not in your org. 404 resource_not_found: No business with that ID exists. 422 invalid_request: More than 6 media_queries, or recent_days is outside 1-90. 429 rate_limit_exceeded: You sent too many requests this minute.

get/api/businesses/{business_id}/planning-snapshot

Request

  • Base URL: https://api.mymarky.ai
  • URL: https://api.mymarky.ai/api/businesses/{business_id}/planning-snapshot
  • Auth: HTTP bearer

Path parameters

business_idstring required

A UUID identifier.

Query parameters

recent_daysinteger

How many days of recent posts to include (1-90).

media_queriesstring[] nullable

Up to 6 library searches to run, in plain words (e.g. 'our service truck'). Each returns up to 5 photos; a photo is only listed under the first query that found it.

Headers

Marky-Version'2026-04-08' | '2026-07-17' | '2026-08-02' | '2026-08-04' | '2026-08-06'
Example:2026-08-06

Opt into a dated API version. Omit to stay on the floor (2026-04-08) forever — unpinned clients never break. Pin to a newer date (e.g. 2026-08-06) to receive the newest response shapes. Unknown values fall back to the floor. See https://docs.mymarky.ai for the versioning model.

Response

Successful Response

Changes

No recorded changes to this operation across all 1 revision of this API.