ROCKITPLAY API
  1. Admin Edge Organizations
ROCKITPLAY API
  • ROCKIT Edge - Admin API
    • Minimal Tests
      • ping
      • submit test task
    • Admin Edge Organizations
      • Create Organization
        POST
      • Delete Organization
        DELETE
  • 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
      • 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. Admin Edge Organizations

Create Organization

POST
https://Example-Server.com/adm/v1/orgs
Last modified:2025-07-07 16:25:10

This endpoint allows you to create a new organization in ROCKIT Edge, along with a default role 'Administrators' and its primary administrator user account. On success, it will return the initial password of the organization's administrator user.

Authentication is required via the x-rockit-admin-token header, which must contain a valid administrator token for ROCKIT Edge.

Generating a public/private keypair

  1. ssh-keygen -t rsa -b 4096 -m PEM -f .rockitplay.priv.pem
  2. rm .rockitplay.priv.pem.pub (optional)
  3. openssl rsa -in .rockitplay.priv.pem -pubout -outform PEM -out .rockitplay.pub.pem

Request

Header Params

Body Params application/json

Example
{
    "name" : "{{EDGE_ORG_NAME}}",
    "label" : "{{EDGE_ORG_LABEL}}",
    "username" : "{{EDGE_ORG_ADMIN_USERNAME}}",
    "email" : "{{EDGE_ORG_ADMIN_EMAIL}}",
    "firstname" : "{{EDGE_ORG_ADMIN_FIRSTNAME}}",
    "surname" : "{{EDGE_ORG_ADMIN_SURNAME}}",
    "dxorglnk" : "{{EDGE_DXORGLNK}}",
    "orgPrivPemB64" : "{{EDGE_ORG_PRIV_PEM_B64}}",
    "orgPrivPW" : "{{EDGE_ORG_PRIV_PW}}"
}

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/adm/v1/orgs' \
--header 'x-rockit-admin-token: eyAHFjsnk...' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name" : "ExampleOrg",
    "label" : "Example Organization",
    "username" : "adminUser",
    "email" : "admin@example.org",
    "firstname" : "John",
    "surname" : "Doe",
    "dxorglnk" : "dxorglnk.ExampleOrg.jAhjafhdsaAS....",
    "orgPrivPemB64" : "HhdsjSDsdfJF...",
    "orgPrivPW" : "examplePrivateKeyPassword"
}'

Responses

🟢200200: success
application/json
Body

Example
{
    "status": "success",
    "message": "organization created",
    "adminPW": ":0-)IrG:kLDvr2"
}
🟠400400: invalid-param
🟠401401: unauthorized
🟠409409: item-exists
Modified at 2025-07-07 16:25:10
Previous
submit test task
Next
Delete Organization
Built with