Sign Up
Loading...

API Limits

API limits help you control how often people can call the endpoints in a workspace. You can set a short-term limit and a monthly allowance.

Set workspace limits

  1. Select the workspace you want to manage.

  2. Open Settings, then API Limits.

  3. Enable API limits.

  4. Under Allowance per, choose user or token.

  5. Set Requests per minute and Requests per calendar month.

  6. Select Save.

This example allows each authenticated user 10 requests per minute and 100 requests per calendar month. Choose allowances that fit your own app.

Set a number to 0 to leave that particular limit unlimited. At least one limit must be greater than zero when limits are enabled.

User or token allowances

User gives an authenticated person one allowance shared across their sessions.

Token gives each verified authentication token its own allowance.

Calls without a verified user or token share one anonymous allowance. Adding an arbitrary request header does not give a caller a new allowance.

When allowances reset

The minute allowance resets at the start of each clock minute. The calendar-month allowance resets on the first day of each month at midnight UTC.

These are the limits you configure for your workspace. Your organization's plan allowance applies separately; do not use these reset dates to calculate a subscription renewal.

Changing the numbers does not clear existing usage. User and token modes have separate usage counters.

What counts

An admitted API call counts even if its workflow later fails. A rejected call does not consume these allowances. Scheduled events, internal function tests and browser preflight calls are excluded.

When a caller exceeds a limit, Twidget returns status 429 and a retry time. Your app should explain the limit and wait before trying again. If Twidget cannot check limits temporarily, it may return status 503 instead.

Related Topics

Action Stats

Action Stats gives Twidget administrators a history of endpoint calls and event runs. It is an admin tool, rather than a workspace feature available to every team member. Find a run. Open Action Stats in the admin sidebar. Filter by workspace, organization, action type, test or real call, result, st...

Create File Endpoints

Overview. Twidget allows you to create file endpoints, which enable you to manage files in your file store. This feature is designed to streamline your workflow by providing predefined endpoints for common file operations. Creating File Endpoints. To create a file endpoint in Twidget, follow these s...

Creating Authentication Endpoints

Follow these steps to create authentication endpoints in Twidget: Step-by-Step Guide. 1. Navigate to API Tab: - Go to the `API` tab in your Twidget dashboard. 2. Create New Endpoints: - Click on the `Create Endpoints` button located at the top right corner. 3. Select Authentication: - In the newly o...

What is an API

An API (Application Programming Interface) is a set of rules and protocols that allows different software applications to communicate and interact with each other. It defines the methods and data formats that applications can use to request and exchange information, services, or functionalities from...

Custom Endpoints

In addition to generating CRUD (Create, Read, Update, Delete), authentication, and file management endpoints, Twidget allows you to create completely custom endpoints from scratch. These custom endpoints give you full control over the various aspects of endpoint configuration, including the inputs, ...