REST API Developer Guide

REST API
Quick Start
Examples
Getting Information About My Organization
List Available REST API Versions
List Organization Limits
List Available REST Resources
Get a List of Objects
Get a List of Objects If Metadata Has Changed
Working with Object Metadata
Working with Records
Delete Lightning Experience Event Series
Working with Searches and Queries
Get an Image from a Rich Text Area Field
Insert or Update Blob Data
Retrieve Blob Data
Working with Recently Viewed Information
Managing User Passwords
Working with Approval Processes and Process Rules
Using Event Monitoring
Using Composite Resources
Generating an OpenAPI 3.0 Specification for sObjects REST API (Beta)
Reference
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Get a List of Objects If Metadata Has Changed

Use the Describe Global resource and the If-Modified-Since HTTP header to determine if an object’s metadata has changed.

You can include the If-Modified-Since header with a date in EEE, dd MMM yyyy HH:mm:ss z format when you use the Describe Global resource. If you do, response metadata is returned only if an available object’s metadata has changed since the provided date. If no metadata has been modified since the provided date, a 304 Not Modified status code is returned with no response body.

The following example assumes that no changes have been made to objects after March 23, 2015.

Example Describe Global request
/services/data/v54.0/sobjects
Example If-Modified-Since header used with request
If-Modified-Since: Tue, 23 Mar 2015 00:00:00 GMT
Example response body
No response body returned
Example response status code
1HTTP/1.1 304 Not Modified
2Date: Wed, 25 Jul 2015 00:05:46 GMT

If changes to an object were made after March 23, 2015, the response body contains metadata for all available objects. For an example, see Get a List of Objects.