Chapter Scope Resolver
API Contract
REST
/api/v1/chapter-scope
8 endpoints
GET
/api/v1/chapter-scope/api/v1/chapter-scope
List all coordinator scope records
Public
Response Example
{
"data": [
{
"coordinator_id": "usr_coord_9b1c",
"chapter_ids": [
"chp_oslo_01",
"chp_bergen_03"
],
"resolved_at": "2026-03-26T09:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1
}
}
GET
/api/v1/chapter-scope/api/v1/chapter-scope/:coordinatorId
Get all chapter IDs in scope for a coordinator
Public
Response Example
{
"coordinator_id": "usr_coord_9b1c",
"chapter_ids": [
"chp_oslo_01",
"chp_bergen_03"
],
"resolved_at": "2026-03-26T09:00:00Z"
}
POST
/api/v1/chapter-scope/api/v1/chapter-scope
Register a coordinator's chapter scope
Public
Request Example
{
"coordinator_id": "usr_coord_9b1c",
"chapter_ids": [
"chp_oslo_01",
"chp_bergen_03"
]
}
Response Example
{
"coordinator_id": "usr_coord_9b1c",
"chapter_ids": [
"chp_oslo_01",
"chp_bergen_03"
],
"resolved_at": "2026-03-26T09:01:00Z"
}
PUT
/api/v1/chapter-scope/api/v1/chapter-scope/:coordinatorId
Update a coordinator's chapter scope
Public
Request Example
{
"chapter_ids": [
"chp_oslo_01",
"chp_bergen_03",
"chp_trondheim_02"
]
}
Response Example
{
"coordinator_id": "usr_coord_9b1c",
"chapter_ids": [
"chp_oslo_01",
"chp_bergen_03",
"chp_trondheim_02"
],
"resolved_at": "2026-03-26T09:05:00Z"
}
DELETE
/api/v1/chapter-scope/api/v1/chapter-scope/:coordinatorId
Remove a coordinator's scope record and invalidate cache
Public
Response Example
{
"deleted": true,
"coordinator_id": "usr_coord_9b1c"
}
GET
/api/v1/chapter-scope/api/v1/chapter-scope/:coordinatorId/chapters/:chapterId/membership
Check whether a specific chapter is in scope for a coordinator
Public
Response Example
{
"coordinator_id": "usr_coord_9b1c",
"chapter_id": "chp_oslo_01",
"in_scope": true
}
GET
/api/v1/chapter-scope/api/v1/chapter-scope/labels
Get human-readable labels for a set of chapter IDs
Public
Response Example
{
"labels": {
"chp_oslo_01": "Oslo Sør",
"chp_bergen_03": "Bergen Nord",
"chp_trondheim_02": "Trondheim Sentrum"
}
}
DELETE
/api/v1/chapter-scope/api/v1/chapter-scope/:coordinatorId/cache
Invalidate cached chapter scope for a coordinator
Public
Response Example
{
"invalidated": true,
"coordinator_id": "usr_coord_9b1c",
"invalidated_at": "2026-03-26T10:00:00Z"
}