Api Limit Policies Partial Update

PATCH

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

PATCH

/api/limit-policies/

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

200Updated

1 {
2   "id": "a3f1c9d2-7b4e-4f8a-9c3d-2e5f7a1b9cde",
3   "name": "Monthly API Request Limit",
4   "scope": "organization",
5   "scope_value": "org_12345",
6   "compose": null,
7   "metric": "request_count",
8   "algorithm": "balance_fixed_window",
9   "period": "P1M",
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": 100000,
15   "meter_definition_id": "meter_def_7890",
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_def_7890:1704067200",
28     "interval_start": 1704067200,
29     "interval_end": 1706745600,
30     "current_value": 45230.5
31   },
32   "tags": [
33     {
34       "id": "tag_001",
35       "name": "critical",
36       "color": "#FF0000",
37       "created_at": "2023-11-15T10:00:00Z",
38       "updated_at": "2024-03-20T14:30:00Z"
39     }
40   ]
41 }

PATCH handler with superadmin lock and field protection.

Checks:

Object lock (is_managed=True -> non-superadmins can’t modify)
Field protection (non-superadmins can’t modify specific fields)

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.