Returns all versions of a rule

GET /v1/{contextId}/rules/{ruleId}/versions

Returns all versions of a rule

Path parameters

  • contextId string Required

    The parent context ID, for example, "contextID1/rules/{rule_id}/versions"

  • ruleId string Required

    The rule ID, for example, "{context_id}/rules/rule1/versions"

Query parameters

  • pageSize integer(int32)

    The maximum number of items to return.

  • pageToken string

    The next_page_token value returned from a previous List request, if any.

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • rules array[object]

      There will be a maximum number of items returned based on the page_size field in the request.

      Hide rules attributes Show rules attributes object
      • id string

        example:"rule_01h89qfdhbejtb3jwqq1gazbm5"

      • version string
      • sequence integer(uint32)

        The sequence number of the rule within the context

      • description string
      • actions array[object]
        Hide actions attributes Show actions attributes object
        • kind string

          The name of the action example:"$set"

        • target object

          The target the action applies to

          Hide target attributes Show target attributes object
          • kind string

            This is what determines the type of the id field's value example:"jsonpath" example:"myTargetKind"

          • id string

            The identifier for the target. It can be a jsonpath a simple property name or an arbitrary third party id example:"$.prop" example:"propKey" example:"target_01h89qgxe5e7wregw6gb94d5p6"

          • value string(bytes)

            The target value to be set (it is the json serialized representation of the value)

        • id string
      • expression object

        A variadic condition expression Expression: type: object oneOf: - $ref: '#/components/schemas/And' - $ref: '#/components/schemas/Or' - $ref: '#/components/schemas/Condition'

        Hide expression attributes Show expression attributes object
        • and object
          Hide and attribute Show and attribute object
          • expression array[object]
        • or object
          Hide or attribute Show or attribute object
          • expression array[object]
        • condition object

          A condition expression

          Hide condition attributes Show condition attributes object
          • key string

            Holds a direct object key to be used the value extraction

          • ref object

            Holds a dref reference (see dalí project for details)

            Hide ref attributes Show ref attributes object
            • src string
            • dst string
            • value string(bytes)
          • kind string(enum)

            The type of this condition, based on the internally defined ConditionType

            Values are e, hv, eq, neq, px, npx, sx, nsx, in, nin, some, all, none, rgx, nrgx, or cel.

          • value string(bytes)

            A condition parameter holds a target value (right hand side) for a comparison

    • nextPageToken string

      Token to retrieve the next page of results, or empty if there are no more results in the list.

  • default application/json

    Default error response

    Hide response attributes Show response attributes object
    • code integer(int32)

      The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

    • message string

      A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.

    • details array[object]

      A list of messages that carry the error details. There is a common set of message types for APIs to use.

      Contains an arbitrary serialized message along with a @type that describes the type of the serialized message.

      Hide details attribute Show details attribute object
      • @type string

        The type of the serialized message.

GET /v1/{contextId}/rules/{ruleId}/versions
curl \
 --request GET 'https://api.brease.run/v1/{contextId}/rules/{ruleId}/versions'
Response examples (200)
{
  "rules": [
    {
      "id": "string",
      "version": "string",
      "sequence": 42,
      "description": "string",
      "actions": [
        {
          "kind": "string",
          "target": {
            "kind": "string",
            "id": "string",
            "value": "string"
          },
          "id": "string"
        }
      ],
      "expression": {
        "and": {
          "expression": [
            {}
          ]
        },
        "or": {
          "expression": [
            {}
          ]
        },
        "condition": {
          "key": "string",
          "ref": {
            "src": "string",
            "dst": "string",
            "value": "string"
          },
          "kind": "e",
          "value": "string"
        }
      }
    }
  ],
  "nextPageToken": "string"
}
Response examples (default)
{
  "code": 42,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}