POST a resource representation.
Section: JSON request patterns
Simple create request body
json
json
{
"name": "Ava Martin",
"email": "ava@example.com",
"role": "admin"
}Explanation
A clean top-level object is often enough for private APIs and straightforward CRUD designs.
Learn the surrounding workflow
Compare similar commands or jump into common fixes when this command is part of a bigger troubleshooting path.
Related commands
Same sheet · prioritizing JSON request patterns
Embed related resources on demand
Include relationships when the client asks for them.
Return an ETag for concurrency and caching
Tag a representation with a revision validator.
Protect updates with If-Match
Prevent lost updates from concurrent writes.