Show Table of Contents
3.2. Using POST to Create Resources
This section describes how to use
POST requests to create Satellite resources. Special permissions might be required for some POST requests; see Appendix A, API Permissions Matrix for information about API permissions.
3.2.1. Creating a Resource
Create a new resource with a
POST request to the collection URI containing a representation of the new resource.
A
POST request requires a Content-Type header. This informs the API of the representation MIME type in the body content as part of the request.
Include an Accept HTTP header to define the MIME type for the response format.
Each resource type has its own specific required properties. The client supplies these properties when creating a new resource. Refer to the individual resource type documentation for more details.
If a required property is absent, the creation fails with a representation indicating the missing elements.
POST /api/collection HTTP/1.1 Accept: MIME type Content-Type: MIME type body
Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.