> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.sevalla.com/llms.txt > Use this file to discover all available pages before exploring further. # Get application > Retrieve the full details of an application including its source configuration, build settings, and current status. ## OpenAPI ````yaml https://api.sevalla.com/v3/openapi.json get /applications/{id} openapi: 3.1.0 info: title: Sevalla API docs version: 1.0.0 servers: - url: https://api.sevalla.com/v3 security: - bearerAuth: [] paths: /applications/{id}: get: tags: - Applications summary: Get application description: >- Retrieve the full details of an application including its source configuration, build settings, and current status. operationId: getApplicationV3 parameters: - schema: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ example: fb5e5168-4281-4bec-94c5-0d1584e9e657 in: path name: id required: true description: Application identifier responses: '200': description: Default Response content: application/json: schema: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ description: Unique identifier for the application example: fb5e5168-4281-4bec-94c5-0d1584e9e657 company_id: anyOf: - type: string - type: 'null' description: Identifier of the company that owns this application example: fb5e5168-4281-4bec-94c5-0d1584e9e657 project_id: anyOf: - type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ - type: 'null' description: >- Identifier of the project this application is grouped under example: fb5e5168-4281-4bec-94c5-0d1584e9e657 name: type: string minLength: 1 maxLength: 64 description: >- Unique system name used in URLs and internal references. Auto-generated from the display name and cannot be changed after creation. example: my-app namespace: anyOf: - type: string - type: 'null' description: >- Kubernetes namespace where the application workloads run. Assigned automatically during creation. example: my-app-abc123 display_name: type: string minLength: 1 maxLength: 255 description: >- Human-readable name shown in the dashboard and API responses example: My Application source: type: string enum: - privateGit - publicGit - dockerImage - app description: >- Where the application source code comes from. `privateGit` - private Git repository connected via OAuth. `publicGit` - public Git repository URL. `dockerImage` - Docker container image from a registry. `app` - internally created (cloned or preview apps). example: privateGit type: type: string enum: - app - previewApp description: >- Application type. `app` - standard application. `previewApp` - ephemeral preview environment created from a pull request. example: app status: anyOf: - type: string enum: - deploymentInProgress - deploymentFailed - deploymentSuccess - deleting - appDeletionFailed - deploymentCancelled - type: 'null' description: >- Current status of the application reflecting the most recent deployment or lifecycle operation example: deploymentSuccess build_cache_enabled: type: boolean description: >- When enabled, build artifacts are cached between deployments to speed up subsequent builds example: true git_lfs_enabled: type: boolean description: >- When enabled, Git LFS objects are fetched during the source checkout step of a deployment. Enabled by default. Disable this to skip LFS downloads and speed up checkout when the repository contains LFS files that are not needed at build time. example: true hibernation_enabled: type: boolean description: >- When enabled, the application automatically scales down to zero after a period of inactivity and wakes up on the next incoming request example: false hibernate_after_seconds: anyOf: - type: integer minimum: 1 maximum: 9007199254740991 - type: 'null' description: >- Number of seconds of inactivity before the application is hibernated. Only applies when hibernation is enabled. example: 3600 auto_deploy: type: boolean description: >- When enabled, a new deployment is automatically triggered on every push to the default branch. Only applies to applications with a private Git connection (privateGit) - has no effect on publicGit or dockerImage applications. example: true is_suspended: type: boolean description: >- Whether the application is currently suspended. Suspended applications have all processes stopped but retain their configuration. example: false git_type: anyOf: - type: string enum: - github - bitbucket - gitlab - type: 'null' description: >- Git hosting provider for the repository. `github` - GitHub. `bitbucket` - Bitbucket. `gitlab` - GitLab. Null for non-git sources. example: github repo_url: anyOf: - type: string - type: 'null' description: >- Full URL of the Git repository. Null for Docker image source applications. example: https://github.com/user/repo default_branch: anyOf: - type: string - type: 'null' description: >- Git branch used for automatic and manual deployments when no branch is explicitly specified example: main docker_image: anyOf: - type: string - type: 'null' description: >- Docker image reference including tag or digest. Only set for applications with `dockerImage` source. example: nginx:latest build_type: type: string enum: - dockerfile - pack - nixpacks - railpack description: >- Build strategy used to build the application. `nixpacks` - auto-detected build system. `railpack` - auto-detected build system, successor to Nixpacks. `dockerfile` - build using a Dockerfile. `pack` - build using Cloud Native Buildpacks. example: nixpacks build_path: anyOf: - type: string - type: 'null' description: >- Relative path to the build directory within the repository. Defaults to the repository root. example: . pack_builder: anyOf: - type: string - type: 'null' description: >- Cloud Native Buildpacks builder image. Only applies when build type is `pack`. example: heroku/builder:22 nixpacks_version: anyOf: - type: string - type: 'null' description: >- Pinned Nixpacks version. When null, the platform default version is used. Only applies when build type is `nixpacks`. example: 1.21.0 dockerfile_path: anyOf: - type: string - type: 'null' description: >- Relative path to the Dockerfile within the repository. Only applies when build type is `dockerfile`. example: Dockerfile docker_context: anyOf: - type: string - type: 'null' description: >- Docker build context path relative to the repository root. Only applies when build type is `dockerfile`. example: . allow_deploy_paths: type: array items: type: string description: >- Glob patterns for file paths that trigger a deployment when changed. When set, only commits touching these paths will trigger auto deploy. example: - src/** - package.json ignore_deploy_paths: type: array items: type: string description: >- Glob patterns for file paths to exclude from deployment triggers. Commits that only touch ignored paths will not trigger auto deploy. example: - docs/** - README.md buildpacks: type: array items: type: object properties: id: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ description: Unique identifier for the buildpack example: fb5e5168-4281-4bec-94c5-0d1584e9e657 source: type: string description: Buildpack source URL example: heroku/nodejs order: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Order in which the buildpack is applied during the build example: 0 required: - id - source - order additionalProperties: false description: >- Custom buildpacks configured for this application. Only applies when build type is `pack`. cluster_id: anyOf: - type: string - type: 'null' description: >- Identifier of the cluster where this application is deployed example: fb5e5168-4281-4bec-94c5-0d1584e9e657 docker_registry_credential_id: anyOf: - type: string - type: 'null' description: >- Identifier of the Docker registry credential used to pull the container image. Only applies to applications with `dockerImage` source. example: fb5e5168-4281-4bec-94c5-0d1584e9e657 created_by: anyOf: - type: string - type: 'null' description: Identifier of the user who created the application example: fb5e5168-4281-4bec-94c5-0d1584e9e657 created_at: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ description: >- Timestamp when the application was created, in ISO 8601 format example: '2025-01-30T00:00:00.000Z' updated_at: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ description: >- Timestamp when the application was last modified, in ISO 8601 format example: '2025-01-30T00:00:00.000Z' required: - id - company_id - project_id - name - namespace - display_name - source - type - status - build_cache_enabled - git_lfs_enabled - hibernation_enabled - hibernate_after_seconds - auto_deploy - is_suspended - git_type - repo_url - default_branch - docker_image - build_type - build_path - pack_builder - nixpacks_version - dockerfile_path - docker_context - allow_deploy_paths - ignore_deploy_paths - buildpacks - cluster_id - docker_registry_credential_id - created_by - created_at - updated_at additionalProperties: false '401': description: Default Response content: application/json: schema: type: object properties: message: type: string description: Error message example: Unauthorized status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: HTTP status code example: 401 data: type: object properties: code: description: Error tracking code for support reference example: err-abc-123 type: string message: description: Additional error details or instructions example: >- If you need assistance, please contact support and provide this error code. type: string additionalProperties: false required: - message - status additionalProperties: false '403': description: Default Response content: application/json: schema: type: object properties: message: type: string description: Error message example: Forbidden status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: HTTP status code example: 403 data: type: object properties: code: description: Error tracking code for support reference example: err-abc-123 type: string message: description: Additional error details or instructions example: >- If you need assistance, please contact support and provide this error code. type: string additionalProperties: false required: - message - status additionalProperties: false '404': description: Default Response content: application/json: schema: type: object properties: message: type: string description: Error message example: Not found status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: HTTP status code example: 404 data: type: object properties: code: description: Error tracking code for support reference example: err-abc-123 type: string message: description: Additional error details or instructions example: >- If you need assistance, please contact support and provide this error code. type: string additionalProperties: false required: - message - status additionalProperties: false '500': description: Default Response content: application/json: schema: type: object properties: message: type: string description: Error message example: Internal Server Error status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: HTTP status code example: 500 data: type: object properties: code: description: Error tracking code for support reference example: err-abc-123 type: string message: description: Additional error details or instructions example: >- If you need assistance, please contact support and provide this error code. type: string additionalProperties: false required: - message - status additionalProperties: false components: securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key authentication. Pass your API key as a Bearer token in the Authorization header. ````