Content

List content

Offset-based paginated content list. Filters to public statuses (draft, scheduled, sent, failed) by default and supports workflow, integration, sorting, and opt-in reviewLifecycle filters.

get/v1/workspaces/{workspaceId}/content

Request

  • Base URL: https://api.maevesocial.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.maevesocial.com/v1/workspaces/{workspaceId}/content
  • Auth: HTTP bearer

Path parameters

workspaceIdstring uuid required

Workspace UUID.

Query parameters

status'draft' | 'scheduled' | 'sent' | 'failed'

Public content status filter. Defaults stay limited to draft, scheduled, sent, and failed; review-held pending_approval content requires explicit lifecycle filters.

workflowStatus'drafting' | 'review' | 'approved' | 'scheduled' | 'published'

Workflow status filter. This is not the review lifecycle contract; use reviewLifecycle fields when they are present on detail or review action responses.

workflowStatusesContentWorkflowStatus[]

Comma-separated or repeated workflow statuses. Takes precedence over workflowStatus when provided.

includeReviewLifecycleboolean

When true, includes reviewLifecycle on list items. Defaults false unless a reviewLifecycle filter is present.

reviewLifecyclePhase'none' | 'team' | 'client'

Explicit review lifecycle phase filter. Supplying any reviewLifecycle filter opts into review-held content access.

reviewLifecycleState'none' | 'pending' | 'changes_requested' | 'needs_schedule' | 'approved' | 'overridden' | 'cancelled' | 'expired'

Explicit review lifecycle state filter. Supplying any reviewLifecycle filter opts into review-held content access.

reviewLifecycleActor'none' | 'agency' | 'author' | 'approver' | 'client' | 'system'
reviewLifecycleNextAction'request_review' | 'send' | 'decide' | 'address_changes' | 'schedule' | 'publish' | 'none'
reviewLifecycleBlocksPublishingboolean

Filter content by whether reviewLifecycle currently blocks scheduling or publishing.

reviewLifecycleBlocker'missing_schedule' | 'schedule_expired' | 'review_pending' | 'changes_requested' | 'review_cancelled' | 'review_expired'
reviewLifecycleBatchIdstring uuid

Filter by reviewLifecycle.clientReview.batchId.

reviewLifecycleItemIdstring uuid

Filter by reviewLifecycle.clientReview.itemId.

integrationIdstring uuid
sortBy'createdAt' | 'updatedAt' | 'scheduledAt' | 'priority'
sortDirection'asc' | 'desc'
limitinteger
offsetinteger

Response

Paginated content list

Example response

{
  "data": [
    {
      "recurringMetadata": {
        "localDate": "2026-07-09",
        "localTime": "09:30",
        "timezone": "Australia/Melbourne"
      }
    }
  ],
  "meta": {
    "limit": 20,
    "total": 125,
    "hasMore": true
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.