AAMP Explorer
On this page
real-time

Planes

Components

Version

per-repository; see components

Licence

Mixed — Apache-2.0, AGPL-3.0, CC BY

AAMP component · specification

agentic-rtb-framework

agentic-rtb-framework is an AAMP specification repository from IAB Tech Lab. ARTF: prose specification plus protobuf contract and Go and Rust implementations for serve-time bid mutations.

Source: IABTechLab/agentic-rtb-framework

Version
v1.0 (1 commits past the tag)
Commit
7f481614
Kind
specification
Substance
substantial
Listed in the hub README
Yes

agentic-rtb-framework on 12 August 2026: version, kind, substance grade and hub listing. Substance is an editorial grade rather than a measurement, on the ranking test.

What this repository defines

1 request and response pair and 12 object definitions. The only specification here that is tagged and marked FINAL: a v1.0 prose document, a protobuf contract, Go and Rust implementations, and five worked request samples.

Request and response pairs

agentic-rtb-framework — 1 request and response pair. The Required column counts top-level required fields on the request, and does not recurse into nested objects.
Message pair Required Summary
GetMutations 0 The single ARTF RPC: a host platform passes a bid request or response to an in-path agent, which returns mutations to apply.

The objects, field by field

These come from the schema and interface files this repository checks in, under the names the source files use.

RTBRequest 8 fields
RTBRequest fields — 8 fields, 0 required
FieldTypeRequiredDescription
lifecycleLifecycleAs per Programmatic Auction Definition IAB TL doc/spec
idstringID of the extension point request, assigned by the exchange, and unique for the exchange's subsequent tracking of the responses.
tmaxint32Maximum time in milliseconds the exchange allows for mutations to be received including latency to avoid timeout
bid_requestcom.iabtechlab.openrtb.v2.BidRequestBid request
bid_responsecom.iabtechlab.openrtb.v2.BidResponseBid response
originatorOriginatorBusiness entity that created and owns the enclosed BidRequest or BidResponse
applicable_intentsIntent[]List of intents the server is eligibible to send back
extExtExtension fields
Ext 0 fields

The published schema declares no fields for this message.

RTBResponse 3 fields
RTBResponse fields — 3 fields, 0 required
FieldTypeRequiredDescription
idstringID of the extension point request to which this is a response.
mutationsMutation[]List of mutations suggesting changes to be applied
metadataMetadataMetadata about the response
Originator 0 fields

The published schema declares no fields for this message.

Mutation 8 fields
Mutation fields — 8 fields, 0 required
FieldTypeRequiredDescription
intentIntentThe purpose of the mutation
opOperationDefines the operation to perform (e.g.
pathstringThe semantic business domain of where the operation will be applied
idsIDsPayloadList of string Identifiers
adjust_dealAdjustDealPayloadAdjust properties of a specific deal
adjust_bidAdjustBidPayloadAdjust the bid price
metricsMetricsPayloadMetrics or telemetry data
content_dataDataPayloadContent data
Metadata 2 fields
Metadata fields — 2 fields, 0 required
FieldTypeRequiredDescription
api_versionstringVersion of the data provider API
model_versionstringThe model version utilized by the container or API to compute the mutation if applicable
IDsPayload 1 field
IDsPayload fields — 1 fields, 0 required
FieldTypeRequiredDescription
idstring[]List of IDs.
AdjustDealPayload 2 fields
AdjustDealPayload fields — 2 fields, 0 required
FieldTypeRequiredDescription
bidfloordoubleSuggested bid floor for the deal
marginMarginSuggested margin for the deal
Margin 1 field
Margin fields — 1 fields, 0 required
FieldTypeRequiredDescription
valuedoubleThe adjusted margin value
AdjustBidPayload 1 field
AdjustBidPayload fields — 1 fields, 0 required
FieldTypeRequiredDescription
pricedoubleThe adjusted bid price
MetricsPayload 1 field
MetricsPayload fields — 1 fields, 0 required
FieldTypeRequiredDescription
metriccom.iabtechlab.openrtb.v2.BidRequest.Imp.Metric[]List of metrics to add
DataPayload 1 field
DataPayload fields — 1 fields, 0 required
FieldTypeRequiredDescription
datacom.iabtechlab.openrtb.v2.BidRequest.Data[]List of data to add