> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sydium.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch today's Muse content idea (a read; does not generate)

> Returns the team's current Muse idea, resolved the same way the app does (paid plans see today's idea; free plans see the trailing 7-day idea), or a specific agency client's current idea when `clientId` is set. This is a read only - it never triggers idea generation or AI spend. When no idea is in window, `data.idea` is `null`.



## OpenAPI

````yaml /api-reference/openapi.yaml get /v1/ideas/today
openapi: 3.1.0
info:
  title: Sydium Public API
  version: 1.0.0
servers:
  - url: https://api.sydium.com
security:
  - ApiKey: []
paths:
  /v1/ideas/today:
    get:
      summary: Fetch today's Muse content idea (a read; does not generate)
      description: >-
        Returns the team's current Muse idea, resolved the same way the app does
        (paid plans see today's idea; free plans see the trailing 7-day idea),
        or a specific agency client's current idea when `clientId` is set. This
        is a read only - it never triggers idea generation or AI spend. When no
        idea is in window, `data.idea` is `null`.
      operationId: getTodayIdea
      parameters:
        - name: clientId
          in: query
          required: false
          description: >-
            Agency client id (see /v1/clients) to read that client's current
            idea instead of the team's.
          schema:
            type: string
      responses:
        '200':
          description: Today's idea (or null when none is in window)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TodayIdeaResponse'
        '401':
          description: Unauthenticated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden (scope/permission)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Unknown client
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limited / insufficient tokens
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    TodayIdeaResponse:
      type: object
      required:
        - success
        - data
        - meta
      properties:
        success:
          const: true
        data:
          type: object
          required:
            - idea
          properties:
            idea:
              oneOf:
                - $ref: '#/components/schemas/TodayIdea'
                - type: 'null'
        meta:
          type: object
    ErrorResponse:
      type: object
      required:
        - success
        - error
      properties:
        success:
          const: false
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              enum:
                - bad_request
                - unauthorized
                - forbidden
                - insufficient_permissions
                - not_found
                - unprocessable
                - payload_too_large
                - rate_limited
                - invalid_state
                - external_service_error
                - internal_error
            message:
              type: string
        meta:
          type: object
    TodayIdea:
      type: object
      required:
        - date
        - grounded
        - language
        - topic
        - angle
        - format
        - hashtags
        - whyItFits
      properties:
        date:
          type: string
        grounded:
          type: boolean
        language:
          type: string
        topic:
          type: string
        angle:
          type: string
        format:
          type: string
        hashtags:
          type: array
          items:
            type: string
        whyItFits:
          type: string
        anchor:
          type: string
        citation:
          type: object
          required:
            - source
          properties:
            source:
              type: string
            url:
              type: string
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      description: Opaque API key (sk_live_... / sk_test_...)

````