Create Organization

POST

https://Example-Server.com/adm/v1/orgs

Last modified:2025-10-15 13:32:51

This endpoint allows you to create a new organization in ROCKIT Edge, along with a default role 'Administrators' and its primary administrator user account. By calling this endpoint ROCKITPLAY sends an invitation email to the specified address. By confirming the email address the account will be enabled.

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

ssh-keygen -t rsa -b 4096 -m PEM -f <customer>.rockitplay.priv.pem

rm <customer>.rockitplay.priv.pem.pub (optional)

openssl rsa -in <customer>.rockitplay.priv.pem -pubout -outform PEM -out <customer>.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

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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"
}

🟠401401: unauthorized

🟠400400: invalid-param

🟠409409: item-exists

Modified at 2025-10-15 13:32:51

submit test task

Delete Organization

Create Organization

Generating a public/private keypair#

Request

Request Code Samples

Responses

Generating a public/private keypair