Silosset API
Integrate asset management functionality directly into your applications with our comprehensive API.
API Overview
Powerful, flexible, and easy to integrate
The Silosset API provides programmatic access to the full functionality of our asset management platform. Use it to retrieve asset information, update records, manage audits, and integrate asset data with your existing systems.
Our RESTful API accepts and returns JSON, making it easy to integrate with any programming language or framework. All endpoints are versioned to ensure backwards compatibility as we continue to enhance the API.
The API follows standard HTTP conventions, with appropriate response codes, error handling, and rate limiting to ensure stability and reliability.
API Features
- RESTful endpoints for all core Silosset functionality
- JSON request and response format
- API key authentication with organization-level access control
- Detailed error responses with actionable information
- Comprehensive Swagger documentation
Interactive Documentation
Explore our comprehensive API documentation with interactive endpoints, request examples, and response schemas.
Authentication
Secure access to the API
API Keys
The Silosset API uses API keys for authentication. Each API key belongs to a user account and carries exactly that user's permissions — it can access only the organisations the user is a member of, within the same role limits. To use the API, you must include your API key in the X-API-Key header with every request.
How to Request an API Key
API keys are currently issued by the Silosset team. Contact us at support@silosset.com from your account email with a short description of your integration, and we will issue a key for your account. Self-service key management from your account settings is on our roadmap.
Important: Keep your API key secure and never share it publicly. If you believe your key has been compromised, contact us immediately and we will revoke it and issue a replacement.
Authentication Examples
curl -X 'GET' \ 'https://api.silosset.com/api/v1/organisations/org_id/assets/asset_id' \ -H 'accept: application/json' \ -H 'X-API-Key: your_api_key'
import requests
url = "https://api.silosset.com/api/v1/organisations/org_id/assets/asset_id"
headers = {
"accept": "application/json",
"X-API-Key": "your_api_key"
}
response = requests.get(url, headers=headers)
print(response.json())fetch('https://api.silosset.com/api/v1/organisations/org_id/assets/asset_id', {
method: 'GET',
headers: {
'accept': 'application/json',
'X-API-Key': 'your_api_key'
}
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));Rate Limiting & Security
Ensuring API stability and data protection
Rate Limiting
To protect system stability, authentication and other sensitive endpoints are rate limited. Requests that exceed a limit receive a 429 Too Many Requests response — back off and retry after a short delay.
Per-key quotas with rate-limit response headers are on our roadmap. If your integration needs sustained high-volume access, talk to us and we will plan capacity with you.
Security Measures
- HTTPS Encryption
All API requests must use HTTPS to ensure data is encrypted in transit.
- Permission-Scoped Access
An API key carries the permissions of the user it belongs to — it can only reach organisations that user is a member of, with the same role limits.
- API Key Management
Keys are stored hashed and can be revoked at any time on request.
- Change History
Creates, updates, and deletes on your records are stored as history entries showing who changed what and when.