# Vynix API - Annotations, MCP Server & Webhooks

> The Vynix REST API: bearer-token auth, a predictable JSON envelope, and documented endpoints for projects, annotations, issues, webhooks and billing.

API reference

# A clean REST API, token-authenticated

Everything the dashboard and MCP server use is available to you. One bearer token, one JSON envelope, no surprises.

[Generate a token](/mcp)[Back to features](/features/)

Authentication

Send your token as a bearer header on every request. Generate one on the MCP page; it’s scoped to your account and never expires for a year.

terminal

curl https://www.vynix.in/api/v1/auth/me \\
  -H "Authorization: Bearer $VYNIX\_TOKEN"

Response envelope

Successful calls return a `data` object. Errors return an `error` with a stable `code`.

200 OK

{
  "data": {
    "id": "ann\_8f2c…",
    "title": "Make the primary CTA larger",
    "type": "bug",
    "priority": "high",
    "status": "open"
  }
}

404 Not Found

{
  "error": {
    "code": "not\_found",
    "message": "Annotation not found.",
    "details": {}
  }
}

## Account

Your profile and personal access tokens.

GET`/api/v1/auth/me`The signed-in user.

POST`/api/v1/auth/api-token`Mint a long-lived MCP/API token.

GET`/api/v1/me/overview`KPI counts, status breakdown, activity.

## Projects

Sites you capture feedback on.

GET`/api/v1/projects`List your projects.

POST`/api/v1/projects`Create a project.

GET`/api/v1/projects/{id}`Fetch one project.

GET`/api/v1/projects/{id}/annotations`List annotations (filter by status, type, priority).

GET`/api/v1/projects/{id}/activity`Recent activity feed.

GET`/api/v1/projects/{id}/issues`Linked GitHub issues + summary.

POST`/api/v1/projects/{id}/issues/sync`Refresh issue state from GitHub.

GET`/api/v1/projects/{id}/members`List team members.

## Annotations

Individual pieces of feedback and their lifecycle.

GET`/api/v1/annotations/{id}`Full annotation with captured context.

PATCH`/api/v1/annotations/{id}/status`Update status.

POST`/api/v1/annotations/{id}/prompt`Generate an agent-ready prompt.

GET`/api/v1/annotations/{id}/comments`List the discussion thread.

POST`/api/v1/annotations/{id}/comments`Add a comment.

POST`/api/v1/annotations/{id}/issue`Open a linked GitHub issue.

## Billing & public

Subscription state and unauthenticated endpoints.

GET`/api/v1/billing/subscription`Current plan and status.

GET`/api/v1/plans`Public list of plans.

GET`/api/v1/health`Liveness probe.

## Stop describing bugs. Point at them.

Add one script tag and give your AI agent the context it has been missing. Free while we grow.

[Get started free](/register)[Read the install guide](/install/)

---

Source: https://www.vynix.in/api/ | Markdown version for AI agents. Full site index: https://www.vynix.in/llms.txt