Problem
The get_creative_features endpoint evaluates a creative manifest against a governance agent and returns feature values for that creative:
"Evaluates a creative manifest and returns feature values from a creative governance agent."
The name get_creative_features is ambiguous — it could mean:
- Get the list of available features (feature discovery)
- Evaluate a creative and return its feature values (feature evaluation)
The current endpoint does #2, but the name suggests #1. This creates a discoverability problem: agents reading the capability manifest may not understand that get_creative_features is an evaluation endpoint requiring a creative_manifest input, not a catalog endpoint.
Impact
- Agents may not find the evaluation endpoint when looking for "assess creative" or "evaluate creative"
- The name could conflict with a future "list supported features" discovery endpoint
- The spec description itself says "task" (
"Request payload for get_creative_features task") which conflicts with the synchronous nature of the endpoint
Proposed Fix
Consider renaming to one of:
evaluate_creative — most direct
assess_creative — common in brand safety/governance context
get_creative_assessment — noun-form consistent with get_signals, get_products
If renaming is not feasible, at minimum clarify the spec description to say "evaluation" rather than "task", and add a note distinguishing this from any future feature-discovery endpoint.
Affected Schemas
creative/get-creative-features-request.json
creative/get-creative-features-response.json
creative/creative-feature-result.json
Problem
The
get_creative_featuresendpoint evaluates a creative manifest against a governance agent and returns feature values for that creative:The name
get_creative_featuresis ambiguous — it could mean:The current endpoint does #2, but the name suggests #1. This creates a discoverability problem: agents reading the capability manifest may not understand that
get_creative_featuresis an evaluation endpoint requiring acreative_manifestinput, not a catalog endpoint.Impact
"Request payload for get_creative_features task") which conflicts with the synchronous nature of the endpointProposed Fix
Consider renaming to one of:
evaluate_creative— most directassess_creative— common in brand safety/governance contextget_creative_assessment— noun-form consistent withget_signals,get_productsIf renaming is not feasible, at minimum clarify the spec description to say "evaluation" rather than "task", and add a note distinguishing this from any future feature-discovery endpoint.
Affected Schemas
creative/get-creative-features-request.jsoncreative/get-creative-features-response.jsoncreative/creative-feature-result.json