MadHive modify retargeting line item API
The modify retargeting line item API from MadHive — 1 operation(s) for modify retargeting line item.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/madhive-modify-retargeting-line-item-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Madhive modify retargeting line item API
version: 1.0.0
description: The Madhive API provides a comprehensive interface for digital advertising clients and services.
servers:
- url: https://api2.madhive.com/api
description: apigee
tags:
- name: modify retargeting line item
paths:
/v1/retargeting/lineitems/{id}:
put:
tags:
- modify retargeting line item
summary: Ability to edit a line item retargeting segment inclusive of name, notes and…
description: Ability to edit a line item retargeting segment inclusive of name, notes and line item IDs.
operationId: updateRetargetingLineItem
parameters:
- name: id
in: path
description: retargeting line item id
required: true
x-oapi-codegen-extra-tags:
validate: required,min=28,max=28
schema:
type: string
- $ref: '#/components/parameters/X-Cloud-Trace-Context'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/RetargetingLineItemRequest'
responses:
'200':
description: retargeting line item updated
content:
application/json:
schema:
$ref: '#/components/schemas/RetargetingResponse'
'400':
$ref: '#/components/responses/400InvalidID'
'401':
$ref: '#/components/responses/401Unauthorized'
security:
- oauth2: []
components:
examples:
401Ex:
value:
error: unauthorized
status: ERROR
transaction:
id: 4af459ff8e1a36b6bb74fb88f1a02477
taskId: '14158884487309867565'
created: '2030-11-02T15:04:00Z'
400InvalidID:
value:
error: invalid resource id
status: ERROR
transaction:
id: 4af459ff8e1a36b6bb74fb88f1a02477
taskId: '14158884487309867565'
created: '2030-11-02T15:04:00Z'
responses:
400InvalidID:
description: Invalid input
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
response:
$ref: '#/components/examples/400InvalidID'
401Unauthorized:
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
response:
$ref: '#/components/examples/401Ex'
schemas:
Transaction:
type: object
x-go-type-skip-optional-pointer: true
x-omitempty: false
required:
- id
- taskId
- created
properties:
id:
type: string
description: trace id
example: 4af459ff8e1a36b6bb74fb88f1a02477
taskId:
type: string
x-omitempty: true
description: task id
example: '14158884487309867565'
created:
type: string
description: 'order created date, format: yyyy-mm-dd hh:mm:ss'
example: '2030-11-02T15:04:00Z'
ErrorResponse:
type: object
required:
- transaction
properties:
errors:
type: array
x-go-type-skip-optional-pointer: true
items:
type: string
description: many error messages
error:
type: string
x-go-type-skip-optional-pointer: true
description: error message
example: Unauthorized
status:
type: string
x-go-type-skip-optional-pointer: true
description: status of the service
example: ERROR
transaction:
$ref: '#/components/schemas/Transaction'
RetargetingLineItemRequest:
allOf:
- $ref: '#/components/schemas/RetargetingCampaignRequest'
ID:
type: string
x-go-name: ID
x-go-type-skip-optional-pointer: true
x-oapi-codegen-extra-tags:
validate: omitempty,min=28,max=28
description: resource id
example: a8MWQ2v4ZceGhsku2P5amaOXCnwe
RetargetingRequest:
type: object
x-isnullable: false
required:
- ids
- name
- advertiserId
properties:
name:
$ref: '#/components/schemas/Name'
description:
type: string
x-isnullable: true
x-omitempty: true
x-go-type-skip-optional-pointer: true
x-oapi-codegen-extra-tags:
validate: 'omitempty,min=2,max=128,ne= '
description: retargeting description
example: retargeting description
ids:
x-go-name: IDs
type: array
items:
$ref: '#/components/schemas/ID'
x-oapi-codegen-extra-tags:
validate: required,unique,gte=1,dive
description: resource ids
advertiserId:
type: string
x-go-name: AdvertiserID
x-omitempty: true
x-go-type-skip-optional-pointer: true
x-oapi-codegen-extra-tags:
validate: required,min=28,max=28
description: advertiser id
example: 3XhdJ4bBiPD1B0kr2jjFFJjOvH8S
retargetingWindow:
type: string
x-omitempty: true
x-go-type-skip-optional-pointer: true
pattern: ^([1-9][0-9]* (DAY|MONTH))?$
description: retargeting window interval (e.g., "7 DAY", "3 MONTH")
example: 7 DAY
RetargetingResponse:
type: object
x-isnullable: false
description: generic response for all retargeting requests
allOf:
- $ref: '#/components/schemas/RetargetingRequest'
- type: object
properties:
id:
$ref: '#/components/schemas/ID'
transaction:
$ref: '#/components/schemas/Transaction'
retargetingType:
$ref: '#/components/schemas/RetargetingType'
startDate:
$ref: '#/components/schemas/Date'
endDate:
$ref: '#/components/schemas/Date'
Date:
type: string
x-go-type-skip-optional-pointer: true
x-oapi-codegen-extra-tags:
validate: required,datetime=2006-01-02T15:04:05Z07:00
description: 2020-06-18T17:24:53Z is a basic example of an RFC 3339 timestamp, which refers to June 18, 2020 5:24:53 PM in UTC
example: '2030-01-10T23:00:00Z'
RetargetingCampaignRequest:
allOf:
- $ref: '#/components/schemas/RetargetingRequest'
- type: object
required:
- startDate
- endDate
properties:
startDate:
$ref: '#/components/schemas/Date'
endDate:
$ref: '#/components/schemas/Date'
Name:
type: string
x-isnullable: false
x-omitempty: false
x-oapi-codegen-extra-tags:
validate: 'required,min=2,max=128,ne= '
description: resource name
example: name of resource
RetargetingType:
type: string
x-go-type-skip-optional-pointer: true
x-isnullable: false
x-omitempty: false
x-oapi-codegen-extra-tags:
validate: required,oneof=RETARGETING_CAMPAIGN RETARGETING_LINE_ITEM RETARGETING_TRACKING_PIXEL RETARGETING_CREATIVE
enum:
- RETARGETING_CAMPAIGN
- RETARGETING_LINE_ITEM
- RETARGETING_TRACKING_PIXEL
- RETARGETING_CREATIVE
description: retargeting type
example: RETARGETING_CAMPAIGN
parameters:
X-Cloud-Trace-Context:
name: X-Cloud-Trace-Context
in: header
description: gcp trace
required: false
schema:
type: string
default: 91f9f012dc7c7ffc13604c77f12a8931
securitySchemes:
oauth2:
type: oauth2
flows:
clientCredentials:
tokenUrl: https://api2.madhive.com/oauth/token
scopes: {}
basicAuth:
type: http
description: Basic Authentication Not Implemented
scheme: basic
bearerAuth:
type: apiKey
name: Authorization
in: header
description: jwt access token for authentication