Technical Details | Coperniq API

Rate limits

  • Per second: 100 requests per second per API key.
  • Per day: 5,000 requests per day per API key.
  • Scope: Counts apply to all endpoints that require the x-api-key header; POST /api-keys (key generation) is not counted.
  • If you exceed a limit, the API returns 429 Too Many Requests. Reduce request volume or reach out to support@coperniq.io to request a temporary limit increase.

Rate limit headers

Every authenticated response includes headers so you can track your usage programmatically:

HeaderDescriptionExample
X-RateLimit-LimitMaximum requests allowed in the current period5000
X-RateLimit-RemainingRequests remaining in the current period4832
1HTTP/1.1 200 OK
2X-RateLimit-Limit: 5000
3X-RateLimit-Remaining: 4832

Use these headers to implement backoff logic in your integration and avoid hitting 429 errors.

Note: X-RateLimit-Remaining is an approximate value, not a real-time counter. Usage data from AWS may lag by a few minutes, and the value is cached for up to 60 seconds per API key. Do not rely on it for precise accounting — treat it as a near-term estimate of your remaining quota.

Archiving records

Most records in Coperniq can be archived instead of permanently deleted. Archiving hides a record from default views while keeping its history and relationships intact — a safer default than DELETE, which is often unavailable or irreversible.

To archive a record, use that object’s PATCH endpoint and set isActive to false. To restore it, PATCH again with isActive set to true.

1PATCH /projects/12345 HTTP/1.1
2Host: api.coperniq.io
3x-api-key: YOUR_API_KEY
4Content-Type: application/json
5
6{
7 "isActive": false
8}

Some resources use isArchived instead of isActive — check that resource’s endpoint reference for its exact field name before assuming.