> ## 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 applications

> Filter by case-insensitive name containment, case-sensitive tags (repeat tags to require every tag), createdFrom/createdTo and updatedFrom/updatedTo (inclusive timestamps), createdBy and updatedBy (actor IDs). Filters combine with AND. Preserve filters when following after cursors.



## OpenAPI

````yaml /api-reference/openapi/configuration.json get /v1/applications
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/applications:
    get:
      tags:
        - Applications
      summary: List applications
      description: >-
        Filter by case-insensitive name containment, case-sensitive tags (repeat
        tags to require every tag), createdFrom/createdTo and
        updatedFrom/updatedTo (inclusive timestamps), createdBy and updatedBy
        (actor IDs). Filters combine with AND. Preserve filters when following
        after cursors.
      operationId: ListApplications
      parameters:
        - name: tags
          in: query
          schema:
            type: array
            items:
              type: string
        - name: createdBy
          in: query
          schema:
            type: string
            format: uuid
        - name: updatedBy
          in: query
          schema:
            type: string
            format: uuid
        - 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/ForwardPageOfApplicationResponse'
        '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:
    ForwardPageOfApplicationResponse:
      required:
        - items
        - after
        - totalCount
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ApplicationResponse'
        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
    ApplicationResponse:
      required:
        - id
        - name
        - description
        - clientId
        - tags
        - scopeKeys
        - resourceSelectors
        - apiSelectors
        - audiences
        - etag
        - createdAt
        - lastModifiedAt
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        description:
          type:
            - 'null'
            - string
        clientId:
          type: string
        tags:
          type: array
          items:
            type: string
        scopeKeys:
          type: array
          items:
            type: string
        resourceSelectors:
          type: array
          items:
            type: string
        apiSelectors:
          type: array
          items:
            type: string
        audiences:
          type: array
          items:
            type: string
        etag:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          format: uint32
        createdAt:
          type: string
          format: date-time
        lastModifiedAt:
          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.