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

# 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
  }'

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
}

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);
});

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)

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

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());
 }

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());

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": "+1-555-0123",
    "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

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

Previousget__organization_{orgId}Nextget__organization_users

Last updated 6 months ago

Was this helpful?

hashtagTypeScript Client Library

hashtagCode Samples

hashtagPath Parameters

hashtagRequest Body

hashtagResponses

hashtagResponse Schema

hashtagSecurity

hashtagNotes

TypeScript Client Library

Code Samples

Path Parameters

Request Body

Responses

Response Schema

Security

Notes