List Rule Set Versions

Returns version history for a stable rule set ID. Published versions are read-only. At most one draft version can exist at a time.

Endpoints

GET /v1/projects/:project_id/extractor-rule-sets/:id/versions
GET /v1/projects/:project_id/pricing-rule-sets/:id/versions

Authentication

Authorization: Bearer <api-key>

Requires rules read access.

Request

The request body is empty. There are no query parameters.

Path Parameters

Field	Required	Description
project_id	Yes	Project that owns the rule set.
id	Yes	Stable rule set ID.

Response

{
  "versions": [
    {
      "id": "ers_openai",
      "version": 3,
      "status": "draft",
      "name": "OpenAI extractor",
      "effective_from": 1783008000,
      "created_at": 1783010000,
      "updated_at": 1783010200
    },
    {
      "id": "ers_openai",
      "version": 2,
      "status": "published",
      "published_at": 1783009000,
      "created_at": 1783008500,
      "updated_at": 1783009000
    }
  ]
}

Use the currently published version for ingestion. A draft is editable but does not affect runtime until publish.