ROCKITPLAY API
  1. Authentication
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
        POST
      • authentication
        POST
    • 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
      • Import native builds
      • App Details
      • List Apps
      • patch app
      • Delete Apps
    • 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. Authentication

user login

POST
https://Example-Server.com/be/v1/login
Last modified:2025-06-28 14:54:15
This endpoint allows a user to obtain a session token. The session token is valid for 24h. It is used to create short-time auth tokens which will grant access to the protected endpoints of the ROCKIT Edge API.
On success the endpoint returns the session token as well as the permissions to the individual resources of ROCKIT Edge. These are
apps
ROCKIT-enabled Apps
beUsers
Backend users
tasks
Compute tasks
If the ROCKIT Edge is working together with ROCKIT StreamInstaller the following additional resources are relevant:
dependencies
3rd-party dependencies which should be installed by the ROCKIT StreamInstaller prior to the game start.
keys
Access keys to authenticate CDN downloads.
The endpoint returns the permissions to each resource, i.e.
create
(apps, beUsers, dependencies, keys)
read
(apps, beUsers, tasks, dependencies, keys)
update
(apps, beUsers, tasks, dependencies, keys)
delete
(apps, beUsers, tasks, dependencies, keys)
execute
(tasks)

Request

Body Params application/json

Example
{
    "orgName": "{{EDGE_ORG_NAME}}",
    "pw": "{{EDGE_ORG_ADMIN_PW}}",
    "username": "{{EDGE_ORG_ADMIN_USERNAME}}"
}

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/login' \
--header 'Content-Type: application/json' \
--data-raw '{
    "orgName": "ExampleOrg",
    "pw": "GDSfhasLfsug...",
    "username": "adminUser"
}'

Responses

🟢200OK
application/json
Body

Example
{
    "status": "success",
    "session": {
        "token": "eyJhbGci...",
        "expires": 1731749654,
        "permissions": {
            "apps": [
                "create",
                "read",
                "update",
                "delete"
            ],
            "beUsers": [
                "create",
                "read",
                "update",
                "delete"
            ],
            "dependencies": [
                "create",
                "read",
                "update",
                "delete"
            ],
            "keys": [
                "create",
                "read",
                "update",
                "delete"
            ],
            "roles": [
                "create",
                "read",
                "update",
                "delete"
            ],
            "subscriptions": [
                "create",
                "read",
                "update",
                "delete"
            ],
            "users": [
                "create",
                "read",
                "update",
                "delete"
            ],
            "tasks": [
                "read",
                "delete",
                "execute"
            ],
            "consumption": [
                "read"
            ]
        }
    }
}
🟠400Invalid Param
🟠401Unauthorized
Modified at 2025-06-28 14:54:15
Previous
Authentication
Next
authentication
Built with