MadHive modify retargeting creative API
The modify retargeting creative API from MadHive — 1 operation(s) for modify retargeting creative.
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-creative-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 creative 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 creative
paths:
/v1/retargeting/creatives/{id}:
put:
tags:
- modify retargeting creative
summary: Ability to edit creative retargeting segments inclusive of the name, notes and…
description: Ability to edit creative retargeting segments inclusive of the name, notes and creative IDs.
operationId: updateRetargetingCreative
parameters:
- name: id
in: path
description: retargeting creative 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/RetargetingCreativeRequest'
responses:
'200':
description: retargeting creative 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:
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'
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'
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
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
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'
RetargetingCreativeRequest:
allOf:
- $ref: '#/components/schemas/RetargetingRequest'
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'
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