Sign in
CMS

List articles

Returns a paginated list of articles for the team with status, SEO scores, publish dates, and metadata. Does not include full article body content.

get/v3/cms/articles

Query parameters

teamIdstring

Team ID

pagestring

Page number (default: 1)

per_pagestring

Items per page (default: 20, or "all")

status'draft' | 'processing' | 'generated' | 'scheduled' | 'published' | 'failed' | 'manual' | 'all'

Filter by status (draft, processing, generated, scheduled, published, failed, manual) or "all"

topicIdstring

Filter to articles belonging to a topic cluster

startDatestring

ISO date — only articles whose scheduledAt or publishedAt is on/after this (calendar-window scoping)

endDatestring

ISO date — only articles whose scheduledAt or publishedAt is on/before this (calendar-window scoping)

searchstring

Case-insensitive search across title, slug, keywords, prompts, providers, and topic name

sortBy'name' | 'status' | 'seo' | 'topic' | 'created'

Sort column

sortDir'asc' | 'desc'

Sort direction

categorystring

Filter to articles carrying this category name

tagstring

Filter to articles carrying this tag name

Response

Default Response

Changes

Changed in 3 of the 47 revisions of this API.5422

  • 78929b45c4f81See the full diff
    • ●

      added the new embed enum value to the /// response property for the response status

      response-property-enum-value-added

  • 8f92b00b75d65318See the full diff
    • ▲

      the query request parameter sortBy was restricted to a list of enum values

      request-parameter-became-enum

    • ▲

      the query request parameter sortDir was restricted to a list of enum values

      request-parameter-became-enum

    • ▲

      the query request parameter status was restricted to a list of enum values

      request-parameter-became-enum

    • ▲

      for the query request parameter sortBy, default value created was added

      request-parameter-default-value-added

    • ▲

      for the query request parameter sortDir, default value desc was added

      request-parameter-default-value-added

    • ●

      added the new grigora enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new manual enum value to the // response property for the response status

      response-property-enum-value-added

    • ●

      added the new manual enum value to the // response property for the response status

      response-property-enum-value-added

    • ○

      added the new enum value all to the query request parameter status

      request-parameter-enum-value-added

    • ○

      added the new enum value asc to the query request parameter sortDir

      request-parameter-enum-value-added

    • ○

      added the new enum value created to the query request parameter sortBy

      request-parameter-enum-value-added

    • ○

      added the new enum value desc to the query request parameter sortDir

      request-parameter-enum-value-added

    • ○

      added the new enum value draft to the query request parameter status

      request-parameter-enum-value-added

    • ○

      added the new enum value failed to the query request parameter status

      request-parameter-enum-value-added

    • ○

      added the new enum value generated to the query request parameter status

      request-parameter-enum-value-added

    • ○

      added the new enum value manual to the query request parameter status

      request-parameter-enum-value-added

    • ○

      added the new enum value name to the query request parameter sortBy

      request-parameter-enum-value-added

    • ○

      added the new enum value processing to the query request parameter status

      request-parameter-enum-value-added

    • ○

      added the new enum value published to the query request parameter status

      request-parameter-enum-value-added

    • ○

      added the new enum value scheduled to the query request parameter status

      request-parameter-enum-value-added

    • ○

      added the new enum value seo to the query request parameter sortBy

      request-parameter-enum-value-added

    • ○

      added the new enum value status to the query request parameter sortBy

      request-parameter-enum-value-added

    • ○

      added the new enum value topic to the query request parameter sortBy

      request-parameter-enum-value-added

    • ○

      removed the blog enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the case-study enum value from the // response property for the response status

      response-property-enum-value-removed

    • ○

      removed the technical enum value from the // response property for the response status

      response-property-enum-value-removed

  • 60ff6690f93c4See the full diff
    • ○

      added the new optional query request parameter category

      new-optional-request-parameter

    • ○

      added the new optional query request parameter tag

      new-optional-request-parameter

    • ○

      added the optional property // to the response with the status

      response-optional-property-added

    • ○

      added the optional property // to the response with the status

      response-optional-property-added