Supported HTTP Methods

The most commonly used HTTP methods (or verbs) are GET, POST, PATCH,PUT, DELETE, and OPTIONS. The building blocks of REST APIs, these methods define actions applied to REST resources using their URLs.

Note:

  • Oracle recommends that you periodically review if your REST request requirements have changed. Also check with your service administrator if any capacity adjustments or other changes are required in your service configuration.
  • Child resources usually inherit security privileges from their parent resource. Therefore, to use a method on a child resource, you may need to have access to use that method on the parent resource. However, there may be some child resources with different privilege requirements to access them.

The following table lists the methods and their scope for singular and collection resources.

Method Works with a Singular Resource? Works with a Collection Resource?
GET Yes. Gets a single resource. Yes. Gets a subset, or all of the resources in the collection.
POST Yes. Creates a single resource. Yes. Creates a new resource in the collection.
PUT Yes. Updates a resource. No.
PATCH Yes. Replaces objects related to a resource. No.
DELETE Yes. Deletes a resource. No.
OPTIONS Yes. Gets the supported methods for a resource. No.

The GET Method

Use this method to query and retrieve resource information. To query both a singular resource and a collection resource, use query parameters. To filter the queried result, use different parameters for a singular resource and a collection resource. For more information, see Manage Collections. Use the following media types along with this method to request:

  • A collection of resources or a resource:
    • application/json
    • application/xml
  • The catalog information of a resource:
    • application/json
  • The catalog schema information of a resource:
    • application/schema+json

The POST Method

Use to create a new resource. The media types allowed with this method are application/json and application/xml.

The PUT Method

Use to update a resource. The media types allowed with this method are application/json and application/xml.

The PATCH Method

Use to replace the objects related to a resource. The media types allowed with this method are application/json and application/xml.

The DELETE Method

Use to delete a resource. This request method does not require a request body.

The OPTIONS Method

Use to find the HTTP methods available for a resource. The only media type allowed with this method is application/json. This request method does not require a request body.