Document upcoming changes to webhooks payloads

[fkorotkov]

These are proposed new fields that will come to the payloads and GraphQL API in the coming weeks.

These events will allow to improve export of the events into systems like Datadog. See the following issue:

• https://github.com/cirruslabs/cirrus-webhooks-server/issues/8
• https://github.com/cirruslabs/cirrus-webhooks-server/issues/9

[fkorotkov]

@edigaryev what do you think about a request header. Since the payload is a GraphQL query response and I don't think we can add timestamp there. 🤔

[edigaryev]

@edigaryev what do you think about a request header. Since the payload is a GraphQL query response and I don't think we can add timestamp there. 🤔

That would totally work too.

[edigaryev]

Since the payload is a GraphQL query response and I don't think we can add timestamp there. 🤔

On a side note, it seems that the action and old_status fields are merged somehow, so probably we can:

[edigaryev]

Also, perhaps we should make the audit_event to conform to this format, or vice versa, because currently it differs, see screenshot below.

Note that the body is not a nested object, but instead a JSON string: