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

ssh-keygen -t rsa -b 4096 -m PEM -f .rockitplay.priv.pem
rm .rockitplay.priv.pem.pub (optional)
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 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"
}

🟠400400: invalid-param

🟠401401: unauthorized

🟠409409: item-exists

Modified at 2025-07-07 16:25:10

submit test task

Delete Organization