function readOnly(count){ }
Starting November 20, the site will be set to read-only. On December 4, 2023,
forum discussions will move to the Trailblazer Community.
+ Start a Discussion
Artem IvashchenkoArtem Ivashchenko 

Salesforce Status/Trust Rest API questions

Hi

My questions are related to Salesforce Status Rest API.
https://api.status.salesforce.com/v1/docs/#/

0) General question:
Does incidents (with incidentImpacts and incidentEvents) and maintenance  (with maintenanceImpacts) can be updated after they are initially created?
I suppose incidentEvents can be added/updated after the original incident was created. Am I right?
What about the rest incident/maintenance data?


1) metricValues API
https://api.status.salesforce.com/v1/metricValues

It seems Metric values must be per instance but currently the link with instance is broken (metric shows instanceKey=All instead of distinct instance)
Every entry in API response has such value: "instanceKey": "All"

Is this a bug? Would metricValues be linked to distinct instances?



2) GeneralMessages as part of instance/status API
https://api.status.salesforce.com/v1/instances/status
https://api.status.salesforce.com/v1/instances/status/preview
https://api.status.salesforce.com/v1/instances/[instanceKey]/status   e.g. https://api.status.salesforce.com/v1/instances/NA24/status

These APIs have GeneralMessages collection/array as part of theirs response model but there is no such data in responses.
I see GeneralMessages come only with separate API without links to instances.

Is there any link between instance and generalMessage?
Would this data be present in instancces/status API responses?


3) incidents API
https://api.status.salesforce.com/v1/incidents

this API has startTime as an input parameter - [startTime].

I'm trying to figure out what filter it applies on incidents.
My guess is the following (I've tried to write it in some sort of pseudocode):

trunc([startTime] to date) <= ANY trunc("IncidentImpacts"."startTime" to date)

Am I right?

4) maintenances API
https://api.status.salesforce.com/v1/maintenances

this API has startTime as an input parameter - [startTime].

I'm trying to figure out what filter it applies on incidents.
My two guesses are as followed (I've tried to write it in some sort of pseudocode):

   a) trunc([startTime] to date) <= trunc("plannedStartTime" to date)
   b) trunc([startTime] to date) <= ANY trunc("MaintenanceImpacts"."startTime" to date)

Which one filter is the right one?
Best Answer chosen by Artem Ivashchenko
Charlie MeynetCharlie Meynet
Hi Artem,

Hopefully this helps. 

0) All fields can be edited after creation. Often times this will happen for incidents when they do a post incident analysis and find that incident times originally reported turn out to be wrong. New incidentImpacts will be added throughout the incident as it changes states (disruption > degredation). Maintenances generally don’t change but there is no guarantee that they won’t.

1) We currently only expose aggregate metrics.

2) This is a bug with the api docs and I will get it updated. We don’t include general messages with the instances endpoints because they don’t have any association with instances. The best way to get this information is to use the general messages api.

3) The start time will filter out any incidents that have an incidentImpact that starts before the startTime.

4) The start time will filter out any maintenance that have an a plannedStart that starts before the startTime.

Let me know if you have other questions or suggestions. Thanks!

All Answers

Charlie MeynetCharlie Meynet
Hi Artem,

Hopefully this helps. 

0) All fields can be edited after creation. Often times this will happen for incidents when they do a post incident analysis and find that incident times originally reported turn out to be wrong. New incidentImpacts will be added throughout the incident as it changes states (disruption > degredation). Maintenances generally don’t change but there is no guarantee that they won’t.

1) We currently only expose aggregate metrics.

2) This is a bug with the api docs and I will get it updated. We don’t include general messages with the instances endpoints because they don’t have any association with instances. The best way to get this information is to use the general messages api.

3) The start time will filter out any incidents that have an incidentImpact that starts before the startTime.

4) The start time will filter out any maintenance that have an a plannedStart that starts before the startTime.

Let me know if you have other questions or suggestions. Thanks!
This was selected as the best answer
Artem IvashchenkoArtem Ivashchenko
Hi Charlie,

Thank you. It was helpfull.