Acronis Tenants API
Tenant hierarchy management and configuration
Operations 36
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Ask an LLM
“How do I pull details for a list of tenants by their UUIDs in one call?”
“Can I get every child tenant under a parent tenant, including deleted ones?”
Tell an agent
Fetch the tenants with UUIDs {uuids}.
List the child tenants of parent tenant {parent_id}.
Ask an LLM
“How do I create a new customer tenant under my partner account?”
“What kinds of tenant can I create, and do I need a parent tenant?”
Tell an agent
Create a {kind} tenant named {name} under parent tenant {parent_id}.
Create a new tenant {name} of kind {kind} under {parent_id} with external customer ID {customer_id}.
GET
/tenants/applications
List application IDs for several tenants · Fetch tenants applications batch
#
Ask an LLM
“Which applications are enabled for each of these tenants at once?”
“Can I get the application UUIDs for a batch of tenants in a single request?”
Tell an agent
Get the application UUIDs for tenants {tenants}.
Show which applications each of tenants {tenants} has.
GET
/tenants/offering_items
Fetch offering items across a tenant tree · Fetch tenant offering items batch
#
Ask an LLM
“How can I see offering items and quotas for every tenant below a given tenant?”
“Can I filter offering items across a tenant subtree by edition or usage name?”
Tell an agent
List offering items and quotas for all tenants under {subtree_root_tenant_id}.
Fetch offering items in edition {editions} across the tenant tree rooted at {subtree_root_tenant_id}.
Ask an LLM
“Can I get usage figures for a batch of tenants at the same time?”
“What usage has each of my customer tenants consumed, filtered by usage name?”
Tell an agent
Get usages for tenants {tenants}.
Fetch the {usage_names} usage for tenants {tenants}.
Ask an LLM
“How do I report usage values for my tenants from an external integration?”
“Can usage be reported per resource rather than per tenant?”
Tell an agent
Report these usage values for my tenants: {items}.
Push updated usage counters {items} for the offering items.
Ask an LLM
“How do I delete a customer tenant I no longer need?”
“Can a deleted tenant be brought back later?”
Tell an agent destructive · confirm first
Delete tenant {tenant_id} at version {version}.
Remove tenant {tenant_id} from the hierarchy.
Ask an LLM
“How do I rename a tenant or disable it?”
“Can I change a tenant's preferred language or external customer ID?”
Tell an agent
Rename tenant {tenant_id} to {name} using version {version}.
Disable tenant {tenant_id} (version {version}) by setting enabled to {enabled}.
Ask an LLM
“How do I look up a single tenant by its ID?”
“Can I see a tenant's full path in the hierarchy when I fetch it?”
Tell an agent
Show me tenant {tenant_id}.
Fetch tenant {tenant_id} with its path embedded, even if it was deleted.
GET
/tenants/{tenant_id}/offering_items
List a tenant's offering items and quotas · Fetch tenant offering items
#
Ask an LLM
“What services and quotas are turned on for this one tenant?”
“Can I see only the active offering items for a tenant in a given edition?”
Tell an agent
List the offering items and quotas for tenant {tenant_id}.
Show active offering items of edition {edition} for tenant {tenant_id}.
PUT
/tenants/{tenant_id}/offering_items
Set a tenant's offering items and quotas · Set tenant offering items
#
Ask an LLM
“How do I turn on a service and set its quota for a customer tenant?”
“Can I check whether an offering item is still in use before switching it off?”
Tell an agent
Set offering items {offering_items} for tenant {tenant_id}.
Update quotas on tenant {tenant_id} to {offering_items}, checking usage first.
GET
/tenants/{tenant_id}/offering_items/available_for_child
Preview offering items for a new child tenant · Fetch offering items available for tenant child
#
Ask an LLM
“Which offering items would a new child tenant under this tenant be able to get?”
“What services are available to a customer-kind child of my partner tenant?”
Tell an agent
Show offering items available for a child of tenant {tenant_id}.
List what a {kind} child tenant under {tenant_id} could be given.
GET
/tenants/{tenant_id}/offering_items/pricing
Get a tenant's offering item prices · Fetch tenant offering items prices
#
Ask an LLM
“What prices are set on the offering items for this tenant?”
“Can I see per-item pricing a partner charges a customer tenant?”
Tell an agent
Show offering item prices for tenant {tenant_id}.
Get the price list of tenant {tenant_id}'s offering items.
PUT
/tenants/{tenant_id}/offering_items/pricing
Update a tenant's offering item prices · Update tenant offering items prices
#
Ask an LLM
“How do I change what a tenant is charged for each offering item?”
“Can I update several offering item prices for a tenant at once?”
Tell an agent
Set offering item prices for tenant {tenant_id} to {items}.
Update tenant {tenant_id}'s item pricing with {items}.
GET
/tenants/{tenant_id}/edition
Check if a tenant can switch edition · Perform tenant edition switch check
#
Ask an LLM
“Before switching editions, can I check whether a tenant is able to move to the target one?”
“What would block a tenant from changing to another edition of an application?”
Tell an agent
Check whether tenant {tenant_id} can switch application {application_id} to edition {target_edition}.
Run an edition switch check for {tenant_id} to {target_edition} on {application_id}.
Ask an LLM
“How do I move a customer tenant to a different edition?”
“Can I change the edition for just one application on a tenant?”
Tell an agent
Switch tenant {tenant_id} to edition {target_edition} for application {application_id}.
Move {tenant_id} onto the {target_edition} edition of {application_id} now.
GET
/tenants/{tenant_id}/registration_tokens
List a tenant's registration tokens · Fetch registration tokens 1
#
Ask an LLM
“Which agent registration tokens exist for this tenant?”
“Can I see the registration tokens issued under a specific tenant?”
Tell an agent
List registration tokens for tenant {tenant_id}.
Show the tokens tenant {tenant_id} can use to register agents.
POST
/tenants/{tenant_id}/registration_tokens
Create a registration token for a tenant · Create registration token 1
#
Ask an LLM
“How do I generate a token so machines can register agents under a tenant?”
“What is the longest expiry a tenant registration token can have?”
Tell an agent
Create a registration token for tenant {tenant_id} expiring in {expires_in} seconds with scopes {scopes}.
Issue tenant {tenant_id} an agent registration token scoped to {scopes}, valid {expires_in} seconds.
GET
/tenants/{tenant_id}/applications
List applications available to a tenant · Fetch available tenant applications
#
Ask an LLM
“What applications can this tenant use?”
“Can I get a tenant's available applications formatted for a UI?”
Tell an agent
List applications available to tenant {tenant_id}.
Show which applications tenant {tenant_id} has access to.
Ask an LLM
“How do I get all the users that belong to a tenant?”
“Can I include hidden or deleted users when listing a tenant's users?”
Tell an agent
List the user UUIDs in tenant {tenant_id}.
Get users of tenant {tenant_id} ordered by {order}.
Ask an LLM
“What child tenants sit directly under this tenant?”
“Can I page through the child tenant UUIDs of one tenant, sorted by name?”
Tell an agent
List the child tenant UUIDs of tenant {tenant_id}.
Show children of {tenant_id} ordered by {order}.
Ask an LLM
“Which reports can this tenant access?”
“Can I get the report IDs configured for a tenant?”
Tell an agent
List the reports available to tenant {tenant_id}.
Get report UUIDs for tenant {tenant_id}.
GET
/tenants/{tenant_id}/locations
List infrastructure locations a tenant owns · Fetch tenant infrastructure locations
#
Ask an LLM
“Which infrastructure locations does this tenant own?”
“Can I see the data center locations registered to a tenant?”
Tell an agent
List infrastructure locations owned by tenant {tenant_id}.
Show tenant {tenant_id}'s locations.
Ask an LLM
“How much storage and how many workloads has this one tenant used?”
“Can I filter a single tenant's usage by edition?”
Tell an agent
Show usage metrics for tenant {tenant_id}.
Get tenant {tenant_id}'s {usage_names} usage.
Ask an LLM
“What pricing mode and currency is this tenant set up with?”
“Can I check whether a tenant is on trial or production pricing?”
Tell an agent
Show pricing settings for tenant {tenant_id}.
Get the pricing mode and currency of tenant {tenant_id}.
PUT
/tenants/{tenant_id}/pricing
Change a tenant's pricing mode or currency · Update tenant pricing settings
#
Ask an LLM
“How do I change the pricing mode for a tenant?”
“Can I set the currency used for a tenant's offering item prices?”
Tell an agent
Set tenant {tenant_id}'s pricing mode to {mode} (version {version}).
Change the pricing currency of {tenant_id} to {currency} at version {version}.
Ask an LLM
“How do I remove white-label branding from a tenant?”
“Can I revert a tenant to default branding?”
Tell an agent destructive · confirm first
Disable custom branding for tenant {tenant_id} at version {version}.
Turn off white-labeling on {tenant_id}.
Ask an LLM
“What white-label branding is configured for this tenant?”
“Can I see the brand a tenant inherits from its parent?”
Tell an agent
Show the branding options for tenant {tenant_id}.
Get the effective inherited brand for tenant {tenant_id}.
Ask an LLM
“How do I enable white-label branding for my partner tenant?”
“Why can't custom branding be enabled on a customer or unit tenant?”
Tell an agent
Enable custom branding for tenant {tenant_id} at version {version}.
Switch on white-labeling for {tenant_id}.
Ask an LLM
“How do I change the support URL and company name shown to my customers?”
“Can I override the SMTP server used for branded emails?”
Tell an agent
Set tenant {tenant_id}'s brand company name to {company_name} (version {version}).
Update the support URL for tenant {tenant_id}'s brand to {support_url}.
Ask an LLM
“Can I download the logo a tenant uses in its branding?”
“Where do I get the current brand logo image for a tenant?”
Tell an agent
Download the brand logo of tenant {tenant_id}.
Fetch {tenant_id}'s logo image.
POST
/tenants/{tenant_id}/brand/logo
Upload a new brand logo for a tenant · Upload tenant brand logo
#
Ask an LLM
“How do I upload my company logo for white-labeled branding?”
“Can I replace a tenant's brand logo with a new image?”
Tell an agent
Upload a new logo for tenant {tenant_id} at version {version}.
Replace {tenant_id}'s brand logo with this image of {Content-Length} bytes.
Ask an LLM
“How do I enforce multi-factor authentication for a whole tenant?”
“Can MFA be toggled on folder or unit tenants?”
Tell an agent
Set MFA for tenant {tenant_id} to {enabled}.
Enable two-factor authentication for tenant {tenant_id}.
Ask an LLM
“Is two-factor authentication turned on for this tenant?”
“How many users in a tenant have finished setting up TOTP?”
Tell an agent
Show MFA status for tenant {tenant_id}.
Check TOTP enrollment progress for users in {tenant_id}.
PUT
/tenants/{tenant_id}/default_idp
Set a tenant's default identity provider · Update tenant default idp id
#
Ask an LLM
“How do I change which identity provider a tenant signs in with by default?”
“Can a new default identity provider be applied to child tenants too?”
Tell an agent
Set identity provider {idp_id} as default for tenant {tenant_id} (version {version}), applying to children: {apply_to_children}.
Make {idp_id} the default IdP of {tenant_id}.
Ask an LLM
“Can I undo the deletion of a tenant?”
“What happens if restoring a deleted tenant runs into a conflict?”
Tell an agent
Restore deleted tenant {tenant_id}.
Force-restore tenant {tenant_id} even if there is a conflict.
Documentation
📖
Documentation
https://developer.acronis.com/doc/outbound/apis/api-library/account/index.html
📖
Documentation
https://developer.acronis.com/doc/agents/v2/reference/index.html
📖
Documentation
https://developer.acronis.com/doc/tasks/v2/guide/index.html
📖
APIReference
https://developer.acronis.com/doc/account-management/v2/reference/index.html