aVenture APIHarness

Get one run

View as Markdown

Returns one run with its resolved public entity and exact renderable profile URL when available. An admin API key or admin bearer credential addresses every run and receives the privileged projection; any other authenticated caller addresses only runs it owns.

Authentication

AuthorizationBearer

User bearer token: an aVenture API key, an OAuth access token, or a signed-in session token

Path parameters

runIdstringRequiredformat: "uuid"
Harness run id

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

OK
runobject
Canonical harness run
entityobject or nullOptional
Current public entity resolved from the run slug
latestStatusobject or nullOptional

Parsed principal-facing loop progress; null when the raw run status is absent or invalid

providerobject or nullOptional

Parent organization’s core record when the resolved entity is a Product/Service; null for every other entity type

publicUrlstring or nullOptionalformat: "uri"
Exact renderable public profile URL for the resolved entity

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
406
Not Acceptable Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error