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

# List bulletin configs

> Base model view set providing standardized CRUD operations and error handling.

This view set enforces consistent response formats, error handling patterns,
and logging across all API endpoints. Subclasses must override the class
variables below.



## OpenAPI

````yaml /openapi/content.yaml get /api/v1/bulletin-configs
openapi: 3.0.3
info:
  title: Content Service API
  version: 1.0.0
  description: |2-

        **Content Service API** - Comprehensive content(story) and management system.
        
servers:
  - url: https://api.capedigital.co.ke/content
    description: Production
  - url: http://localhost:8000
    description: Local
security: []
paths:
  /api/v1/bulletin-configs:
    get:
      tags:
        - Bulletin Configs
      summary: List bulletin configs
      description: >-
        Base model view set providing standardized CRUD operations and error
        handling.


        This view set enforces consistent response formats, error handling
        patterns,

        and logging across all API endpoints. Subclasses must override the class

        variables below.
      operationId: bulletin_configs_list
      parameters:
        - name: cursor
          required: false
          in: query
          description: The pagination cursor value.
          schema:
            type: string
        - name: page_size
          required: false
          in: query
          description: Number of results to return per page.
          schema:
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedBulletinConfigList'
              examples:
                MorningTV:
                  value:
                    next: http://api.example.org/accounts/?cursor=cD00ODY%3D"
                    previous: http://api.example.org/accounts/?cursor=cj0xJnA9NDg3
                    results:
                      - id: 3c90c3cc-0d44-4b50-8888-8dd25736052a
                        name: Morning TV Bulletin
                        platform: television
                        slot: morning
                        studio: Studio A
                        slot_duration: '00:30:00'
                        is_active: true
                  summary: Morning TV
          description: ''
      security:
        - bearerAuth: []
components:
  schemas:
    PaginatedBulletinConfigList:
      type: object
      required:
        - results
      properties:
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?cursor=cD00ODY%3D"
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?cursor=cj0xJnA9NDg3
        results:
          type: array
          items:
            $ref: '#/components/schemas/BulletinConfig'
    BulletinConfig:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        name:
          type: string
          maxLength: 100
        platform:
          enum:
            - television
            - radio
          type: string
          description: |-
            * `television` - Television
            * `radio` - Radio
          x-spec-enum-id: 562fafbd4b066458
        slot:
          enum:
            - morning
            - midday
            - afternoon
            - evening
            - late_night
            - breaking
          type: string
          description: |-
            * `morning` - Morning
            * `midday` - Midday
            * `afternoon` - Afternoon
            * `evening` - Evening
            * `late_night` - Late Night
            * `breaking` - Breaking
          x-spec-enum-id: c946736aa899c338
        category:
          enum:
            - news
            - sports
            - business
          type: string
          x-spec-enum-id: 66ae5be8ea000669
          description: >-
            Editorial subject of this bulletin (distinct from slot, which is
            time-of-day)


            * `news` - News

            * `sports` - Sports

            * `business` - Business
        studio:
          type: string
          maxLength: 100
        slot_duration:
          type: string
          nullable: true
        is_active:
          type: boolean
      required:
        - id
        - name
        - platform
        - slot
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Enter your JWT token in the format: Bearer <token>'

````