Skip to main content

Update org app settings

POST /api/organizations/app

Update organization app settings for the user's current organization. Base access requires MANAGE_APPLICATION_SETTINGS (all members). Editing org-wide registered_marketplaces additionally requires EDIT_ORG_SETTINGS (admin/owner), since those defaults apply to every member. Args: update_data: App settings update data request: The incoming request (used to resolve the target org for the marketplace permission check) service: OrgAppSettingsService (injected by dependency) user_id: Authenticated user ID (injected by require_permission) Returns: OrgAppSettingsResponse: The updated organization app settings Raises: HTTPException: 401 if user is not authenticated HTTPException: 403 if user lacks the required permission HTTPException: 404 if current organization not found HTTPException: 409 if a concurrent modification is detected HTTPException: 400 if validation errors occur (e.g. duplicate names) HTTPException: 500 if update fails

Parameters

NameInTypeRequiredDescription
org_idquery`stringnull`no
X-Org-Idheader`stringnull`no

Request body

FieldTypeRequiredDescription
enable_proactive_conversation_starters`booleannull`no
max_budget_per_task`numbernull`no
registered_marketplaces`faheemcode__app_server__settings__settings_models__MarketplaceRegistration[]null`no
last_known_updated_at`stringnull`no

Responses

StatusDescription
200Successful Response
422Validation Error

Response body

FieldTypeRequiredDescription
enable_proactive_conversation_startersbooleanno
max_budget_per_task`numbernull`no
registered_marketplacesfaheemcode__app_server__settings__settings_models__MarketplaceRegistration[]no
updated_at`stringnull`no

Operation ID: update_org_app_settings_api_organizations_app_post