Creates a new instance with all needed setup data​
This might take some time
Creates a new instance with all needed setup data This might take some time
application/json
application/grpc
application/grpc-web+proto
Request Body required
instanceName string
firstOrgName string
customDomain string
human object
machine object
defaultLanguage string
Request Body required
instanceName string
firstOrgName string
customDomain string
human object
machine object
defaultLanguage string
Request Body required
instanceName string
firstOrgName string
customDomain string
human object
machine object
defaultLanguage string
Responses
- 200
- 403
- 404
- default
A successful response.
application/json
application/grpc
application/grpc-web+proto
Schema
Example (from schema)
Schema
instanceId string
details object
pat string
machineKey byte
{
"instanceId": "string",
"details": {
"sequence": "2",
"creationDate": "2024-06-17T09:46:04.893Z",
"changeDate": "2024-06-17T09:46:04.893Z",
"resourceOwner": "69629023906488334"
},
"pat": "string",
"machineKey": "string"
}
Schema
Example (from schema)
Schema
instanceId string
details object
pat string
machineKey byte
{
"instanceId": "string",
"details": {
"sequence": "2",
"creationDate": "2024-06-17T09:46:04.893Z",
"changeDate": "2024-06-17T09:46:04.893Z",
"resourceOwner": "69629023906488334"
},
"pat": "string",
"machineKey": "string"
}
Schema
Example (from schema)
Schema
instanceId string
details object
pat string
machineKey byte
{
"instanceId": "string",
"details": {
"sequence": "2",
"creationDate": "2024-06-17T09:46:04.893Z",
"changeDate": "2024-06-17T09:46:04.893Z",
"resourceOwner": "69629023906488334"
},
"pat": "string",
"machineKey": "string"
}
Returned when the user does not have permission to access the resource.
application/json
application/grpc
application/grpc-web+proto
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Returned when the resource does not exist.
application/json
application/grpc
application/grpc-web+proto
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
An unexpected error response.
application/json
application/grpc
application/grpc-web+proto
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
POST /instances/_create
Request
Request
curl / cURL
curl -L -X POST 'https://$CUSTOM-DOMAIN/system/v1/instances/_create' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"instanceName": "string",
"firstOrgName": "string",
"customDomain": "string",
"human": {
"userName": "string",
"email": {
"email": "string",
"isEmailVerified": true
},
"profile": {
"firstName": "string",
"lastName": "string",
"preferredLanguage": "string"
},
"password": {
"password": "string",
"passwordChangeRequired": true
}
},
"machine": {
"userName": "string",
"name": "string",
"personalAccessToken": {
"expirationDate": "2519-04-01T08:45:00.000000Z"
},
"machineKey": {
"type": "KEY_TYPE_UNSPECIFIED",
"expirationDate": "2519-04-01T08:45:00.000000Z"
}
},
"defaultLanguage": "string"
}'
python / requests
curl -L -X POST 'https://$CUSTOM-DOMAIN/system/v1/instances/_create' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"instanceName": "string",
"firstOrgName": "string",
"customDomain": "string",
"human": {
"userName": "string",
"email": {
"email": "string",
"isEmailVerified": true
},
"profile": {
"firstName": "string",
"lastName": "string",
"preferredLanguage": "string"
},
"password": {
"password": "string",
"passwordChangeRequired": true
}
},
"machine": {
"userName": "string",
"name": "string",
"personalAccessToken": {
"expirationDate": "2519-04-01T08:45:00.000000Z"
},
"machineKey": {
"type": "KEY_TYPE_UNSPECIFIED",
"expirationDate": "2519-04-01T08:45:00.000000Z"
}
},
"defaultLanguage": "string"
}'
go / native
curl -L -X POST 'https://$CUSTOM-DOMAIN/system/v1/instances/_create' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"instanceName": "string",
"firstOrgName": "string",
"customDomain": "string",
"human": {
"userName": "string",
"email": {
"email": "string",
"isEmailVerified": true
},
"profile": {
"firstName": "string",
"lastName": "string",
"preferredLanguage": "string"
},
"password": {
"password": "string",
"passwordChangeRequired": true
}
},
"machine": {
"userName": "string",
"name": "string",
"personalAccessToken": {
"expirationDate": "2519-04-01T08:45:00.000000Z"
},
"machineKey": {
"type": "KEY_TYPE_UNSPECIFIED",
"expirationDate": "2519-04-01T08:45:00.000000Z"
}
},
"defaultLanguage": "string"
}'
nodejs / axios
curl -L -X POST 'https://$CUSTOM-DOMAIN/system/v1/instances/_create' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"instanceName": "string",
"firstOrgName": "string",
"customDomain": "string",
"human": {
"userName": "string",
"email": {
"email": "string",
"isEmailVerified": true
},
"profile": {
"firstName": "string",
"lastName": "string",
"preferredLanguage": "string"
},
"password": {
"password": "string",
"passwordChangeRequired": true
}
},
"machine": {
"userName": "string",
"name": "string",
"personalAccessToken": {
"expirationDate": "2519-04-01T08:45:00.000000Z"
},
"machineKey": {
"type": "KEY_TYPE_UNSPECIFIED",
"expirationDate": "2519-04-01T08:45:00.000000Z"
}
},
"defaultLanguage": "string"
}'
ruby / Net::HTTP
curl -L -X POST 'https://$CUSTOM-DOMAIN/system/v1/instances/_create' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"instanceName": "string",
"firstOrgName": "string",
"customDomain": "string",
"human": {
"userName": "string",
"email": {
"email": "string",
"isEmailVerified": true
},
"profile": {
"firstName": "string",
"lastName": "string",
"preferredLanguage": "string"
},
"password": {
"password": "string",
"passwordChangeRequired": true
}
},
"machine": {
"userName": "string",
"name": "string",
"personalAccessToken": {
"expirationDate": "2519-04-01T08:45:00.000000Z"
},
"machineKey": {
"type": "KEY_TYPE_UNSPECIFIED",
"expirationDate": "2519-04-01T08:45:00.000000Z"
}
},
"defaultLanguage": "string"
}'
csharp / RestSharp
curl -L -X POST 'https://$CUSTOM-DOMAIN/system/v1/instances/_create' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"instanceName": "string",
"firstOrgName": "string",
"customDomain": "string",
"human": {
"userName": "string",
"email": {
"email": "string",
"isEmailVerified": true
},
"profile": {
"firstName": "string",
"lastName": "string",
"preferredLanguage": "string"
},
"password": {
"password": "string",
"passwordChangeRequired": true
}
},
"machine": {
"userName": "string",
"name": "string",
"personalAccessToken": {
"expirationDate": "2519-04-01T08:45:00.000000Z"
},
"machineKey": {
"type": "KEY_TYPE_UNSPECIFIED",
"expirationDate": "2519-04-01T08:45:00.000000Z"
}
},
"defaultLanguage": "string"
}'
php / cURL
curl -L -X POST 'https://$CUSTOM-DOMAIN/system/v1/instances/_create' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"instanceName": "string",
"firstOrgName": "string",
"customDomain": "string",
"human": {
"userName": "string",
"email": {
"email": "string",
"isEmailVerified": true
},
"profile": {
"firstName": "string",
"lastName": "string",
"preferredLanguage": "string"
},
"password": {
"password": "string",
"passwordChangeRequired": true
}
},
"machine": {
"userName": "string",
"name": "string",
"personalAccessToken": {
"expirationDate": "2519-04-01T08:45:00.000000Z"
},
"machineKey": {
"type": "KEY_TYPE_UNSPECIFIED",
"expirationDate": "2519-04-01T08:45:00.000000Z"
}
},
"defaultLanguage": "string"
}'
java / OkHttp
curl -L -X POST 'https://$CUSTOM-DOMAIN/system/v1/instances/_create' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"instanceName": "string",
"firstOrgName": "string",
"customDomain": "string",
"human": {
"userName": "string",
"email": {
"email": "string",
"isEmailVerified": true
},
"profile": {
"firstName": "string",
"lastName": "string",
"preferredLanguage": "string"
},
"password": {
"password": "string",
"passwordChangeRequired": true
}
},
"machine": {
"userName": "string",
"name": "string",
"personalAccessToken": {
"expirationDate": "2519-04-01T08:45:00.000000Z"
},
"machineKey": {
"type": "KEY_TYPE_UNSPECIFIED",
"expirationDate": "2519-04-01T08:45:00.000000Z"
}
},
"defaultLanguage": "string"
}'
powershell / RestMethod
curl -L -X POST 'https://$CUSTOM-DOMAIN/system/v1/instances/_create' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"instanceName": "string",
"firstOrgName": "string",
"customDomain": "string",
"human": {
"userName": "string",
"email": {
"email": "string",
"isEmailVerified": true
},
"profile": {
"firstName": "string",
"lastName": "string",
"preferredLanguage": "string"
},
"password": {
"password": "string",
"passwordChangeRequired": true
}
},
"machine": {
"userName": "string",
"name": "string",
"personalAccessToken": {
"expirationDate": "2519-04-01T08:45:00.000000Z"
},
"machineKey": {
"type": "KEY_TYPE_UNSPECIFIED",
"expirationDate": "2519-04-01T08:45:00.000000Z"
}
},
"defaultLanguage": "string"
}'