How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Mediamath

MediaMath Bring Your Own Algorithm (BYOA) API

API for applying custom bidding algorithms within the MediaMath platform brain, including Campaign Settings configuration and Custom Bid Router for external algorithm invocation during bid opportunities.

Documentation Provider Profile APIs.io OpenAPI GitHub

This API exposes 14 operations across 7 paths, organized into 3 resource areas. It is described by OpenAPI 3.0.0.

Requests are made against a single base URL, https://api.byoa.mediamath.com.

14 operations 7 paths 0 schemas 3 DELETE7 GET1 PATCH3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
Base URL
https://api.byoa.mediamath.com
Authentication
API Key, OAuth 2.0
Contact
BYOA API Support
License
Apache 2.0
Resource Areas
3

Authentication & Security 2

MediaMath Bring Your Own Algorithm (BYOA) API declares 2 security schemes for authenticating requests. An API key is passed in the header as adama_session (adama-session-header). It supports OAuth 2.0 (oauth2) using the password flow.

  • adama-session-header — Authentication is provided through OAuth2. You'll need to request a Client ID and Secret key. After Authentication is established make a request to https://api…
  • oauth2 — exchange an Authorization Code for a Token

Paths & Operations 14

Across 7 paths, the API surfaces 14 operations — 3 DELETE, 7 GET, 1 PATCH, 3 PUT. They span 3 resource areas: Campaign Settings, Custom Brain, Custom Bid Router. Each is listed below with its method, path, parameters, and response codes.

Campaign Settings 6

BYOA (Bring Your Own Algorithm) allows advertisers to apply their own bidding algorithms within MediaMath. The participating campaigns and strategies are configured with the BYOA…

GET
/campaign_settings/{campaign_id}/strategies/{strategy_id}
Strategy based Campaign Details
GET_campaign_settings-campaign_id-strategies-strategy_id 2 params → 200400
DELETE
/campaign_settings/{campaign_id}/strategies/{strategy_id}
Strategy based Campaign Delete
DELETE_campaign_settings-campaign_id-strategies-strategy_id 2 params → 200400
PUT
/campaign_settings/{campaign_id}/strategies/{strategy_id}
Strategy based Campaign Create/Modify
PUT_campaign_settings-campaign_id-strategies-strategy_id 4 params body → 200400
DELETE
/campaign_settings/{campaign_id}
Campaign Delete
DELETE_campaign_settings-campaign_id 1 param → 200400
PUT
/campaign_settings/{campaign_id}
Campaign Create/Modify
PUT_campaign_settings-campaign_id 1 param body → 200400
GET
/campaign_settings/{campaign_id}
Campaign Details
GET_campaign_settings-campaign_id 1 param → 200400
Custom Brain 5

In Customized Brain, the client uses the BYOA API to upload a set of logistic coefficients corresponding to any of the variables currently in use by the MediaMath Brain. These coe…

DELETE
/data/{namespace}/models/{model_id}
Model Data Delete
DELETE_data-namespace-models-model_id 2 params → 200400
GET
/data/{namespace}/models/{model_id}
Model Data Details
GET_data-namespace-models-model_id 2 params → 200400
PUT
/data/{namespace}/models/{model_id}
Model Data Create/Modify
PUT_data-namespace-models-model_id 2 params body → 200
GET
/data/decode/{namespace}/models/{model_id}
Model Data Decode
GET_data-decode-namespace-models-model_id 2 params → 200400
GET
/data/{namespace}
Model Data Details for Namespace
GET_data-namespace 2 params → 200400
Custom Bid Router 3

Custom Bid Router further extends the BYOA architecture allowing advertisers to apply their own bidding algorithms in their own ecosystem. The MediaMath system will invoke an exte…

GET
/custombidrouter/{org_id}/configuration
Configuration Summary
summary-bidvaluator-organization 2 params body → 200401
GET
/custombidrouter/{org_id}/executors/{executor_id}
Executor Details
GET-executor-details 4 params → 200
PATCH
/custombidrouter/{org_id}/executors/{executor_id}
Executor Update
PATCH-executor-details 4 params body → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mediamath-byoa-api-openapi.yml Raw ↑
#Bidding#Custom Algorithms#BYOA#Optimization
← Back to M APIs
API Details
ID
mediamath:mediamath-bring-your-own-algorithm-byoa-api
Base URL
https://api.byoa.mediamath.com
Docs
https://apidocs.mediamath.com/apis/byoa-api/campaign-settings
Provider
Mediamath
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=mediamath-mediamath-bring-your-own-algorithm-byoa-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/mediamath-mediamath-bring-your-own-algorithm-byoa-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of MediaMath Bring Your Own Algorithm (BYOA) API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.