Create a task

This endpoint requires an active authenticated session. Unauthenticated requests are redirected to the login page.

Endpoint

POST /tasks

Description

Validates the request, looks up a user by the provided email address, and creates a new task assigned to that user. On success, the server returns an HTTP 302 redirect back to the previous page. On failure (user not found or validation error), the server redirects back with errors in the session.

The user field must be the email address of a user who already exists in the database. The endpoint does not create new users. If no matching user is found, the request is redirected back with a user: User not found. validation error.

Request body

string

required

The title of the task. Maximum 255 characters.

string

required

A detailed description of the task. Maximum 500 characters.

string

required

The email address of the user to assign the task to. Must be a valid email format and must match an existing user record.

Response

This endpoint does not return a JSON body on success. It returns an HTTP 302 redirect to the previous URL (Laravel redirect()->back()). The Vue.js frontend does not rely on the redirect body — instead, the component calls fetchTasks after submission to refresh the task list. On failure, the redirect includes session error data which Laravel flashes to the session:

{
  "user": ["User not found."]
}

Validation failures follow the standard Laravel 422 format when called via an AJAX client that sets the Accept: application/json header.

Controller code

// app/Http/Controllers/TaskController.php

public function store(Request $request)
{
    // Validar los datos
    $validated = $request->validate([
        'title' => 'required|max:255',
        'description' => 'required|max:500',
        'user' => 'required|email|max:500',
    ]);

    $user = User::where('email', $validated['user'])->first();

    if ($user) {
        $task = new Task([
            'title' => $validated['title'],
            'description' => $validated['description'],
        ]);

        $task->user_id = $user->id;

        $task->save();

        return redirect()->back()->with('success', 'Task created successfully.');
    } else {
        return redirect()->back()->withErrors(['user' => 'User not found.']);
    }
}

Frontend Axios call

// resources/js/store.js — addTask action

addTask({ commit }, task) {
    axios.post('/tasks', task)
        .then(response => {
            commit('ADD_TASK', response.data);
        })
        .catch(error => {
            console.error("Error adding task:", error);
        });
},

Tasks API

Authentication

Endpoint

Description

Request body

Response

Controller code

Frontend Axios call

​Endpoint

​Description

​Request body

​Response

​Controller code

​Frontend Axios call

Endpoint

Description

Request body

Response

Controller code

Frontend Axios call