Taboola · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Taboola Backstage Campaign Items Bulk Items API

5 actions 5 updates phrasing extends openapi/taboola-bulk-items-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Taboola's API. It is a proposal applied on top of the contract, not a document Taboola publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info
$.paths['/{account_id}/campaigns/{campaign_id}/items/mass-create'].post
$.paths['/{account_id}/items/bulk'].put
$.paths['/{account_id}/items/bulk'].post
$.paths['/{account_id}/items/bulk'].delete

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Taboola Backstage Campaign Items Bulk Items API
  version: 1.0.0
extends: openapi/taboola-bulk-items-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/{account_id}/campaigns/{campaign_id}/items/mass-create'].post
  update:
    x-apievangelist-phrasing:
      intent: Create many items in one campaign at once
      effect: write
      questions:
      - How do I add a whole batch of ads to a single campaign in one request?
      - Can I mass-create items for one campaign instead of posting them one by one?
      instructions:
      - text: Mass-create a batch of items in campaign {campaign_id} for account {account_id}.
        slots:
          account_id: path.account_id
          campaign_id: path.campaign_id
      - text: Upload these ads to campaign {campaign_id} in a single batch request.
        slots:
          campaign_id: path.campaign_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{account_id}/items/bulk'].put
  update:
    x-apievangelist-phrasing:
      intent: Update items across several campaigns
      effect: write
      questions:
      - Can I edit items that live in different campaigns with one call?
      - What's the way to change the same ads across multiple campaigns at once?
      instructions:
      - text: Bulk update items across multiple campaigns in account {account_id}.
        slots:
          account_id: path.account_id
      - text: Apply these item edits to every listed campaign in {account_id} in one request.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{account_id}/items/bulk'].post
  update:
    x-apievangelist-phrasing:
      intent: Create the same items in several campaigns
      effect: write
      questions:
      - How do I push the same set of ads into several campaigns at once?
      - Is there a way to create identical items across multiple campaigns in one request?
      instructions:
      - text: Bulk create the same items across multiple campaigns in account {account_id}.
        slots:
          account_id: path.account_id
      - text: Add these ads to each of the listed campaigns in {account_id} at once.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/{account_id}/items/bulk'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete items across several campaigns
      effect: destructive
      questions:
      - Can I remove ads from many different campaigns in a single call?
      - How do I bulk delete items spread across multiple campaigns?
      instructions:
      - text: Bulk delete items across multiple campaigns in account {account_id}.
        slots:
          account_id: path.account_id
      - text: Remove these items from all their campaigns in {account_id} in one request.
        slots:
          account_id: path.account_id
      method: generated
      generated: '2026-09-26'