My Trust Center API

My Trust Center API Reference

Salesforce My Trust Center API (v1.0)

Download OpenAPI specification:Download

Get a personalized view of the events that affect the Salesforce tenants that you're authorized to access. Events include incidents, maintenance, patch releases, and informational messages. You can also refresh your personal access token (PAT).

A tenant is a distinct data space that doesn't implicitly share data with other tenants, such as a Salesforce org, a Marketing Cloud Engagement business unit, or a Commerce Cloud realm. The API uses the same tenants that you see in Salesforce My Trust Center.

Every response is limited to the tenants that the PAT in the request is authorized to access.

To authenticate, send your PAT as a Bearer token in the Authorization header: Authorization: Bearer <PAT>.

Refresh a personal access token

Replaces the PAT in the Authorization header with a new PAT. The current PAT must be active. When the refresh succeeds, the current PAT is revoked immediately, so store the returned secret before your next request. Refresh isn't idempotent, and the old and new PATs don't overlap.

To estimate when a PAT expires, decode the exp claim, in Unix seconds, from the PAT's JWT payload locally. The payload contains only exp. Don't verify the signature, because the signing key isn't published. The server's expiry and revocation status are authoritative.

By default, the new PAT is valid for 30 days. To request a shorter lifetime, set expiresInDays. A PAT and all of its replacements stay valid for no more than 365 days in total.

Authorizations:
BearerAuth
Request Body schema: application/json
optional

Optional lifetime for the replacement PAT.

expiresInDays
integer [ 1 .. 30 ]
Default: 30

Lifetime of the replacement PAT, in whole days.

Responses

Request samples

Content type
application/json
{
  • "expiresInDays": 7
}

Response samples

Content type
application/json
{
  • "tokenId": "9aa0b1c2-d3e4-4f56-a789-0123456789ab",
  • "secret": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3OTE0Mjg0MDB9.example-signature",
  • "label": "prod-servicenow",
  • "createdAt": "2026-09-08T03:00:00.000Z",
  • "expiresAt": "2026-10-08T03:00:00.000Z"
}

Get a status snapshot

Returns a snapshot of ongoing and upcoming events across all tenants that you're authorized to access. The ongoing and upcoming buckets each group events by event type.

A patch release can appear more than once, because each copy represents a separate tenant scope and lifecycle. Copies can appear in both ongoing and upcoming when your affected tenants are at different stages. Each copy's scope identifies its tenants. Incidents, maintenance events, and informational messages appear once per eventId. Don't de-duplicate the snapshot by eventId.

Authorizations:
BearerAuth
query Parameters
locale
string
Default: "en-US"

BCP 47 locale for localized response fields. Unsupported or malformed values fall back to en-US, the default. Applies to every endpoint.

Responses

Response samples

Content type
application/json
{
  • "ongoing": {
    },
  • "upcoming": {
    }
}

Search events

Searches for events that affect the specified tenants within a time window. In the request body, specify a list of tenant IDs, an optional eventTypes filter, an inclusive startTime, and an exclusive endTime. The response is a flat list of events in a stable order for cursor pagination.

Pagination. pageSize defaults to 100, with a maximum of 200. When more results are available, the response includes an opaque nextPageToken. To get the next page, resend the original request unchanged with pageToken set to that value. Repeat until the response doesn't include nextPageToken. If the matching results change between requests, the API rejects the token with a 400 error. Restart from the first page so that you don't skip or duplicate events.

Authorization. The API ignores tenant IDs that you aren't authorized to access. If you aren't authorized to access any of the requested tenants, the response is 200 { "events": [] }.

Results. Each result has the same shape as an event from GET /events/{eventId}, without timeline, and with a scope that identifies the affected tenants. An event that matches more than one requested tenant can appear once per matched tenant. status, startTime, endTime, and duration are calculated separately for each match, so they can differ between results with the same eventId. For example, an incident can be resolved for one tenant and active for another. To show one result per event, group results by eventId. To get the full timeline, call GET /events/{eventId}.

Authorizations:
BearerAuth
query Parameters
locale
string
Default: "en-US"

BCP 47 locale for localized response fields. Unsupported or malformed values fall back to en-US, the default. Applies to every endpoint.

Request Body schema: application/json
required

Tenants, event types, and time window to search.

required
Array of objects (EventSearchScope) [ 1 .. 50 ] items

Tenant scopes to search, from 1 to 50 per request. Duplicate tenants are removed.

eventTypes
Array of strings (EventType) non-empty unique
Items Enum: "patch" "incident" "maintenance" "informationalMessage"

Event types to include. To include all event types, omit this property.

startTime
required
string <date-time>

Inclusive start of the search window, as a full ISO 8601 timestamp with a Z suffix or a ±HH:MM offset, such as 2026-06-01T00:00:00Z. Date-only, year-only, and space-separated values return a 400 error.

endTime
required
string <date-time>

Exclusive end of the search window. Uses the same format as startTime, and must be later than startTime.

pageSize
integer [ 1 .. 200 ]
Default: 100

Maximum number of events to return on this page.

pageToken
string <= 4096 characters

Opaque continuation token from the preceding response. Keep scopes, eventTypes, startTime, endTime, locale, and pageSize the same.

Responses

Request samples

Content type
application/json
{
  • "scopes": [
    ],
  • "eventTypes": [
    ],
  • "startTime": "2026-06-01T00:00:00Z",
  • "endTime": "2026-09-01T00:00:00Z",
  • "pageSize": 100
}

Response samples

Content type
application/json
{
  • "events": [
    ],
  • "nextPageToken": "opaque-continuation-token"
}

Get an event

Returns the event identified by eventId, including its timeline. Each timeline entry includes a scope that lists which of your tenants the entry applies to.

Authorizations:
BearerAuth
path Parameters
eventId
required
string
Example: teofrchxogq373q

Unique event ID.

query Parameters
locale
string
Default: "en-US"

BCP 47 locale for localized response fields. Unsupported or malformed values fall back to en-US, the default. Applies to every endpoint.

Responses

Response samples

Content type
application/json
{
  • "eventId": "evt-incident-001",
  • "eventType": "incident",
  • "title": "API latency",
  • "description": "Some requests are experiencing elevated latency.",
  • "status": "resolved",
  • "startTime": "2026-10-08T16:00:00.000Z",
  • "endTime": "2026-10-08T17:15:00.000Z",
  • "duration": "PT1H15M",
  • "displayDuration": "1 hour 15 minutes",
  • "products": [
    ],
  • "services": [
    ],
  • "data": {},
  • "timeline": [
    ],
  • "createdAt": "2026-10-08T16:00:00.000Z"
}

List your tenants

Returns the tenants that the PAT in the request is authorized to access. Results are sorted by tenant ID and cloud for cursor pagination. To get every page, follow nextPageToken until the response doesn't include it. Keep all other request parameters the same between pages.

Authorizations:
BearerAuth
query Parameters
locale
string
Default: "en-US"

BCP 47 locale for localized response fields. Unsupported or malformed values fall back to en-US, the default. Applies to every endpoint.

pageSize
integer [ 1 .. 200 ]
Default: 100

Maximum number of records to return on this page.

pageToken
string <= 4096 characters

Opaque continuation token from the preceding response. Keep all other request parameters the same as in the request that returned the token.

Responses

Response samples

Content type
application/json
{
  • "tenants": [
    ],
  • "nextPageToken": "opaque-continuation-token"
}

Get a tenant and its event history

Returns details for a tenant, plus events whose lifecycle overlaps the 365 days before or after the request time. Informational messages cover the 365 days before the request time. Each embedded event includes parent-level event details and a scope that contains the requested tenant, but not timeline. To get an event's timeline, call GET /events/{eventId}.

Authorizations:
BearerAuth
path Parameters
tenantId
required
string
Example: 00D000000000062

Tenant ID, from the id field of a tenant in GET /tenants.

query Parameters
locale
string
Default: "en-US"

BCP 47 locale for localized response fields. Unsupported or malformed values fall back to en-US, the default. Applies to every endpoint.

Responses

Response samples

Content type
application/json
{
  • "id": "00D000000000001",
  • "cloud": "core",
  • "name": "Example Corporation",
  • "environment": "Production",
  • "myDomain": "example",
  • "region": "AMER",
  • "version": "266.12",
  • "maintenanceWindow": "Sunday 02:00-04:00 UTC",
  • "location": {
    },
  • "events": [
    ]
}