put__organization_{orgId}

PUT /organization/{orgId}

Update Organization Details

Update organization details and settings. This endpoint requires ADMINISTRATOR or OWNER role permissions. Only the fields provided in the request body will be updated. Users can only modify their own organization.

TypeScript Client Library

// Note: This endpoint doesn't have a direct client method in the provided TypeScript client
// You would need to use the generic makeRequest method:
// this.makeRequest<any>(`organization/${orgId}`, 'PUT', { 
//   name: 'Updated Organization Name',
//   address1: '456 New Business Ave',
//   city: 'Los Angeles',
//   state: 'CA',
//   mfaEnforced: true
// });

Code Samples

Shell

# You can also use wget
curl -X PUT https://backend.flashback.tech/organization/123e4567-e89b-12d3-a456-426614174000 \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {access-token}' \
  -d '{
    "name": "Updated Organization Name",
    "address1": "456 New Business Ave",
    "city": "Los Angeles",
    "state": "CA",
    "mfaEnforced": true
  }'

HTTP

PUT https://backend.flashback.tech/organization/123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: localhost:3000
Accept: application/json
Content-Type: application/json
Authorization: Bearer {access-token}

{
  "name": "Updated Organization Name",
  "address1": "456 New Business Ave",
  "city": "Los Angeles",
  "state": "CA",
  "mfaEnforced": true
}

JavaScript

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

const body = {
  name: "Updated Organization Name",
  address1: "456 New Business Ave",
  city: "Los Angeles",
  state: "CA",
  mfaEnforced: true
};

fetch('https://backend.flashback.tech/organization/123e4567-e89b-12d3-a456-426614174000',
{
  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',
  'Content-Type' => 'application/json',
  'Authorization' => 'Bearer {access-token}'
}

body = {
  name: "Updated Organization Name",
  address1: "456 New Business Ave",
  city: "Los Angeles",
  state: "CA",
  mfaEnforced: true
}

result = RestClient.put 'https://backend.flashback.tech/organization/123e4567-e89b-12d3-a456-426614174000',
  body.to_json, headers: headers

p JSON.parse(result)

Python

import requests
import json

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

body = {
  "name": "Updated Organization Name",
  "address1": "456 New Business Ave",
  "city": "Los Angeles",
  "state": "CA",
  "mfaEnforced": True
}

r = requests.put('https://backend.flashback.tech/organization/123e4567-e89b-12d3-a456-426614174000', 
                 headers=headers, 
                 data=json.dumps(body))

print(r.json())

PHP

<?php

require 'vendor/autoload.php';

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

$body = array(
    'name' => 'Updated Organization Name',
    'address1' => '456 New Business Ave',
    'city' => 'Los Angeles',
    'state' => 'CA',
    'mfaEnforced' => true
);

$client = new \GuzzleHttp\Client();

try {
    $response = $client->request('PUT','https://backend.flashback.tech/organization/123e4567-e89b-12d3-a456-426614174000', array(
        'headers' => $headers,
        'json' => $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/organization/123e4567-e89b-12d3-a456-426614174000");
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
con.setRequestMethod("PUT");
con.setRequestProperty("Accept", "application/json");
con.setRequestProperty("Content-Type", "application/json");
con.setRequestProperty("Authorization", "Bearer {access-token}");
con.setDoOutput(true);

String jsonInputString = "{\"name\":\"Updated Organization Name\",\"address1\":\"456 New Business Ave\",\"city\":\"Los Angeles\",\"state\":\"CA\",\"mfaEnforced\":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"},
        "Content-Type": []string{"application/json"},
        "Authorization": []string{"Bearer {access-token}"},
    }

    body := map[string]interface{}{
        "name": "Updated Organization Name",
        "address1": "456 New Business Ave",
        "city": "Los Angeles",
        "state": "CA",
        "mfaEnforced": true,
    }

    jsonBody, _ := json.Marshal(body)
    data := bytes.NewBuffer(jsonBody)
    req, err := http.NewRequest("PUT", "https://backend.flashback.tech/organization/123e4567-e89b-12d3-a456-426614174000", data)
    req.Header = headers

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

Example responses

200 Response

{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Updated Organization Name",
    "domain": "acme.com",
    "address1": "456 New Business Ave",
    "address2": "Suite 100",
    "city": "Los Angeles",
    "zipcode": "10001",
    "phone": "[phone]",
    "state": "CA",
    "country": "US",
    "deletedAt": null,
    "reposDisabled": false,
    "website": "https://acme.com",
    "is_business": true,
    "mfaEnforced": true
  },
  "message": "Organization updated successfully"
}

400 Response

{
  "success": false,
  "data": null,
  "message": "No valid fields to update"
}

403 Response

{
  "success": false,
  "data": null,
  "message": "Insufficient permissions: only OWNER and ADMINISTRATOR roles can modify organization"
}

404 Response

{
  "success": false,
  "data": null,
  "message": "Organization not found"
}

500 Response

{
  "success": false,
  "data": null,
  "message": "Internal server error"
}

Path Parameters

Name	Type	Required	Description
» orgId	string	true	Unique identifier of the organization to update

Request Body

Name	Type	Required	Restrictions	Description
» name	string	false	none	Organization name
» address1	string	false	none	Primary address line
» address2	string	false	none	Secondary address line
» city	string	false	none	City
» zipcode	string	false	none	ZIP/Postal code
» phone	string	false	none	Phone number
» state	string	false	none	State/Province
» country	string	false	none	Country
» is_business	boolean	false	none	Whether this is a business organization
» mfaEnforced	boolean	false	none	Whether multi-factor authentication is enforced

Responses

Status	Meaning	Description	Schema
200	OK	Organization updated successfully	Inline
400	Bad Request	No valid fields to update	Inline
403	Forbidden	Insufficient permissions or user not in organization	Inline
404	Not Found	Organization not found	Inline
500	Internal Server Error	Internal server error	Inline

Response Schema

Status Code 200

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Indicates if the request was successful
» data	object	false	none	Updated organization data
»» id	string	false	none	Unique identifier for the organization
»» name	string	false	none	Organization name
»» domain	string	false	none	Organization domain
»» address1	string	false	none	Primary address line
»» address2	string	false	none	Secondary address line
»» city	string	false	none	City
»» zipcode	string	false	none	ZIP/Postal code
»» phone	string	false	none	Phone number
»» state	string	false	none	State/Province
»» country	string	false	none	Country
»» deletedAt	string (date-time)	false	none	Deletion timestamp (null if active)
»» reposDisabled	boolean	false	none	Whether repositories are disabled
»» website	string	false	none	Organization website URL
»» is_business	boolean	false	none	Whether this is a business organization
»» mfaEnforced	boolean	false	none	Whether multi-factor authentication is enforced
» message	string	false	none	Success message

Status Code 400

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Indicates if the request was successful
» data	null	false	none	No data returned
» message	string	false	none	Error message describing the validation issue

Status Code 403

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Indicates if the request was successful
» data	null	false	none	No data returned
» message	string	false	none	Error message describing the permission issue

Status Code 404

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Indicates if the request was successful
» data	null	false	none	No data returned
» message	string	false	none	Error message describing the issue

Status Code 500

Name	Type	Required	Restrictions	Description
» success	boolean	false	none	Indicates if the request was successful
» data	null	false	none	No data returned
» message	string	false	none	Error message describing the server issue

Security

• BearerAuth: Bearer token authentication required

• Organization Access: User must be a member of the specified organization

• Role Requirements: Requires ADMINISTRATOR or OWNER role to modify organization settings

Notes

• Only the fields provided in the request body will be updated

• Undefined values in the request body are filtered out and not processed

• Users can only modify their own organization's details

• The domain, deletedAt, reposDisabled, and website fields cannot be modified through this endpoint

• Organization settings are excluded from both request and response as requested

• At least one valid field must be provided in the request body