# List Apps
## OpenAPI Specification
```yaml
openapi: 3.0.1
info:
title: ''
description: ''
version: 1.0.0
paths:
/be/v1/apps:
get:
summary: List Apps
deprecated: false
description: >-
This endpoint allows you to list the details of all apps of your
organiztion on the ROCKIT Edge.
### Required Permissions
`apps.read`
See [Roles](https://edge.api.cloud.rockitplay.com/roles-3618377f0.md)
for more details.
tags:
- ROCKIT Edge - Backend API/Apps
parameters:
- name: fields[]
in: query
description: >-
name, label, iCurBuild, maxBuilds, processing, exporting, sizeBytes,
created, updated, gog, egs, steam, deployments, dxfName, files,
traceUpload, training, executables, artworks, exception, error,
class
required: false
example:
- name
- label
- iCurBuild
- maxBuilds
- processing
- exporting
- sizeBytes
- created
- updated
- gog
- egs
- steam
- deployments
- dxfName
- files
- traceUpload
- training
- executables
- artworks
- exception
- error
- class
schema:
type: array
items:
type: string
- name: name
in: query
description: Filter by app name (supports partial matches, case sensitive).
required: false
example: example_app
schema:
type: string
- name: processing
in: query
description: Filter by processing status.
required: false
example: 'true'
schema:
type: boolean
- name: exporting
in: query
description: Filter by exporting status.
required: false
example: 'true'
schema:
type: boolean
- name: offset
in: query
description: 'Pagination offset. '
required: false
example: 0
schema:
type: integer
minimum: 0
- name: limit
in: query
description: Pagination limit.
required: false
example: 10
schema:
type: integer
minimum: 1
default: 10
- name: order[]
in: query
description: >-
Sorting order. Supported fields for sorting:
name,label,created,updated. +/- for Ascending/Descending (no +/-
results in ascending order)
required: false
example: '-updated'
schema:
type: array
items:
type: string
- name: Authorization
in: header
description: >-
Use the access token obtained from [`POST
/be/v1/login`](https://edge.api.cloud.rockitplay.com/user-login-org-11611254e0.md)
or [`POST
/be/v1/refresh`](https://edge.api.cloud.rockitplay.com/refresh-11630082e0.md)
as Bearer token.
Mutually excluded with `x-rockit-api-key`.
required: true
example:
- Bearer {{_edge_org_admin_access_token}}
schema:
type: array
items:
type: string
- name: x-rockit-tenant
in: header
description: >
Unique and immutable tenancy identifier obtained from the ROCKIT
Edge administrator.
Requires `x-rockit-username`,
`x-rockit-orgname` and `x-rockit-api-key`.
required: true
example: '{{EDGE_TENANT_NAME}}'
schema:
type: string
- name: x-rockit-orgname
in: header
description: >
Unique and immutable organization identifier obtained from the
ROCKIT Edge administrator.
Requires `x-rockit-tenant`,
`x-rockit-username` and `x-rockit-api-key`.
required: true
example: '{{EDGE_ORG_NAME}}'
schema:
type: string
- name: x-rockit-username
in: header
description: >
Unique and immutable username which is associated with the apikey.
Requires `x-rockit-tenant`, `x-rockit-orgname` and
`x-rockit-api-key`.
required: true
example: adminPrincipal
schema:
type: string
- name: x-rockit-api-key
in: header
description: >-
Unique and immutable apikey which is associated with an machine
user.
Mutually excluded with `Authorization` header. Requires
`x-rockit-tenant`, `x-rockit-username` and `x-rockit-orgname`.
required: true
example: '{{_adminPrincipal_apiKey}}'
schema:
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
type: object
properties:
status:
type: string
description: >-
Indicates that the retrieval of the app list was
successful.
totalCount:
type: number
description: >-
An integer representing the total number of apps returned
by the query.
apps:
type: array
items:
type: object
properties: {}
x-apidog-orders: []
x-apidog-ignore-properties: []
description: >-
An array of app summary objects where each object includes
key properties (such as the app’s name, label, current
build number, and other summary details) that help to
identify and overview the registered apps.
required:
- status
- totalCount
- apps
x-apidog-orders:
- status
- totalCount
- apps
x-apidog-ignore-properties: []
examples:
'1':
summary: '200: success'
value:
status: success
totalCount: 1
apps:
- name: Sushi
label: 'Sushibar: All you can feed'
dxfName: b1e0efe3-3415-45ea-afa5-290c76ef3c4c
iCurBuild: 3
maxBuilds: 3
processing: false
exporting: false
deployed:
- gcore
files:
dxf:
- name: app.json
size: 685
md5: 7cd715cdcabf2feb58f12e08c4b5fb74
- name: img.json
size: 204
md5: 8d92dcf7ced29815e07bee58e9b983bb
- name: img.idx.7z
size: 12696
md5: 4a3df23e6a37b03936979d6bb144d1c1
- name: img.dxf
size: 166711296
md5: ddfddf0f2a7ba167299d96a23d34a73b
patches:
0001-0003:
- name: app.json
size: 476
md5: d663daa2926b3b1d2be62c42c9551e55
- name: img.json
size: 204
md5: 8d92dcf7ced29815e07bee58e9b983bb
- name: map.7z
size: 12643
md5: 7d1206cde916d119d7aa32daee2a667a
- name: patch.7z
size: 254
md5: 99560e8d5bf1f632b3ae5f705f13b17c
- name: patch.json
size: 356
md5: a00974f7a83ebd911bebf17f9d8bd615
- name: patch.data
size: 353
md5: e94a95aa7d1aa4008f7021a503dc2011
0002-0003:
- name: app.json
size: 476
md5: d663daa2926b3b1d2be62c42c9551e55
- name: img.json
size: 204
md5: 8d92dcf7ced29815e07bee58e9b983bb
- name: map.7z
size: 12643
md5: 75f6538edd9e5761a0c5ac684b7f60af
- name: patch.7z
size: 253
md5: 15b5b0bb5ade3bd25c8e2d92eb7cd478
- name: patch.json
size: 356
md5: 38e42f3b7cbd3ad030c9f16ce525b31c
- name: patch.data
size: 368
md5: 4bff49016fb290453454b3e928c8f17a
'2':
summary: '400: missing-param'
value:
status: failed
error: missing-param
message: x-rockit-beauth-token missing
detail: header parameter x-rockit-beauth-token is required
'3':
summary: '401: token-expired'
value:
status: failed
error: token-expired
message: expired token
headers: {}
x-apidog-name: '200: success'
'400':
description: ''
content:
application/json:
schema:
type: object
properties:
status:
type: string
description: >-
Reflects that the creation failed due to one or more
invalid or missing parameters in the request.
error:
type: string
description: Contains an error identifier. (e.g., "invalid-param")
message:
type: string
description: >-
Explains the nature of the invalid input (for example,
"name invalid").
detail:
type: string
description: >-
Offers further context on the error. (e.g., expected
pattern for the organization name)
x-apidog-orders:
- 01JQNHHRE76CZKMR2M3NAY6PZN
required:
- status
- error
- message
- detail
x-apidog-refs:
01JQNHHRE76CZKMR2M3NAY6PZN:
$ref: '#/components/schemas/Invalid%20Param'
x-apidog-ignore-properties:
- status
- error
- message
- detail
headers: {}
x-apidog-name: '400: missing-param'
'401':
description: ''
content:
application/json:
schema:
type: object
properties:
status:
type: string
description: >-
Indicates that the organization creation request was
rejected because of authentication problems.
error:
type: string
description: Contains an error identifier. (e.g."unauthorized")
message:
type: string
description: >-
Provides details such as "invalid token" to help diagnose
the failure.
x-apidog-orders:
- 01JQNHJ2BTGCK0EW9TNVMZT5FB
required:
- status
- error
- message
x-apidog-refs:
01JQNHJ2BTGCK0EW9TNVMZT5FB:
$ref: '#/components/schemas/unauthorized'
x-apidog-ignore-properties:
- status
- error
- message
headers: {}
x-apidog-name: '401: token-expired'
security: []
x-apidog-folder: ROCKIT Edge - Backend API/Apps
x-apidog-status: released
x-run-in-apidog: https://app.apidog.com/web/project/732774/apis/api-13039645-run
components:
schemas:
Invalid Param:
type: object
properties:
status:
type: string
description: >-
Reflects that the creation failed due to one or more invalid or
missing parameters in the request.
error:
type: string
description: Contains an error identifier. (e.g., "invalid-param")
message:
type: string
description: >-
Explains the nature of the invalid input (for example, "name
invalid").
detail:
type: string
description: >-
Offers further context on the error. (e.g., expected pattern for the
organization name)
required:
- status
- error
- message
- detail
x-apidog-orders:
- status
- error
- message
- detail
x-apidog-ignore-properties: []
x-apidog-folder: ''
unauthorized:
type: object
properties:
status:
type: string
description: >-
Indicates that the organization creation request was rejected
because of authentication problems.
error:
type: string
description: Contains an error identifier. (e.g."unauthorized")
message:
type: string
description: >-
Provides details such as "invalid token" to help diagnose the
failure.
required:
- status
- error
- message
x-apidog-orders:
- status
- error
- message
x-apidog-ignore-properties: []
x-apidog-folder: ''
securitySchemes:
Bearer token:
type: bearer
scheme: bearer
description: >-
Enter your Access Token. You can obtain this by calling the /be/v1/login
endpoint. Use the Refresh token to get a new Access token when it
expires.
servers:
- url: https://Example-Server.com
description: Default
security: []
```