Delete Endpoint
The Delete
endpoint handles DELETE requests to resources (e.g. DELETE /posts/1
) and responds with a 204 No Content
response.
To enable it for a resource or collection, add the Delete
endpoint to the endpoints
array:
use Tobyz\JsonApiServer\Endpoint\Delete;
class PostsResource extends Resource
{
// ...
public function endpoints(): array
{
return [Delete::make()];
}
}
Authorization
If you want to restrict the ability to delete a resource, use the visible
or hidden
method, with a closure that returns a boolean value:
Delete::make()->visible(fn($model, Context $context) => $model->is_wiki);
Implementation
The Delete
endpoint requires the resource or collection to implement the Tobyz\JsonApiServer\Resource\Deletable
interface (which extends the Findable
interface). The endpoint will:
- Call the
find
method to retrieve the model instance. - Call the
delete
method to delete the model.
A simple implementation might look like:
use App\Models\Post;
use Tobyz\JsonApiServer\Resource\Updatable;
class PostsResource extends Resource implements Deletable
{
// ...
public function endpoints(): array
{
return [Endpoint\Delete::make()];
}
public function find(string $id, Context $context): ?object;
{
return Post::find($id);
}
public function delete(object $model, Context $context): void
{
$model->delete();
}
}
Laravel Integration
For Laravel applications with Eloquent-backed resources, you can extend the Tobyz\JsonApiServer\Laravel\EloquentResource
class which implements this interface for you. Learn more on the Laravel Integration page.