Apollo subscriptions not firing [Edit: it is firing]

Speckle Help Developers
1

Hi Devs,
since at least ~30min our model versions aren’t updating correctly anymore on our end. I am suspecting the “projectVersionsUpdated” subscription of our apollo connection is no longer firing.

Is it possible that there is an outage or maybe the interface has been changed today regarding apollo subscriptions?

We have used the webhooks in the past to do the same but the subscriptions were a little bit easier. Let me know if any way is no longer supported or wasn’t intended originally.

Best,
Sebastian

2

I was a bit to quick, the subscriptions seems to fire. Something else is broken. I will investigate and probably delete this.

3

Apollo subscriptions can be a little tricky.

Let me know if you discover anything.

4

I tracked down the issue. We are still using webhooks in the process. (Its a wild mix)
The webhook data seems to have changed. We were still expecting a probably legacy version.

The new data aligns with the new way speckle names things like branch → model. The weird thing is that it doesn’t really aligns with the documentation. Its still the previous structure but renamed a bit.

What i am seeing:

data: {
    model: {
        authorId: "xxxx"
        createdAt: "2026-05-13T16:48:38.783Z"
        description: null
        id: "f181bba128"
        name: "simple_house_new_roof.ifc"
        streamId: "0b32c47afc"
        updatedAt: "2026-05-13T16:48:38.783Z"
    }
    projectId: "0b32c47afc"
}
event_name: "branch_create"
}

What we were expecting previously:

event: { event_name: 'branch_create',
        data: {
            branch: {
                id: string
                streamId: string
                authorId: string
                name: string
                description: string
                createdAt: Date
                updatedAt: Date
            }
        }
    }

I will update the structure accordingly.
What confuses me is what the documentation states which doesn’t seem to align with either version:

{
  "branchId": "branch-id",
  "branchName": "feature/new-feature",
  "description": "New feature branch"
}
5

What documentation are you following?

6

This page here:

7

I’ll raise the out-of-date docs with the team.

In the mean time, I recommend checking out the GraphQL schema reference
here: Apollo Server

image
image763×529 34.4 KB

Any subscription that’s marked as “deprecated” should be avoided.

I’m also here if need any support, just let me know if you have any questions.

1 Like