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

# /v1/apps

> This endpoint retrieves a list of all applications.



## OpenAPI

````yaml GET /v1/apps
openapi: 3.1.0
info:
  title: CamposCloud API Documentation
  description: >-
    This documentation provides an overview of the CamposCloud API, including
    authentication, endpoints, and data structures. It is designed to help
    developers integrate with the CamposCloud platform effectively.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.camposcloud.com
security:
  - bearerAuth: []
paths:
  /v1/apps:
    get:
      description: >-
        Returns a list of applications for the authenticated user, with optional
        pagination and filtering by team
      parameters:
        - name: limit
          in: query
          description: The maximum number of results to return
          schema:
            type: integer
            format: int32
        - name: page
          in: query
          description: The page number to retrieve (for pagination)
          schema:
            type: integer
            format: int32
        - name: team
          in: query
          description: Filter applications by team ID
          schema:
            type: string
      responses:
        '200':
          description: List of applications response
          content:
            application/json:
              schema:
                type: object
                properties:
                  applications:
                    type: array
                    items:
                      $ref: '#/components/schemas/ApplicationDataQuery'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    ApplicationDataQuery:
      type: object
      properties:
        _id:
          type: string
          description: The unique identifier of the application
          example: 60c72b2f9b1e8d001c8e4f3a
        currentResourceMetrics:
          type:
            - object
            - 'null'
          description: Current resource metrics of the application
          properties:
            timestamp:
              type: string
              format: date-time
              example: '2025-07-19T17:57:05.069Z'
              description: The timestamp when the metrics were recorded
            online:
              type: boolean
              example: true
              description: Indicates if the application is currently online
            uptime:
              type: integer
              format: int64
              example: 35980
              description: The uptime of the application in seconds
            startedAt:
              type:
                - string
                - 'null'
              format: date-time
              example: '2025-07-19T17:57:05.069Z'
              description: >-
                The date and time when the application was started, null if the
                application is not online
            cpuUsagePercent:
              type: number
              format: float
              example: 0
              description: The CPU usage of the application as a percentage (0-100)
            memoryUsageBytes:
              type: integer
              format: int64
              example: 43671552
              description: The memory usage of the application in bytes
            memoryLimitBytes:
              type: integer
              format: int64
              example: 268435456
              description: The memory limit of the application in bytes
            networkRxBytes:
              type: integer
              format: int64
              example: 228961
              description: >-
                The amount of data received by the application over the network
                in bytes
            networkTxBytes:
              type: integer
              format: int64
              example: 228190
              description: >-
                The amount of data sent by the application over the network in
                bytes
        containerId:
          type: string
          description: The unique identifier of the container
          example: da886ad3-88e9-4012-b893-130e87f6b747
        teamId:
          type:
            - string
            - 'null'
          description: The unique identifier of the team associated with the application
          example: 60c72b2f9b1e8d001c8e4f3b
        restartRequired:
          type: boolean
          description: Indicates if a restart is required for the application
          example: false
        name:
          type: string
          description: The name of the application
          example: My Application
        userId:
          type: string
          description: The unique identifier of the user who owns the application
          example: 60c72b2f9b1e8d001c8e4f3a
        allocatedMemoryMB:
          type: integer
          format: int32
          description: The amount of memory allocated to the application in MB
          example: 256
        allocatedVCpu:
          type: integer
          format: int32
          description: The number of virtual CPUs allocated to the application
          example: 8
        workerNodeId:
          type: object
          properties:
            _id:
              type: string
              description: The unique identifier of the worker node
              example: 60c72b2f9b1e8d001c8e4f3c
            nodeName:
              type: string
              description: The name of the worker node
              example: ODIN
        containerImage:
          type: string
          description: The Docker image used for the application
          example: kevencampos/camposcloud-python
        exposedViaWeb:
          type: boolean
          description: Indicates if the application is exposed via the web
          example: false
        startupCommand:
          type: string
          description: The command used to start the application
          example: python -u index.py
        installDependenciesCmd:
          type: string
          description: The command used to install dependencies for the application
          example: pip install -r requirements.txt
        runtimeEnvironment:
          type: string
          description: The runtime environment of the application
          example: python
        autoRestartEnabled:
          type: boolean
          description: Indicates if auto-restart is enabled for the application
          example: false
        status:
          type: string
          description: The current status of the application
          example: active
        createdAt:
          type: string
          format: date-time
          description: The date and time when the application was created
          example: '2025-07-19T00:02:54.455Z'
        updatedAt:
          type: string
          format: date-time
          description: The date and time when the application was last updated
          example: '2025-07-19T17:57:05.069Z'
        githubDeploys:
          type: array
          description: >-
            List of GitHub repositories connected to the application for
            deployment
          items:
            type: object
            properties:
              commitId:
                type: string
                description: The unique identifier of the GitHub deploy configuration
                example: c505366f3ba913044f65750ab7de60ccbb3d7b5f
              branch:
                type: string
                description: The branch of the GitHub repository that triggers deployments
                example: main
              status:
                type: string
                description: The status of the GitHub deploy configuration
                example: success
              message:
                type: string
                description: The commit message of the latest deployment
                example: first commit
              createdAt:
                type: string
                format: date-time
                description: >-
                  The date and time when the GitHub deploy configuration was
                  created
                example: '2025-07-19T17:57:05.069Z'
              commitedAt:
                type: string
                format: date-time
                description: >-
                  The date and time when the latest commit was made to the
                  connected GitHub repository
                example: '2025-07-19T17:57:05.069Z'
              commitedBy:
                type: string
                description: >-
                  The author of the latest commit to the connected GitHub
                  repository
                example: Keven Campos
              _id:
                type: string
                description: The unique identifier of the GitHub deploy configuration
                example: 60c72b2f9b1e8d001c8e4f3d
              duration:
                type: integer
                format: int64
                description: The duration of the latest deployment in seconds
                example: 120
        totalUsedRAM:
          type: integer
          format: int64
          description: >-
            The total amount of RAM used by your account or application, if
            provided.
          example: 52428800
        pagination:
          type: object
          properties:
            totalItems:
              type: integer
              format: int32
              description: The total number of applications matching the query
              example: 100
            totalPages:
              type: integer
              format: int32
              description: The total number of pages available based on the limit
              example: 10
            currentPage:
              type: integer
              format: int32
              description: The current page number
              example: 1
            itemsPerPage:
              type: integer
              format: int32
              description: The number of applications returned per page
              example: 10
            hasNextPage:
              type: boolean
              description: Indicates if there is a next page available
              example: false
            hasPrevPage:
              type: boolean
              description: Indicates if there is a previous page available
              example: false
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: string
          example: Not found
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````