create

open override fun create(entity: TEntity): TElementEndpoint?

Adds an entity as a new element to the collection.

Return

An endpoint for the newly created entity; null if the server returned neither a "Location" header nor an entity with an ID in the response body.

Parameters

entity

The new entity.

Throws

when the server responds with HttpStatusCode.BadRequest.

when the server responds with HttpStatusCode.Forbidden.

for when the server responds with HttpStatusCode.Conflict.

for other non-success status codes.