aVenture APIContent

Count a person's publications

View as Markdown

Counts one person’s content cards by topic and content type across the whole index, so filters show exact totals before every page loads. Bearer access requires ROLE_ADMIN or ROLE_CLIENT.

Authentication

AuthorizationBearer

User bearer token: Clerk session JWT, Clerk OAuth access token, or Clerk API key

Path parameters

personIdstringRequiredformat: "uuid"
Person UUID whose publications are counted.

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
contentTypeenum
Public content source type.
countlong
Content cards with this topic and content type.
topicstring or nullOptional

Topic key; null when the content carries no topic.

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