curl --request POST \
--url https://api.apostra.com/api/v2/accounts/convert-to-organization \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"confirmOrganizationConversion": true
}
'import requests
url = "https://api.apostra.com/api/v2/accounts/convert-to-organization"
payload = { "confirmOrganizationConversion": True }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({confirmOrganizationConversion: true})
};
fetch('https://api.apostra.com/api/v2/accounts/convert-to-organization', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"organizationId": 812,
"accountId": 105,
"alreadyCompleted": false
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Convert account into an organization
Convert the current standalone account into an organization without creating another account. The account becomes the organization’s only account; its contract, billing authority, entitlements, and any sales agent offering move to the organization; the confirming administrator becomes an organization administrator. Requires the account’s own administrator in a signed-in session and explicit confirmation. Retrying resumes an unfinished conversion; a completed conversion returns its result.
curl --request POST \
--url https://api.apostra.com/api/v2/accounts/convert-to-organization \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"confirmOrganizationConversion": true
}
'import requests
url = "https://api.apostra.com/api/v2/accounts/convert-to-organization"
payload = { "confirmOrganizationConversion": True }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({confirmOrganizationConversion: true})
};
fetch('https://api.apostra.com/api/v2/accounts/convert-to-organization', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"organizationId": 812,
"accountId": 105,
"alreadyCompleted": false
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Authorizations
API key or access token
Body
Request body for converting the current standalone account into an organization
Must be true after presenting that the conversion creates an organization, attaches this account to it as the organization's only account, moves contract and billing authority to the organization, makes the confirmer an organization administrator, keeps existing members account-only, applies account-specific standing before inherited organization standing, and cannot be undone without a dedicated migration.
true true
Name for the new organization. Defaults to the account's name.
1 - 255"Acme HQ"
Response
Convert account into an organization
Result of converting a standalone account into an organization
Customer ID of the new organization.
0 < x <= 9007199254740991812
Customer ID of the converted account, now the organization's account.
0 < x <= 9007199254740991105
True when the account had already been converted and this call returned that result.
false