GET
/
v1
/
teams
/
{teamId}
/
posts
/
facets
TypeScript client
import { OctosparkClient } from '@octospark/sdk'

const client = new OctosparkClient({
  token: process.env.OCTOSPARK_TOKEN
})

const response = await client.social.getPostFacets({
  teamId: process.env.OCTOSPARK_TEAM_ID ?? "teamId",
  query: {},
})
{
  "all": 123,
  "drafts": 123,
  "queue": 123,
  "sent": 123,
  "failed": 123
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
teamId
string
required

Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.

Query Parameters

​
campaignId
string<uuid>

Only include outputs attributed to this campaign through their originating agent run, including child runs and agents no longer in its pool.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
​
status
enum<string>

Filter to posts with this editorial status.

Available options:
idea,
proposed_render,
draft,
in_review,
approved,
rejected,
archived,
deleted
Example:

"draft"

​
workflowStatusId
string<uuid>

Filter to posts assigned to this workspace-defined content workflow status.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
​
provider
enum<string>

Filter to posts whose latest scheduled post targets this provider.

Available options:
x,
tiktok,
instagram,
facebook,
youtube,
linkedin,
threads,
pinterest
Example:

"x"

​
scheduledFrom
string

Only include posts scheduled at or after this ISO 8601 timestamp.

Example:

"2026-06-01T00:00:00Z"

​
scheduledTo
string

Only include posts scheduled at or before this ISO 8601 timestamp.

Example:

"2026-06-30T23:59:59Z"

​
filter[q]
string

Case-insensitive free-text search over the post title and latest payload text.

Example:

"product launch"

​
filter[postType]
enum<string>

Filter to posts of this content format.

Available options:
text_post,
text_image,
text_video,
carousel
Example:

"text_image"

​
filter[tagIds]
string

CSV of user-tag UUIDs from the post_tags registry; matches posts assigned ANY of these tags. Unknown or foreign ids are ignored.

Example:

"4a1f4e93-0d8b-4a6c-9a44-1e8b1f2c3d4e,7b2c5f81-3e9d-4b7a-8c55-2f9c2a3b4c5d"

​
filter[assignee]
enum<string>

Assignee quick filter: me = posts assigned to the calling user, unassigned = posts with no assignees.

Available options:
me,
unassigned
Example:

"me"

​
filter[tags]
string

Comma-separated AI tags; matches posts whose assets carry any of the listed tags (OR).

Example:

"launch,product"

​
filter[category]
string

Comma-separated AI content categories; matches posts in any of the listed categories (OR).

Example:

"education"

​
filter[purpose]
string

Comma-separated AI purposes; matches posts whose assets carry any of the listed purposes (OR).

Example:

"promotion"

​
filter[emotion]
string

Comma-separated AI emotions; matches posts tagged with any of the listed emotions (OR).

Example:

"joy"

​
filter[mediaType]
string

Comma-separated media types; each value one of: image, video, audio, gif, document.

Example:

"image,video"

​
filter[enrichmentStatus]
string

Comma-separated AI enrichment statuses; each value one of: pending, processing, completed, failed.

Example:

"completed"

Response

Success

​
all
number
required

Posts matching the filters, any tab.

​
drafts
number
required

Posts never scheduled or whose latest leg is a draft or cancelled.

​
queue
number
required

Posts whose latest leg is scheduled or publishing.

​
sent
number
required

Posts whose latest leg is published.

​
failed
number
required

Posts whose latest leg failed.