{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.wherever.audio/schemas/webhooks/episode-shown/v1.json",
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "enum": [
        "user",
        "agent",
        "link",
        "system",
        "sync"
      ],
      "description": "Who caused the event."
    },
    "actionId": {
      "description": "Shared by every event one action produced.",
      "type": "string"
    },
    "test": {
      "description": "Present only on synthetic events from a test send.",
      "type": "boolean",
      "const": true
    },
    "episode": {
      "$ref": "https://docs.wherever.audio/schemas/webhooks/references/episode/v1.json"
    },
    "surface": {
      "type": "string",
      "examples": [
        "forYou"
      ]
    },
    "index": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "0-based place on the surface."
    }
  },
  "required": [
    "origin",
    "episode",
    "surface",
    "index"
  ],
  "title": "episode.shown data",
  "description": "An episode is visible on a recommendation surface.",
  "x-stability": "experimental"
}