operationId: apps_get
summary: Retrieve an Existing App
description: Retrieve details about an existing app by either its ID or name. To retrieve
an app by its name, do not include an ID in the request path. Information about
the current active deployment as well as any in progress ones will also be included
in the response.
tags:
- Apps
parameters:
- $ref: parameters.yml#/id_app
- $ref: parameters.yml#/app_name
responses:
"200":
$ref: responses/apps_get.yml
"401":
$ref: ../../shared/responses/unauthorized.yml
'404':
$ref: '../../shared/responses/not_found.yml'
"429":
$ref: "../../shared/responses/too_many_requests.yml"
"500":
$ref: ../../shared/responses/server_error.yml
default:
$ref: ../../shared/responses/unexpected_error.yml
x-codeSamples:
- $ref: 'examples/curl/apps_get.yml'
- $ref: 'examples/python/apps_get.yml'
security:
- bearer_auth:
- 'app:read'