Generated by API Evangelist
Written by API Evangelist tooling for Acronis's API. It is a proposal applied on top of the contract, not a document Acronis publishes.
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
title: API Evangelist conversational phrasing for File Sync & Share Devices API
version: 1.0.0
extends: openapi/acronis-devices-api-openapi.yml
actions:
- target: $.info
update:
x-apievangelist-phrasing:
method: generated
generated: '2026-09-26'
generator: build-phrasing.py
label: Generated by API Evangelist
operations: 4
- target: $.paths['/devices'].get
update:
x-apievangelist-phrasing:
intent: List devices
effect: read
questions:
- How do I list all devices in a tenant?
- Can I page through devices a set number at a time?
instructions:
- text: List devices in tenant {tenant_id}.
slots:
tenant_id: query.tenant_id
- text: Show page {page} of devices, {per_page} per page.
slots:
page: query.page
per_page: query.per_page
method: generated
generated: '2026-09-26'
- target: $.paths['/devices/{device_uuid}'].get
update:
x-apievangelist-phrasing:
intent: Get a device's details
effect: read
questions:
- What information is recorded for this device?
- Can I look up a device by its UUID?
instructions:
- text: Show device {device_uuid}.
slots:
device_uuid: path.device_uuid
- text: Get information about device {device_uuid} in tenant {tenant_id}.
slots:
device_uuid: path.device_uuid
tenant_id: query.tenant_id
method: generated
generated: '2026-09-26'
- target: $.paths['/devices/{device_uuid}'].put
update:
x-apievangelist-phrasing:
intent: Update a device
effect: write
questions:
- How do I change a device's details?
- Can I update a device record within a specific tenant?
instructions:
- text: Update device {device_uuid} with {device}.
slots:
device_uuid: path.device_uuid
device: requestBody.device
- text: Save changes {device} to device {device_uuid}.
slots:
device: requestBody.device
device_uuid: path.device_uuid
method: generated
generated: '2026-09-26'
- target: $.paths['/devices/{device_uuid}'].delete
update:
x-apievangelist-phrasing:
intent: Delete a device
effect: destructive
questions:
- How do I remove a device?
- Can I delete a device from a specific tenant?
instructions:
- text: Delete device {device_uuid}.
slots:
device_uuid: path.device_uuid
- text: Remove device {device_uuid} from tenant {tenant_id}.
slots:
device_uuid: path.device_uuid
tenant_id: query.tenant_id
method: generated
generated: '2026-09-26'
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.