ROCKITPLAY API
  1. Apps
ROCKITPLAY API
  • ROCKIT Edge - Admin API
    • Minimal Tests
      • ping
      • submit test task
    • Admin Edge Organizations
      • Create Organization
      • Delete Organization
  • ROCKIT Edge - Backend API
    • Backend Edge Organizations
      • Create Organization
      • Delete Organization
    • Authentication
      • user login
      • authentication
    • Account Management
      • get user details
      • list users
      • Modify user
      • delete users
      • Create User / Create Machine User
    • Deployments
      • Creating Deployments
      • Get Deployments
      • Get Deployment Details
      • Modify Deployment
      • Deleting Deployments
    • Apps
      • Creating Apps
        POST
      • Import native builds
        POST
      • App Details
        GET
      • List Apps
        GET
      • patch app
        PATCH
      • Delete Apps
        DELETE
    • Triggers
      • Process Traces
      • Retry Task
    • Tasks
      • Listing Tasks
      • Task Details
      • Acknowledge Warning / Expire Task
    • Subscriptions
      • Subscribe
      • List Subscriptions
      • Unsubscribe
    • Roles
      • List Roles
      • Create Role
      • Patch Role
      • Role Details
      • Delete Roles
  • Changelog
    • Changelog
  1. Apps

Creating Apps

POST
https://Example-Server.com/be/v1/apps
Last modified:2025-05-08 12:00:04
This endpoint allows you to register a new app to the ROCKIT Edge.
The following minimal parameter set is required:
name
label

Game Build Rotation#

When registering a new app the maximum number of game builds maxBuilds to be stored can be provided. It controls how many game builds (maxBuilds) and how many patches (maxBuilds-1) are stored. The default value is 5.
When uploading the maxBuilds+1 'th game build the oldest one will be removed from the storage. A larger value may result in higher costs:
object storage for maxBuilds game builds,
object storage for maxBuilds-1 patches, and
compute costs for generating maxBuilds-1 patches.

Required Permissions#

apps.create
See Roles for more details.

Request

Header Params

Body Params application/json

Example
{
    "name": "{{appName}}",
    "label": "{{appLabel}}",
    "maxBuilds": 3,
    "class": "medium",
    "deployments": [
        "Deployment1",
        "Deployment2"
    ],
    "nTracesReliable": 30,
    "minCoverage": 0.2,
    "maxCoverage": 0.6,
    "minTraceTimeSec": 1800,
    "nProcessTracesMin": 30,
    "uploadTrace": true
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://Example-Server.com/be/v1/apps' \
--header 'x-rockit-beauth-token: eyjhvcIhvds;huVODV...' \
--header 'x-rockit-orgname: ExampleOrg' \
--header 'x-rockit-username: adminPrincipal' \
--header 'x-rockit-api-key: {{_adminPrincipal_apiKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "sushi",
    "label": "Sushibar: All you can feed",
    "maxBuilds": 3,
    "class": "medium",
    "deployments": [
        "Deployment1",
        "Deployment2"
    ],
    "nTracesReliable": 30,
    "minCoverage": 0.2,
    "maxCoverage": 0.6,
    "minTraceTimeSec": 1800,
    "nProcessTracesMin": 30,
    "uploadTrace": true
}'

Responses

🟢200200: success
application/json
Body

Example
{
    "status": "success",
    "message": "app created"
}
🟠400400: missing-param
🟠401401: token-expired
🟠409409: item-exists
Modified at 2025-05-08 12:00:04
Previous
Apps
Next
Import native builds
Built with