PATCH /api/organizations/{org_id}
Update an existing organization. This endpoint updates organization settings. Access requires the EDIT_ORG_SETTINGS permission, which is granted to admin and owner roles. Args: org_id: Organization ID to update (UUID) update_data: Organization update data user_id: Authenticated user ID (injected by require_permission dependency) Returns: OrgResponse: The updated organization details Raises: HTTPException: 401 if user is not authenticated HTTPException: 403 if user lacks EDIT_ORG_SETTINGS permission HTTPException: 404 if organization not found HTTPException: 409 if organization name already exists HTTPException: 422 if validation errors occur (handled by FastAPI) HTTPException: 500 if update fails
Parameters
| Name | In | Type | Required | Description |
|---|
org_id | path | `string | null` | yes |
X-Org-Id | header | `string | null` | no |
Request body
| Field | Type | Required | Description |
|---|
name | `string | null` | no |
contact_name | `string | null` | no |
contact_email | `string | null` | no |
conversation_expiration | `integer | null` | no |
remote_runtime_resource_factor | `integer | null` | no |
billing_margin | `number | null` | no |
enable_proactive_conversation_starters | `boolean | null` | no |
sandbox_base_container_image | `string | null` | no |
sandbox_runtime_container_image | `string | null` | no |
sandbox_api_key | `string | null` | no |
max_budget_per_task | `number | null` | no |
v1_enabled | `boolean | null` | no |
search_api_key | `string | null` | no |
llm_api_key | `string | null` | no |
agent_settings_diff | `object | null` | no |
conversation_settings_diff | `object | null` | no |
Responses
| Status | Description |
|---|
200 | Successful Response |
422 | Validation Error |
Response body
| Field | Type | Required | Description |
|---|
id | string | yes | — |
name | string | yes | — |
contact_name | string | yes | — |
contact_email | string | yes | — |
conversation_expiration | `integer | null` | no |
remote_runtime_resource_factor | `integer | null` | no |
billing_margin | `number | null` | no |
enable_proactive_conversation_starters | boolean | no | — |
sandbox_base_container_image | `string | null` | no |
sandbox_runtime_container_image | `string | null` | no |
org_version | integer | no | — |
agent_settings | `FaheemCodeAgentSettings | LLMAgentSettings | ACPAgentSettings` |
conversation_settings | ConversationSettings | no | — |
search_api_key | `string | null` | no |
sandbox_api_key | `string | null` | no |
max_budget_per_task | `number | null` | no |
v1_enabled | `boolean | null` | no |
credits | `number | null` | no |
is_personal | boolean | no | — |
Operation ID: update_org_api_organizations__org_id__patch