Update User Profile

curl --request PUT \
  --url https://api.example.com/api/profile/{id}/update/

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/profile/{id}/update/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/profile/{id}/update/"

	req, _ := http.NewRequest("PUT", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/profile/{id}/update/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)

response = http.request(request)
puts response.read_body

PUT

api

profile

{id}

update

Update User Profile

curl --request PUT \
  --url https://api.example.com/api/profile/{id}/update/

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/profile/{id}/update/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/profile/{id}/update/"

	req, _ := http.NewRequest("PUT", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/profile/{id}/update/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)

response = http.request(request)
puts response.read_body

Overview

This endpoint allows authenticated users to update their profile information. Users can only update their own profile. Supports partial updates and avatar image uploads.

Authentication

This endpoint requires authentication. Include a valid JWT access token in the Authorization header:

Authorization: Bearer <access_token>

Authorization

Users can only update their own profile. The authenticated user must match the user ID in the URL path, otherwise a 403 Forbidden error is returned.

Request

Endpoint

PUT /api/profile/{id}/update/

Path Parameters

Parameter	Type	Description	Required
id	integer	The user ID (must match authenticated user)	Yes

Headers

Header	Value	Required
Authorization	Bearer	Yes
Content-Type	application/json or multipart/form-data	Yes

Request Body

Supports partial updates. All fields are optional:

{
  "first_name": "John",
  "last_name": "Doe",
  "email": "[email protected]",
  "number_phone": "1234567890",
  "username": "john_doe_updated"
}

Avatar Upload

To upload an avatar, use multipart/form-data encoding and include the avatar file field:

curl -X PUT https://api.example.com/api/profile/1/update/ \
  -H "Authorization: Bearer <token>" \
  -F "avatar=@/path/to/image.jpg" \
  -F "first_name=John" \
  -F "last_name=Doe"

Request Fields

Field	Type	Description	Constraints
username	string	User’s username	Optional, unique
email	string	User’s email address	Optional, unique, max 200 chars
first_name	string	User’s first name	Optional, max 200 chars
last_name	string	User’s last name	Optional, max 200 chars
number_phone	string	User’s phone number	Optional, max 10 chars
avatar	file	Profile image file	Optional, image file (jpg, png, etc.)

Response

Success Response (200 OK)

Returns the updated user profile data:

{
  "id": 1,
  "username": "john_doe_updated",
  "email": "[email protected]",
  "first_name": "John",
  "last_name": "Doe",
  "number_phone": "1234567890",
  "avatar": "/media/avatars/image.jpg",
  "date_joined": "2024-01-15T10:30:00Z",
  "last_login": "2024-03-10T14:20:00Z",
  "is_active": true,
  "is_staff": false,
  "is_superuser": false
}

Response Fields

Field	Type	Description
id	integer	Unique user identifier
username	string	User’s username
email	string	User’s email address
first_name	string	User’s first name
last_name	string	User’s last name
number_phone	string	User’s phone number
avatar	string	URL path to user’s avatar image
date_joined	datetime	When the user account was created
last_login	datetime	Last login timestamp
is_active	boolean	Whether the user account is active
is_staff	boolean	Whether user has staff privileges
is_superuser	boolean	Whether user has superuser privileges

Error Responses

400 Bad Request

Returned when the request data is invalid:

{
  "email": [
    "This field must be a valid email address."
  ],
  "username": [
    "A user with that username already exists."
  ]
}

401 Unauthorized

Returned when the authentication token is missing or invalid:

{
  "detail": "Authentication credentials were not provided."
}

403 Forbidden

Returned when the authenticated user tries to update another user’s profile:

{
  "error": "Not authorized"
}

404 Not Found

Returned when the user ID doesn’t exist:

{
  "detail": "Not found."
}

500 Internal Server Error

Returned when an unexpected error occurs:

{
  "error": "Error message details"
}

Example Requests

Update Basic Information (JSON)

curl -X PUT https://api.example.com/api/profile/42/update/ \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Alice",
    "last_name": "Wonderland",
    "number_phone": "5559876543"
  }'

Update with Avatar Upload (Multipart)

curl -X PUT https://api.example.com/api/profile/42/update/ \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -F "avatar=@profile_pic.jpg" \
  -F "first_name=Alice" \
  -F "last_name=Wonderland"

Partial Update (Single Field)

curl -X PUT https://api.example.com/api/profile/42/update/ \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]"
  }'

Example Response

{
  "id": 42,
  "username": "alice_wonder",
  "email": "[email protected]",
  "first_name": "Alice",
  "last_name": "Wonderland",
  "number_phone": "5559876543",
  "avatar": "/media/avatars/alice_updated.jpg",
  "date_joined": "2024-02-01T08:15:30Z",
  "last_login": "2024-03-10T11:45:22Z",
  "is_active": true,
  "is_staff": false,
  "is_superuser": false
}

Implementation Details

This endpoint is implemented in /apps/users/views.py:97 as the update_profile function view:

Decorated with @permission_classes([IsAuthenticated]) to require authentication
Verifies that request.user matches the user being updated (authorization check)
Supports MultiPartParser and FormParser for file uploads
Handles avatar file uploads separately before serializer validation
Uses UsersSerializer with partial=True to allow partial updates
Returns updated user data on success

Notes

Partial updates are supported - you only need to include fields you want to change
Avatar images are uploaded to the media/avatars/ directory
Email and username must remain unique across all users
The endpoint uses PUT method but supports partial updates (PATCH-like behavior)

Get Profile - Retrieve user profile information
Delete User - Delete user account

⌘I

Authentication

Password Generation

Saved Passwords

User Management

Update User Profile

Overview

Authentication

Authorization

Request

Endpoint

Path Parameters

Headers

Request Body

Avatar Upload

Request Fields

Response

Success Response (200 OK)

Response Fields

Error Responses

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

500 Internal Server Error

Example Requests

Update Basic Information (JSON)

Update with Avatar Upload (Multipart)

Partial Update (Single Field)

Example Response

Implementation Details

Notes

​Overview

​Authentication

​Authorization

​Request

​Endpoint

​Path Parameters

​Headers

​Request Body

​Avatar Upload

​Request Fields

​Response

​Success Response (200 OK)

​Response Fields

​Error Responses

​400 Bad Request

​401 Unauthorized

​403 Forbidden

​404 Not Found

​500 Internal Server Error

​Example Requests

​Update Basic Information (JSON)

​Update with Avatar Upload (Multipart)

​Partial Update (Single Field)

​Example Response

​Implementation Details

​Notes

​Related Endpoints

Overview

Authentication

Authorization

Request

Endpoint

Path Parameters

Headers

Request Body

Avatar Upload

Request Fields

Response

Success Response (200 OK)

Response Fields

Error Responses

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

500 Internal Server Error

Example Requests

Update Basic Information (JSON)

Update with Avatar Upload (Multipart)

Partial Update (Single Field)

Example Response

Implementation Details

Notes

Related Endpoints