put__settings_user

PUT /settings/user

Partial Update User Settings

Partially update the current user's settings. This endpoint allows updating specific settings keys while preserving existing values for keys not included in the request. The user must be authenticated.

Request Body Schema

Name	Type	Required	Restrictions	Description
» [key: string]	any	false	none	Partial settings object with key-value pairs to update

TypeScript Client Library

// Using the Flashback TypeScript client
import { FlashbackClient } from '@flashback/client';

const client = new FlashbackClient({ accessToken: 'your-access-token' });

// Partially update user settings
try {
  const result = await client.settings.user.partialUpdate({
    theme: 'light',
    notifications: { email: false }
  });
  console.log('User settings partially updated:', result);
} catch (error) {
  console.error('Failed to partially update user settings:', error);
}

Code Samples

Shell

# You can also use wget
curl -X PUT https://backend.flashback.tech/settings/user \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "theme": "light",
    "notifications": {
      "email": false
    }
  }'

HTTP

PUT https://backend.flashback.tech/settings/user HTTP/1.1
Host: localhost:3000
Accept: application/json
Authorization: Bearer {access-token}
Content-Type: application/json

{
  "theme": "light",
  "notifications": {
    "email": false
  }
}

JavaScript

const headers = {
  'Accept':'application/json',
  'Authorization':'Bearer {access-token}',
  'Content-Type':'application/json'
};

const body = {
  "theme": "light",
  "notifications": {
    "email": false
  }
};

fetch('https://backend.flashback.tech/settings/user',
{
  method: 'PUT',
  headers: headers,
  body: JSON.stringify(body)
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

Ruby

require 'rest-client'
require 'json'

headers = {
  'Accept' => 'application/json',
  'Authorization' => 'Bearer {access-token}',
  'Content-Type' => 'application/json'
}

body = {
  "theme" => "light",
  "notifications" => {
    "email" => false
  }
}

result = RestClient.put 'https://backend.flashback.tech/settings/user',
  body.to_json, headers: headers

p JSON.parse(result)

Python

import requests
import json

headers = {
  'Accept': 'application/json',
  'Authorization': 'Bearer {access-token}',
  'Content-Type': 'application/json'
}

body = {
  "theme": "light",
  "notifications": {
    "email": False
  }
}

r = requests.put('https://backend.flashback.tech/settings/user', 
                 headers=headers, 
                 data=json.dumps(body))

print(r.json())

PHP

<?php

require 'vendor/autoload.php';

$headers = array(
    'Accept' => 'application/json',
    'Authorization' => 'Bearer {access-token}',
    'Content-Type' => 'application/json',
);

$client = new \GuzzleHttp\Client();

// Define array of request body.
$request_body = array(
    'theme' => 'light',
    'notifications' => array(
        'email' => false
    )
);

try {
    $response = $client->request('PUT','https://backend.flashback.tech/settings/user', array(
        'headers' => $headers,
        'json' => $request_body,
       )
    );
    print_r($response->getBody()->getContents());
 }
 catch (\GuzzleHttp\Exception\BadResponseException $e) {
    // handle exception or api errors.
    print_r($e->getMessage());
 }

Java

URL obj = new URL("https://backend.flashback.tech/settings/user");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("PUT");
con.setRequestProperty("Accept", "application/json");
con.setRequestProperty("Authorization", "Bearer {access-token}");
con.setRequestProperty("Content-Type", "application/json");

String jsonInputString = "{\"theme\":\"light\",\"notifications\":{\"email\":false}}";

con.setDoOutput(true);
try(OutputStream os = con.getOutputStream()) {
    byte[] input = jsonInputString.getBytes("utf-8");
    os.write(input, 0, input.length);           
}

int responseCode = con.getResponseCode();
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
String inputLine;
StringBuffer response = new StringBuffer();
while ((inputLine = in.readLine()) != null) {
    response.append(inputLine);
}
in.close();
System.out.println(response.toString());

Go

package main

import (
       "bytes"
       "encoding/json"
       "net/http"
)

func main() {

    headers := map[string][]string{
        "Accept": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
        "Content-Type": []string{"application/json"},
    }

    body := map[string]interface{}{
        "theme": "light",
        "notifications": map[string]interface{}{
            "email": false,
        },
    }

    jsonData, _ := json.Marshal(body)
    data := bytes.NewBuffer(jsonData)
    req, err := http.NewRequest("PUT", "https://backend.flashback.tech/settings/user", data)
    req.Header = headers

    client := &http.Client{}
    resp, err := client.Do(req)
    // ...
}

Example responses

200 Response

{
  "success": true,
  "message": "User settings partially updated successfully"
}

400 Response

{
  "success": false,
  "message": "Failed to partially update user settings"
}

500 Response

{
  "success": false,
  "message": "Internal server error",
  "error": "Database connection failed"
}

Responses

Status	Meaning	Description	Schema
200	OK	User settings partially updated successfully	Inline
400	Bad Request	Failed to partially update user settings	Inline
500	Internal Server Error	Internal server error	Inline

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» success	boolean	true	none	Indicates if the request was successful
» message	string	true	none	Success message describing the operation

Status Code 400

Name	Type	Required	Restrictions	Description
» success	boolean	true	none	Always false for error responses
» message	string	true	none	Error message describing the issue

Status Code 500

Name	Type	Required	Restrictions	Description
» success	boolean	true	none	Always false for error responses
» message	string	true	none	Error message describing the issue
» error	string	false	none	Additional error details if available

DTOs

PartialUpdateSettingsRequest

export interface PartialUpdateSettingsRequest {
  // Using [key: string]: any for maximum flexibility - partial updates can contain any JSON-serializable data
  [key: string]: any;
}

SettingsErrorResponse

export interface SettingsErrorResponse {
  success: false;
  message: string;
  error?: string;
}