API documentation

Submit AI model sentiment from your scripts, bots, and tooling using the Vibetracker API.

Quick reference

Base URL

https://vibetracker.app

Auth

Bearer key for writes

Content type

application/json

Available endpoints

POST/api/v1/opinions

Submit sentiment for a model

GET/api/v1/models/sentiment

Fetch current sentiment details

Getting started

1
Create an API key
Copy it immediately. The plaintext value is only shown once.
2
Follow the quickstart
Send your first request with curl, JavaScript, or Python.
3
Read the full reference
Headers, request fields, response shape, errors, and behavior details.

Command-line interface and agent skill

Prefer working in the terminal? The vibetracker-cli package lets you authenticate, submit opinions, inspect valid options, and install the agent skill without leaving your shell.

vtclivibetracker-cli

Install, authenticate, submit, and inspect options

skillvibetracker-rate

Submit honest session ratings from agent harnesses

Authentication

Every request requires a Bearer token in the Authorization header. Invalid, revoked, or expired keys return 401.

API keys are user-scoped. Each key inherits the permissions of the account that created it.