> ## Documentation Index > Fetch the complete documentation index at: https://docs.adside.ai/llms.txt > Use this file to discover all available pages before exploring further. # Update Ad Set > Update an existing ad set's name, status, budget, bid, schedule, targeting, or promoted object (the pixel and conversion event it optimises towards). ## OpenAPI ````yaml /api-reference/openapi.yaml post /meta/mcp#update_ad_set openapi: 3.1.0 info: title: Multi-Source Ads API version: 1.0.0 description: >- Unified API for managing ad campaigns across Meta, LinkedIn, and Google. MCP tools are accessed via JSON-RPC 2.0 over HTTP (`POST /{source}/mcp`). Google Sheets/Drive endpoints use standard REST. servers: - url: https://api.adside.ai description: Production - url: http://localhost:3100 description: Local development security: - bearerAuth: [] tags: - name: Accounts description: '' - name: Ads description: '' - name: Analytics description: '' - name: Asset Groups description: '' - name: Assets description: '' - name: Audiences description: '' - name: Campaign Groups description: '' - name: Campaigns description: '' - name: Conversions description: '' - name: Creatives description: '' - name: Drive description: '' - name: Google description: '' - name: Google Ads description: '' - name: Google Tag Manager description: '' - name: Keywords description: '' - name: Linkedin description: '' - name: Meta description: '' - name: Meta Reporting description: '' - name: OAuth description: '' - name: Other description: '' - name: Reports description: '' - name: Sheets description: '' - name: Targeting description: '' - name: Tiktok description: '' - name: Workspace description: '' paths: /meta/mcp#update_ad_set: post: tags: - Meta - Ads summary: Update Ad Set description: >- Update an existing ad set's name, status, budget, bid, schedule, targeting, or promoted object (the pixel and conversion event it optimises towards). operationId: meta_update_ad_set requestBody: required: true content: application/json: schema: type: object required: - jsonrpc - method - params properties: jsonrpc: type: string const: '2.0' id: type: string example: '1' method: type: string const: tools/call params: type: object required: - name - arguments properties: name: type: string const: update_ad_set arguments: $ref: '#/components/schemas/meta_update_ad_set_input' responses: '200': description: JSON-RPC response with tool result content: application/json: schema: $ref: '#/components/schemas/McpToolResponse' '401': description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Channel not connected or access denied content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - bearerAuth: [] components: schemas: meta_update_ad_set_input: type: object properties: adset_id: type: string description: Ad set ID to update name: description: New ad set name type: string status: description: New ad set status type: string enum: - ACTIVE - PAUSED - ARCHIVED daily_budget: description: New daily budget in account-currency cents (e.g. 1000 = $10.00). type: number exclusiveMinimum: 0 lifetime_budget: description: >- New lifetime budget in account-currency cents (e.g. 20000 = $200.00). type: number exclusiveMinimum: 0 bid_amount: description: >- New bid amount in account-currency cents (e.g. 100 = $1.00). For ads with IMPRESSIONS or REACH billing_event the bid is per 1,000 occurrences; for other billing_events it is per occurrence. type: number exclusiveMinimum: 0 start_time: description: New start time (ISO 8601 format) type: string end_time: description: New end time (ISO 8601 format) type: string targeting: description: Updated targeting spec type: object propertyNames: type: string additionalProperties: {} promoted_object: description: >- Updated promoted object — the pixel and conversion event a conversion ad set optimises towards. Meta replaces the whole object, so send every field you want kept, not only the one you are changing. type: object properties: page_id: description: Facebook Page ID to promote type: string pixel_id: description: Facebook Pixel ID for tracking type: string application_id: description: Application ID for app promotion type: string object_store_url: description: App store URL for app promotion type: string custom_event_type: description: >- Conversion event to optimise towards, paired with pixel_id. Note the past-tense spelling INITIATED_CHECKOUT — the pixel calls the same event InitiateCheckout and reporting calls it initiate_checkout, and neither is accepted here. type: string enum: - AD_IMPRESSION - RATE - TUTORIAL_COMPLETION - CONTACT - CUSTOMIZE_PRODUCT - DONATE - FIND_LOCATION - SCHEDULE - START_TRIAL - SUBMIT_APPLICATION - SUBSCRIBE - ADD_TO_CART - ADD_TO_WISHLIST - INITIATED_CHECKOUT - ADD_PAYMENT_INFO - PURCHASE - LEAD - COMPLETE_REGISTRATION - CONTENT_VIEW - SEARCH - SERVICE_BOOKING_REQUEST - MESSAGING_CONVERSATION_STARTED_7D - LEVEL_ACHIEVED - ACHIEVEMENT_UNLOCKED - SPENT_CREDITS - LISTING_INTERACTION - D2_RETENTION - D7_RETENTION - OTHER required: - adset_id $schema: http://json-schema.org/draft-07/schema# McpToolResponse: type: object properties: jsonrpc: type: string const: '2.0' id: type: string result: type: object properties: content: type: array items: type: object properties: type: type: string const: text text: type: string description: JSON-stringified tool result ErrorResponse: type: object properties: error: type: string description: Error message code: type: string enum: - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - RATE_LIMITED - INTERNAL_ERROR description: Error code securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key (sk_live_*) — SHA256 hashed, looked up in Redis. Generate via the web app's workspace settings. ````