Rate limits

by Tal Bereznitskey

To ensure the stability and reliability of the service, the API will start enforcing rate limits on September 1st 2024. These limits are documented on the respective API endpoint pages in our developer portal.

Learn more on the rate limits page.

An example of a custom integration for Stripe has been added to the Guides section of the community. The example code for this custom integration also has been documented in the Recipes section.

Listing or updating deleted custom Application Fields or fields that have been hidden — will now return an error listing the fields that no longer exist. This will help prevent unexpected behavior when using the API.

The /workflows/actionExecutions endpoint will return additional workflow action executions. In addition to returning a list of user-related workflow action executions in the organization, it will now return a list of all workflow action executions in the organization.

The current GET /users API is limited and does not support pagination. A single API call returns the entire list of users in your organization. For large organizations this could lead to timeouts.

From the 24th of January 2024, the API will support a new torii-version: 1.0.1. This new version supports pagination and sorting using the following new query parameters: sort, size, and cursor. Additionally, the new version will no longer support the minActiveAppsCount parameter.

New tokens created on or after the 23rd of January 2024 will default to the new torii-version: 1.0.1 and will support pagination and sorting.

Tokens created before the 23rd of January 2024 will continue to use the torii-version: 1.0.0 of the API that does not support pagination and returns the full list of users.

To opt-in to the new version, use the following header in your API request:

{  
	"headers": {  
		"torii-version": "1.0.1"  
  }  
}

After the 24th of July 2024, version 1.0.0 of the API will no longer be supported and API calls will use version 1.0.1 by default.
This means that if you make no changes until then, your API calls will return only the first 1000 results. We suggest creating new tokens or using the new header to opt-in to the new version 1.0.1 starting today.

To learn more about pagination and sorting, please refer to the API reference here: https://developers.toriihq.com/reference/pagination.

Owner field deprecation

by Tal Bereznitskey

The owner field is deprecated and will be removed by the end of 2023. Please use primaryOwner instead.

SCIM API

by Tal Bereznitskey

SCIM API has been released

API V1.0 is out of beta

by Tal Bereznitskey

The API version has changed to v1.0. The /beta endpoints are still supported and will provide the same responses as the /v1.0 endpoints. Please use the new v1.0 endpoints moving forward.