Generated by API Evangelist
Written by API Evangelist tooling for Harness's API. It is a proposal applied on top of the contract, not a document Harness publishes.
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
title: API Evangelist conversational phrasing for Harness GenAI Traces API
version: 1.0.0
extends: openapi/harness-genai-traces-api-openapi.yml
actions:
- target: $.info
update:
x-apievangelist-phrasing:
method: generated
generated: '2026-09-26'
generator: build-phrasing.py
label: Generated by API Evangelist
operations: 3
- target: $.paths['/ccm/api/genai-traces/{traceId}/spans'].get
update:
x-apievangelist-phrasing:
intent: Get the spans of a GenAI trace
effect: read
questions:
- What individual spans make up a specific GenAI trace?
- Can I page through the spans of one LLM trace?
instructions:
- text: Get the spans for GenAI trace {traceId}.
slots:
traceId: path.traceId
- text: Show {limit} spans of trace {traceId} starting at {offset}.
slots:
limit: query.limit
traceId: path.traceId
offset: query.offset
method: generated
generated: '2026-09-26'
- target: $.paths['/ccm/api/genai-traces/services'].get
update:
x-apievangelist-phrasing:
intent: List GenAI services seen in traces
effect: read
questions:
- Which GenAI services has Harness observed over the last year?
- Which of my AI services are still active and when were they last used?
instructions:
- text: List the GenAI services observed in traces.
- text: Show GenAI services in account {account} with their last activity and active status.
slots:
account: query.accountIdentifier
method: generated
generated: '2026-09-26'
- target: $.paths['/ccm/api/genai-traces'].post
update:
x-apievangelist-phrasing:
intent: List GenAI trace summaries
effect: read
questions:
- Can I browse summaries of recent GenAI traces for cost analysis?
- Is it possible to filter GenAI traces by labels and sort them?
instructions:
- text: List GenAI trace summaries matching {filters}.
slots:
filters: requestBody.filters
- text: Show GenAI trace summaries with labels {labelFilters}, sorted by {sortBy}.
slots:
labelFilters: requestBody.labelFilters
sortBy: requestBody.sortBy
method: generated
generated: '2026-09-26'
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.