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"
}

Additional Metadata

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}