By introducing our Public API, we are providing organizations with the ability to make API calls to SpinOne through external systems, gaining visibility on which entities are protected, and having the ability to change their status.
Swagger links:
AWS Customers: https://apg-1.spin.ai/swagger-ui/
GCP Customers: https://apg-2.spin.ai/swagger-ui/
Azure Customers: https://apg-3.spin.ai/swagger-ui/
Structure
The integration is only available on the SpinOne subscription.
The following calls will be able to me made:
-
Get - get a list of all entities
- /api/v1/integration/backup/entities/all
-
Filter - filters the list of all entities detected
- /api/v1/integration/backup/entities/filter
-
Update - changes the status of selected entities
- Statuses available: ACTIVE, ARCHIVED, DISABLED
- /api/v1/integration/backup/entity/status
The following scopes are able to be selected for the integration:
-
Entity.Read.All
- Ability to read all entities on the SpinOne account
-
Entity.ReadWrite.All
- Ability to read and update status of all entities on the SpinOne account
To make the connection, the following is required:
- API URL
- API Key
- Client ID
The authorization format is the following:
- SPIN_API X-APP-ID={appIdValue},X-API-KEY={apiKeyValue}
- Note: remove brackets after entering values
Guide
Head to the Integrations center from the left panel of your SpinOne console.
Click View connections on the API widget.
Click Add connection from the top right.
Enter a Title for the Integration Name
Select necessary Scopes for the integration
Click Generate credentials
Record the API URL, API key and the Client ID
Create the integration