{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-cloud-pubsub/json-schema/google-cloud-pubsub-seek-subscription-request-schema.json",
  "title": "SeekSubscriptionRequest",
  "description": "Request for SeekSubscription.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-cloud-pubsub-pubsublite-admin-api-openapi.yml#/components/schemas/SeekSubscriptionRequest",
  "properties": {
    "timeTarget": {
      "$ref": "#/$defs/TimeTarget",
      "description": "Seek to the first message whose publish or event time is greater than or equal to the specified query time. If no such message can be located, will seek to the end of the message backlog."
    },
    "namedTarget": {
      "type": "string",
      "enum": [
        "NAMED_TARGET_UNSPECIFIED",
        "TAIL",
        "HEAD"
      ],
      "description": "Seek to a named position with respect to the message backlog."
    }
  },
  "type": "object",
  "$defs": {
    "TimeTarget": {
      "description": "A target publish or event time. Can be used for seeking to or retrieving the corresponding cursor.",
      "type": "object",
      "properties": {
        "publishTime": {
          "format": "google-datetime",
          "description": "Request the cursor of the first message with publish time greater than or equal to `publish_time`. All messages thereafter are guaranteed to have publish times >= `publish_time`.",
          "type": "string"
        },
        "eventTime": {
          "description": "Request the cursor of the first message with event time greater than or equal to `event_time`. If messages are missing an event time, the publish time is used as a fallback. As event times are user supplied, subsequent messages may have event times less than `event_time` and should be filtered by the client, if necessary.",
          "format": "google-datetime",
          "type": "string"
        }
      }
    }
  }
}