# Zoom Timeline Version Increase

**URL:** <https://devforum.zoom.us/t/zoom-timeline-version-increase/99111>\
**Category:** Cloud Recordings\
**Created:** [November 27, 2023, 10:34pm UTC](https://devforum.zoom.us/t/zoom-timeline-version-increase/99111 "2023-11-27T22:34:20Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![menioa](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/menioa/32/35057_2.png) [@menioa](https://devforum.zoom.us/u/menioa)\
**Post date:** [November 27, 2023, 10:34pm UTC](https://devforum.zoom.us/t/zoom-timeline-version-increase/99111/1 "2023-11-27T22:34:20Z")

</div>

Hello,

I recently noticed that some of the `TIMELINE` files included from the [recordings.completed](https://developers.zoom.us/docs/meeting-sdk/webhooks/#operation/recording.completed) webhook have received a version bump from `100` to `200` (per the `version` json property included in the file). Is there any documentation on what the changes are between these two versions? So far the only percieved difference is that sometimes there are some entries that include

```auto
{
    "user_id" : 0
}

```

inside of the “users” fields. This is a confusing entry however, as it doesn’t follow the typical schema for a user entry

```auto
{
    "avatar_url" : string,
    "client_type" : int,
    "email_address" : string,
    "multiple_people" : bool,
    "user_id" : int,
    "username" : string,
    "zoom_userid" : string
}

```

Any insight into what changes are included, as well as why this is only happening for some users would be very helpful.

---

<div class="post-metadata">

**Author:** ![recordedspeed](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/recordedspeed/32/3124_2.png) [@recordedspeed](https://devforum.zoom.us/u/recordedspeed)\
**Post date:** [November 29, 2023, 7:13am UTC](https://devforum.zoom.us/t/zoom-timeline-version-increase/99111/2 "2023-11-29T07:13:39Z")

</div>

It would be great if Zoom would provide some documentation for the Zoom Timeline files. They are versioned already, but there is no public documentation for what the parameters can be or what the schema is expected to look like.

Undocumented functionality makes for fragile integrations.

---

<div class="post-metadata">

**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\
**Post date:** [November 29, 2023, 3:46pm UTC](https://devforum.zoom.us/t/zoom-timeline-version-increase/99111/3 "2023-11-29T15:46:39Z")

</div>

Hi @menioa  
Thanks for reaching out to us.  
Could you please share with me an entire payload that you are getting when using the recordings.completed webhook? (without any private information)  
I do not see any different or new fields in the response.

---

<div class="post-metadata">

**Author:** ![menioa](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/menioa/32/35057_2.png) [@menioa](https://devforum.zoom.us/u/menioa)\
**Post date:** [November 29, 2023, 6:24pm UTC](https://devforum.zoom.us/t/zoom-timeline-version-increase/99111/4 "2023-11-29T18:24:35Z")

</div>

Hi Elisa,

The recordings.completed webhook has not changed, but rather the version included inside of one of the individual recordings files with the type `timeline`. in that file, the last entry in that time line `json` file has a version field which historically was `100`, but now is `200`, as well as occasionally the entries in the users field now have a new entry like I specified above with `"user_id" : 0` rather than the traditionally schema that I outlined in my original post.

Here is an example of such an entry:

```auto
{
         "ts" : "00:27:23.860",
         "users" : [
            {
               "avatar_url" : string,
               "client_type" : int,
               "email_address" : string,
               "multiple_people" : bool,
               "user_id" : int,
               "username" : string,
               "zoom_userid" : string
            },
            {
               "user_id" : 0
            }
         ]
      }
   ],
   "version" : 200

```

---

<div class="post-metadata">

**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\
**Post date:** [December 4, 2023, 5:09pm UTC](https://devforum.zoom.us/t/zoom-timeline-version-increase/99111/5 "2023-12-04T17:09:11Z")

</div>

Thanks @menioa  
I will go ahead and send you a private message so we can exchange more information.  
Unfortunately, I do not have enough data to look further into this.  
Cheers,  
Elisa