Api Limit Policies Update

PUT

https://api.respan.ai/api/limit-policies/

PUT

/api/limit-policies/

$ curl -X PUT https://api.respan.ai/api/limit-policies/ \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

200Updated

1 {
2   "id": "a3f1c9d2-4b7e-4f8a-9c3d-2e5b7f6a8d9e",
3   "name": "Standard API Request Limit",
4   "scope": "organization",
5   "scope_value": "org_12345",
6   "compose": null,
7   "metric": "cost",
8   "algorithm": "balance_fixed_window",
9   "period": "1h",
10   "effective_at": "2024-01-15T09:30:00Z",
11   "expires_at": "2025-01-15T09:30:00Z",
12   "priority": 10,
13   "is_active": true,
14   "threshold_value": 1500.75,
15   "meter_definition_id": "meter_98765",
16   "updated_by": {
17     "id": 42,
18     "email": "admin@respan.ai",
19     "name": "Alice Johnson",
20     "username": "alice.j",
21     "first_name": "Alice",
22     "last_name": "Johnson"
23   },
24   "created_at": "2023-12-01T08:00:00Z",
25   "updated_at": "2024-04-10T12:45:00Z",
26   "current_state": {
27     "meter_id": "meter_98765:1700000000",
28     "interval_start": 1700000000,
29     "interval_end": 1700003600,
30     "current_value": 450.25
31   },
32   "tags": [
33     {
34       "id": "tag_001",
35       "name": "critical",
36       "color": "#FF0000",
37       "created_at": "2023-11-20T10:15:00Z",
38       "updated_at": "2024-02-05T14:30:00Z"
39     }
40   ]
41 }

PUT handler with superadmin lock and field protection.

Same as patch() - checks lock and field protection before delegating.

Authentication

AuthorizationBearer

JWT access token or Respan API key

Response

idstringRead-only

namestringRead-only

scopestringRead-only

scope_valuestringRead-only

composeanyRead-only

metricenum

cost - Cost
request_count - Request count
token_count - Token count

algorithmenum

balance_fixed_window - Balance fixed window
token_bucket - Token bucket

periodstring or nullRead-only

effective_atdatetime or nullRead-only

expires_atdatetime or nullRead-only

priorityintegerRead-only

is_activebooleanRead-only

threshold_valuedoubleRead-only

meter_definition_idstringRead-only

updated_byobject

created_atdatetimeRead-only

updated_atdatetimeRead-only

current_stateobject

Live counter state for the policy’s current window. Sourced from Redis (same key apply_limits evaluates against). Populated by the view’s bulk prefetch on list responses; falls back to a single HGET on detail.

tagslist of objectsRead-only

GenericTag rows assigned to this policy. Managed via /api/tag-assignments/limit_policies/... — read-only here.