> ## Documentation Index > Fetch the complete documentation index at: https://docs.cattix.com/llms.txt > Use this file to discover all available pages before exploring further. # Patch Live Campaign Settings > Update settings on a live Google Ads campaign. Only provided fields are updated. Targeting fields (locations, languages, ad schedule) use replace-all semantics. ## OpenAPI ````yaml https://dev-api.cattix.com/openapi.json patch /api/v1/campaigns/live/{customer_id}/{campaign_id} openapi: 3.1.0 info: title: CATTIX API description: CATTIX Backend API version: 0.107.0 servers: - url: http://localhost:8000 description: Local - url: https://dev-api.cattix.com description: Development - url: https://staging-api.cattix.com description: Staging - url: https://api.cattix.com description: Production security: [] paths: /api/v1/campaigns/live/{customer_id}/{campaign_id}: patch: tags: - Campaigns summary: Patch Live Campaign Settings description: >- Update settings on a live Google Ads campaign. Only provided fields are updated. Targeting fields (locations, languages, ad schedule) use replace-all semantics. operationId: >- patch_live_campaign_settings_api_v1_campaigns_live__customer_id___campaign_id__patch parameters: - name: customer_id in: path required: true schema: type: integer title: Customer Id - name: campaign_id in: path required: true schema: type: integer title: Campaign Id - name: token_id in: query required: false schema: anyOf: - type: integer - type: 'null' description: Optional specific Token ID title: Token Id description: Optional specific Token ID requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateCampaignSettingsRequestSchema' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/UpdateCampaignResultSchema' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - OAuth2PasswordBearer: [] components: schemas: UpdateCampaignSettingsRequestSchema: properties: campaign_name: anyOf: - type: string maxLength: 256 minLength: 1 - type: 'null' title: Campaign Name status: anyOf: - type: string enum: - ENABLED - PAUSED - type: 'null' title: Status daily_budget_micros: anyOf: - type: integer ge: 1000000 le: 50000000000 - type: 'null' title: Daily Budget Micros bidding_strategy: anyOf: - $ref: '#/components/schemas/BiddingStrategySchema' - type: 'null' network_settings: anyOf: - $ref: '#/components/schemas/NetworkSettingsSchema' - type: 'null' language_ids: anyOf: - items: type: integer type: array - type: 'null' title: Language Ids location_targets: anyOf: - items: $ref: '#/components/schemas/LocationTargetSchema' type: array - type: 'null' title: Location Targets ad_schedule: anyOf: - $ref: '#/components/schemas/api__campaigns__schemas__AdScheduleSchema' - type: 'null' start_date: anyOf: - type: string format: date - type: 'null' title: Start Date end_date: anyOf: - type: string format: date - type: 'null' title: End Date conversion_goals: anyOf: - items: $ref: '#/components/schemas/ConversionGoalSchema' type: array - type: 'null' title: Conversion Goals type: object title: UpdateCampaignSettingsRequestSchema description: Request schema for updating live campaign settings. All fields optional. UpdateCampaignResultSchema: properties: success: type: boolean title: Success campaign_updated: type: boolean title: Campaign Updated default: false budget_updated: type: boolean title: Budget Updated default: false targeting_updated: type: boolean title: Targeting Updated default: false conversion_goals_updated: type: boolean title: Conversion Goals Updated default: false warnings: items: type: string type: array title: Warnings errors: items: type: string type: array title: Errors type: object required: - success title: UpdateCampaignResultSchema description: Response schema for campaign settings update. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError BiddingStrategySchema: properties: type: $ref: '#/components/schemas/BiddingStrategyType' target_cpa_micros: anyOf: - type: integer ge: 0 le: 50000000000 - type: 'null' title: Target Cpa Micros description: Required if type is TARGET_CPA target_roas: anyOf: - type: number exclusiveMinimum: 0 - type: 'null' title: Target Roas description: Required if type is TARGET_ROAS (e.g., 2.0 = 200%) max_cpc_bid_ceiling_micros: anyOf: - type: integer ge: 0 le: 50000000000 - type: 'null' title: Max Cpc Bid Ceiling Micros description: Optional ceiling for automated strategies type: object required: - type title: BiddingStrategySchema description: Bidding strategy configuration. NetworkSettingsSchema: properties: target_google_search: type: boolean title: Target Google Search description: Target Google Search default: true target_search_network: type: boolean title: Target Search Network description: Target Search partners default: false target_content_network: type: boolean title: Target Content Network description: Target Display Network default: false type: object title: NetworkSettingsSchema description: Network settings for campaign. LocationTargetSchema: properties: geo_target_constant_id: type: integer exclusiveMinimum: 0 title: Geo Target Constant Id description: Google Ads geo target constant ID target_type: $ref: >- #/components/schemas/api__google_ads_management__schemas__LocationTargetType default: INCLUDE type: object required: - geo_target_constant_id title: LocationTargetSchema description: Location targeting configuration. api__campaigns__schemas__AdScheduleSchema: properties: mode: type: string enum: - ALL_TIME - CUSTOM title: Mode schedule_entries: anyOf: - items: $ref: '#/components/schemas/ScheduleEntrySchema' type: array - type: 'null' title: Schedule Entries description: Required if mode is CUSTOM type: object required: - mode title: AdScheduleSchema description: Ad schedule configuration. ConversionGoalSchema: properties: conversion_action_id: anyOf: - type: integer exclusiveMinimum: 0 - type: 'null' title: Conversion Action Id description: Google Ads conversion action ID goal_type: type: string enum: - CAMPAIGN_SPECIFIC - ACCOUNT_DEFAULT title: Goal Type category: anyOf: - $ref: '#/components/schemas/ConversionCategory' - type: 'null' type: object required: - goal_type title: ConversionGoalSchema description: Conversion goal configuration. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError BiddingStrategyType: type: string enum: - MAXIMIZE_CONVERSIONS - MAXIMIZE_CONVERSION_VALUE - MAXIMIZE_CLICKS - TARGET_CPA - TARGET_ROAS - TARGET_IMPRESSION_SHARE - MANUAL_CPC title: BiddingStrategyType description: Supported bidding strategy types. api__google_ads_management__schemas__LocationTargetType: type: string enum: - INCLUDE - EXCLUDE title: LocationTargetType description: Location targeting type. ScheduleEntrySchema: properties: day_of_week: $ref: '#/components/schemas/DayOfWeek' start_hour: type: integer maximum: 23 minimum: 0 title: Start Hour start_minute: type: integer enum: - 0 - 15 - 30 - 45 title: Start Minute default: 0 end_hour: type: integer maximum: 24 minimum: 0 title: End Hour description: 24 = midnight end end_minute: type: integer enum: - 0 - 15 - 30 - 45 title: End Minute default: 0 type: object required: - day_of_week - start_hour - end_hour title: ScheduleEntrySchema description: Single schedule entry for ad scheduling. ConversionCategory: type: string enum: - PURCHASE - SIGNUP - LEAD - PAGE_VIEW - DOWNLOAD - ADD_TO_CART - BEGIN_CHECKOUT - CONTACT - SUBMIT_LEAD_FORM - BOOK_APPOINTMENT - REQUEST_QUOTE - GET_DIRECTIONS - OUTBOUND_CLICK - OTHER title: ConversionCategory description: Conversion action categories. DayOfWeek: type: string enum: - MONDAY - TUESDAY - WEDNESDAY - THURSDAY - FRIDAY - SATURDAY - SUNDAY title: DayOfWeek description: Days of the week for ad scheduling. securitySchemes: OAuth2PasswordBearer: type: oauth2 flows: password: scopes: {} tokenUrl: api/v1/users/authorization/token ````