Skip to navigation
Developer's GuideRate Limits and Quotas

Forma: Classifications API Rate Limits

View as Markdown

The Forma Classifications API observes a set of rate limits to ensure that all clients get sufficient service and that runaway applications don’t consume excessive resources. You’ll find general information about rate limits in APS Rate Limits and Quotas.

Defaults

If an endpoint is not explicitly listed below, it uses the default rate limit:

  • clientId: 500 requests/minute

Additionally, the gateway applies a global spike-arrest (burst control) limit:

  • spike-arrest: 12,000 requests/minute

Endpoint Rate Limits

Each Classifications API endpoint has its own independent rate limit. Requests to one endpoint do not count against the rate limit of another endpoint.

The following table describes the rate limits for Classifications API endpoints.

EndpointsLimit (req/min)Scope
GET /projects/{project_id}/trees150Per application (clientId)
POST /projects/{project_id}/trees:import4Per application (clientId)
POST /projects/{project_id}/trees/{tree_id}:reimport6Per application (clientId)
GET /projects/{project_id}/trees/{tree_id}150Per application (clientId)
PATCH /projects/{project_id}/trees/{tree_id}20Per application (clientId)
GET /projects/{project_id}/trees/{tree_id}/versions/tip/nodes100Per application (clientId)

Violation Notification

If an application makes an API request that exceeds a rate limit, the Classifications API returns an HTTP 429 error (described in detail in APS Rate Limits and Quotas).

Changing Limits

APS Rate Limits and Quotas describes how to request rate limit changes for APS APIs.

Imported from the Autodesk Platform Services documentation: https://aps.autodesk.com/en/docs/acc/v1/overview/rate-limits/classifications-rate-limits.