VersionDetail

  • A version together with what it published. It keeps its empty fields rather than omitting them, for the reason the draft does: it carries a stored diagram, and dropping what has no value would drop it from inside the diagram too.

    • bot_id
      Type: stringFormat: uuid
      required
    • diagram
      Type: Diagram
      required

      Your diagram, kept as you sent it: keys we do not model — notes, embedded bricks — come back untouched. The one thing we add is isTarget: true, on any node that does not already say whether a connection may end at it.

      We read nodes and connections to check it. A diagram missing either is stored anyway and reported as breaking rules.

      Properties: 3
    • published_at
      Type: Timestamp
      required

      A moment, in UTC, written as YYYY-MM-DDTHH:MM:SS. It carries no offset and no fraction of a second, so a client that reads it as local time is wrong by whatever its own offset is.

    • version_id
      Type: stringFormat: uuid
      required
    • channel_version
      Type: object | null

      The channel the bot was served on, as it stood when the version was published. It is carried verbatim from the context that owns channels and nothing here models it: a version is shown as it ran, and the diagram alone does not say what the bot looked like. null for a bot whose family has no channel of its own.

      Properties: 1
    • name
      Type: string | null

      A label, absent unless someone has set one. Versions are created unnamed; naming one is a separate action.

    • published_by
      Type: Author

      Who published it. Absent once that person has left the brand — there is nothing left to name them by.

      Properties: 2