Skip to main content

Terms and Usage Guidelines

This page consolidates the practical operating rules developers usually need before a build moves toward production.

Terms and conditions​

Use your organization's SpotDraft legal and commercial terms as the source of truth for API usage rights and plan entitlements.

For general product terms, start here:

If your organization has customer-specific commercial terms, follow those over any generic public reference.

API rate limit​

SpotDraft applies a public API rate limit of 10 requests per second per workspace. See Rate limits for details.

Retry behavior​

Integrations should assume:

  • API calls can fail transiently
  • retries must be bounded and idempotent
  • polling should not replace webhooks as the primary lifecycle signal

Use exponential backoff with jitter for 429, timeouts, and 5xx responses. Do not blindly retry validation, authentication, permission, or not-found errors without changing the request.

Environment usage rules​

Apply these rules consistently:

  • keep QA and production credentials separate
  • register webhook endpoints separately per environment
  • do not assume workflows or metadata fields exist in every environment
  • validate integrations in the target environment before any go-live claim

Use Environments for the detailed checklist.

Supported developer workflow​

See the Quickstart for the recommended path from your first request to a working integration.

Developer resources​