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

# List sources

> Filter by case-insensitive name containment, type (Generic or Media), status (Active or Purging), createdFrom/createdTo and updatedFrom/updatedTo (inclusive timestamps). Filters combine with AND and retain application resource restrictions. Preserve filters when following after cursors.



## OpenAPI

````yaml /api-reference/openapi/configuration.json get /v1/sources
openapi: 3.1.1
info:
  title: Configuration API
  description: >-
    Manage applications, sources, source properties, managed tags and managed
    tag values. Lists use forward-only keyset pagination with after and limit
    (default 50, maximum 200). Successful responses return resource data
    directly, with ForwardPage (items, after, totalCount) for lists. Errors use
    ProblemDetails. Tenant identity comes from authentication. Application
    updates replace settings and require the latest etag. Secrets are returned
    only on creation. Property changes and source deletion may complete
    asynchronously.
  version: 1.0.0
servers:
  - url: https://api.occtoo.com
security: []
tags:
  - name: Sources
  - name: Applications
  - name: Managed tags
  - name: Managed tag values
paths:
  /v1/sources:
    get:
      tags:
        - Sources
      summary: List sources
      description: >-
        Filter by case-insensitive name containment, type (Generic or Media),
        status (Active or Purging), createdFrom/createdTo and
        updatedFrom/updatedTo (inclusive timestamps). Filters combine with AND
        and retain application resource restrictions. Preserve filters when
        following after cursors.
      operationId: ListSources
      parameters:
        - name: type
          in: query
          schema:
            $ref: '#/components/schemas/DataSourceType'
        - name: status
          in: query
          schema:
            $ref: '#/components/schemas/DataSourceStatus'
        - name: name
          in: query
          schema:
            type: string
        - name: createdFrom
          in: query
          schema:
            type: string
            format: date-time
        - name: createdTo
          in: query
          schema:
            type: string
            format: date-time
        - name: updatedFrom
          in: query
          schema:
            type: string
            format: date-time
        - name: updatedTo
          in: query
          schema:
            type: string
            format: date-time
        - name: after
          in: query
          schema:
            type: string
        - name: limit
          in: query
          schema:
            pattern: ^-?(?:0|[1-9]\d*)$
            type:
              - integer
              - string
            format: int32
        - name: includeTotalCount
          in: query
          schema:
            type: boolean
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ForwardPageOfSourceResponse'
        '400':
          description: Bad Request
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/HttpValidationProblemDetails'
        '401':
          description: Unauthorized
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Not Found
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '409':
          description: Conflict
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          description: Too Many Requests
          headers:
            Retry-After:
              description: Optional number of seconds to wait before retrying.
              schema:
                minimum: 1
                type: integer
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '500':
          description: Internal Server Error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      security:
        - kindeOAuth: []
        - bearerAuth: []
        - apiKey: []
components:
  schemas:
    DataSourceType:
      enum:
        - Generic
        - Media
    DataSourceStatus:
      enum:
        - Active
        - Purging
    ForwardPageOfSourceResponse:
      required:
        - items
        - after
        - totalCount
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/SourceResponse'
        after:
          type:
            - 'null'
            - string
        totalCount:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - 'null'
            - integer
          format: int64
    HttpValidationProblemDetails:
      type: object
      properties:
        type:
          type:
            - 'null'
            - string
        title:
          type:
            - 'null'
            - string
        status:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - 'null'
            - integer
            - string
          format: int32
        detail:
          type:
            - 'null'
            - string
        instance:
          type:
            - 'null'
            - string
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
    ProblemDetails:
      type: object
      properties:
        type:
          type:
            - 'null'
            - string
        title:
          type:
            - 'null'
            - string
        status:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - 'null'
            - integer
            - string
          format: int32
        detail:
          type:
            - 'null'
            - string
        instance:
          type:
            - 'null'
            - string
    SourceResponse:
      required:
        - id
        - name
        - description
        - status
        - type
        - createdAt
        - updatedAt
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        description:
          type:
            - 'null'
            - string
        status:
          $ref: '#/components/schemas/DataSourceStatus'
        type:
          $ref: '#/components/schemas/DataSourceType'
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
  securitySchemes:
    kindeOAuth:
      type: oauth2
      description: >-
        Sign in with the existing Occtoo Studio identity and selected
        organization.
      flows:
        authorizationCode:
          authorizationUrl: >-
            https://auth.occtoo.com/oauth2/auth?audience=https%3A%2F%2Fapi-weu.occtoo.com
          tokenUrl: https://auth.occtoo.com/oauth2/token
          scopes:
            openid: Authenticate the user with OpenID Connect.
            profile: Read the user's basic profile.
            email: Read the user's email address.
            offline: Refresh the access token without another interactive sign-in.
          x-usePkce: SHA-256
          x-scalar-redirect-uri: https://api.occtoo.com/docs/
    bearerAuth:
      type: http
      description: >-
        Tenant-scoped Occtoo access token, including Kinde machine-to-machine
        application tokens.
      scheme: bearer
      bearerFormat: JWT
    apiKey:
      type: apiKey
      description: Occtoo organization API key.
      name: x-api-key
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.