> ## Documentation Index
> Fetch the complete documentation index at: https://cinepro-changelog-2026-05-21.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Refresh cached sources by responseId

> Invalidates the cache for a specific source by responseId. 
This is useful when sources have expired or changed.

**Behavior:**
- Immediately invalidates cache for the given responseId
- Next request for the same content will perform a fresh scrape
- Returns simple OK status on success
- responseId format: UUID v4 (alphanumeric with hyphens/underscores, max 128 chars)




## OpenAPI

````yaml get /v1/refresh/{responseId}
openapi: 3.0.0
info:
  title: Open Media Streaming Specification (OMSS)
  description: >
    A standardized REST API specification for streaming backends to expose
    movies, TV episodes, 

    sources, and subtitles. OMSS enables interoperability between streaming
    backends and frontends.


    **Key Features:**

    - Standardized endpoints for movies and TV episodes

    - Proxy-based source delivery with header support

    - Multi-language and multi-quality source support

    - Subtitle support with multiple formats

    - Diagnostic reporting for partial scrapes

    - Caching optimization recommendations

    - HTTPS-enforced security


    **Reference Implementation:** https://github.com/omss-spec/omss-spec
  version: 1.0.0
  license:
    name: MIT License
    url: https://github.com/omss-spec/omss-spec/blob/main/LICENSE
  contact:
    name: OMSS Community
    url: https://github.com/omss-spec/omss-spec
servers:
  - url: https://api.example.com
    description: Production server (HTTPS required)
    variables:
      version:
        default: v1
        enum:
          - v1
  - url: http://localhost:3000
    description: Development server (localhost only)
security: []
tags:
  - name: Content
    description: Retrieve sources for movies and TV shows
  - name: Proxy
    description: Proxy endpoint to play content by upstream providers
  - name: Health
    description: Health and version information. All endpoints return the same object.
  - name: Refresh
    description: Refresh cached sources
paths:
  /v1/refresh/{responseId}:
    get:
      tags:
        - Refresh
      summary: Refresh cached sources
      description: >
        Invalidates the cache for a specific source by responseId. 

        This is useful when sources have expired or changed.


        **Behavior:**

        - Immediately invalidates cache for the given responseId

        - Next request for the same content will perform a fresh scrape

        - Returns simple OK status on success

        - responseId format: UUID v4 (alphanumeric with hyphens/underscores, max
        128 chars)
      operationId: refreshSource
      parameters:
        - name: responseId
          in: path
          required: true
          description: >
            Unique response ID (UUID v4 format, alphanumeric with
            hyphens/underscores, max 128 characters)
          schema:
            type: string
            pattern: ^[a-zA-Z0-9_-]{1,128}$
          example: cf6c3c2d-17be-4a5a-9488-bf12e70dca5a
      responses:
        '200':
          description: Cache refreshed successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RefreshResponse'
              example:
                status: OK
        '400':
          description: Invalid responseId format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: ResponseId not found or already expired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    RefreshResponse:
      type: object
      required:
        - status
      properties:
        status:
          type: string
          enum:
            - OK
          description: Cache refresh status
          example: OK
    ErrorResponse:
      type: object
      required:
        - error
        - traceId
      properties:
        error:
          $ref: '#/components/schemas/ErrorObject'
        traceId:
          type: string
          format: uuid
          description: Unique trace ID for error tracking and debugging
          example: a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d
    ErrorObject:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: Machine-readable error code
          enum:
            - INVALID_TMDB_ID
            - INVALID_PARAMETER
            - MISSING_PARAMETER
            - INVALID_SEASON
            - INVALID_EPISODE
            - INVALID_RESPONSE_ID
            - RESPONSE_ID_NOT_FOUND
            - NO_SOURCES_AVAILABLE
            - ENDPOINT_NOT_FOUND
            - METHOD_NOT_ALLOWED
            - INTERNAL_ERROR
            - UNSUPPORTED_MEDIA_TYPE
          example: INVALID_TMDB_ID
        message:
          type: string
          description: Human-readable error message
          example: TMDB ID must be numeric
        details:
          type: object
          description: Additional error details (backend-specific, optional)
          example:
            parameter: id
            value: not-a-number
            expected: numeric string

````