Skip to main content

​
Availability

Our public API is available during Trial and to our customers. Your role must have Public API permission to use it. Start with the quickstart or authentication guide.

​
Base URL

The API origin is https://api.siit.io. Resource endpoints use the /v1 prefix, for example https://api.siit.io/v1/requests. The authentication check is available at https://api.siit.io/ping.

​
Resource IDs

Resources have prefixed unique identifiers (UIDs). Use the complete UID returned by the API in subsequent requests. Legacy UID formats are still supported. This list is not exhaustive. Example UIDs in this documentation are placeholders; replace them with IDs from your workspace.

​
Relationships and expansion

For relationship fields, send the related resource’s UID when writing. For example, the requested_by field on a request takes a user UID, and target takes a service UID. Where supported, use expand[] to receive a related object instead of its UID. Each endpoint’s schema describes the available fields.
Pass each array query value separately, as shown above. The cURL examples assume SIIT_API_KEY is set in your local environment.

​
Rate limiting

The default limit is 60 requests per minute per bearer token. Calls sharing a token share its quota. Contact us through the help center if you need a higher quota, and use the returned headers to read the limit applied to your token. When the quota is exhausted, the API returns HTTP 429 with the plain-text body Throttled. Wait until X-SiitApi-Reset before retrying. Coordinate retries across workers that share a token, and add a small random delay to avoid retrying simultaneously. For other failures and retry considerations, see Errors.