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

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.
PropertyValue
Versionv1.0 (1 commits past the tag)
Commit 7f481614
Kindspecification
Substancesubstantial
Listed in the hub READMEYes

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

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

The published schema declares no fields for this message.

RTBResponse

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

The published schema declares no fields for this message.

Mutation

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

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

IDsPayload fields — 1 fields, 0 required
FieldTypeRequiredDescription
idstring[]List of IDs.

AdjustDealPayload

AdjustDealPayload fields — 2 fields, 0 required
FieldTypeRequiredDescription
bidfloordoubleSuggested bid floor for the deal
marginMarginSuggested margin for the deal

Margin

Margin fields — 1 fields, 0 required
FieldTypeRequiredDescription
valuedoubleThe adjusted margin value

AdjustBidPayload

AdjustBidPayload fields — 1 fields, 0 required
FieldTypeRequiredDescription
pricedoubleThe adjusted bid price

MetricsPayload

MetricsPayload fields — 1 fields, 0 required
FieldTypeRequiredDescription
metriccom.iabtechlab.openrtb.v2.BidRequest.Imp.Metric[]List of metrics to add

DataPayload

DataPayload fields — 1 fields, 0 required
FieldTypeRequiredDescription
datacom.iabtechlab.openrtb.v2.BidRequest.Data[]List of data to add

Related