API Reference SDKs Webhooks Integrations Changelog

API Reference

Build with the VibeCode API

REST endpoints for the Vibe Feed, jobs, prompts, and builder profiles. OAuth 2.0, JSON in and out, cursor-paginated.

Getting started

Quickstart

Three steps: grab a token, pick a language, make your first call.

1Create a personal token in Settings → Developer. Store it as VIBECODE_TOKEN.
2Install the SDK for your language, or call the REST API directly.
3Make your first request and inspect the response.

curl "https://api.vibecode.xyz/v1/feed?limit=5" \
  -H "Authorization: Bearer $VIBECODE_TOKEN"

Base URL & versioning

All requests go to https://api.vibecode.xyz/v1. We version the URL — breaking changes ship as /v2, never in-place. Deprecations are announced 6 months in advance in the changelog.

Authentication

Every request must send a bearer token in the Authorization header.

Personal access tokens

Best for scripts, cron jobs, and single-user tools. Scoped to your account with the permissions you pick at creation time.

cURL

curl "https://api.vibecode.xyz/v1/profiles/me" \
  -H "Authorization: Bearer $VIBECODE_TOKEN"

OAuth 2.0 (for apps)

Building an app that other builders install? Register an OAuth app in Integrations → Build your own and use the authorization code flow.

Redirect the user to /oauth/authorize.
Receive a code at your callback URL.
Exchange it for an access token at /oauth/token.

Conventions

Pagination

List endpoints use opaque cursors. Pass the next value from a response as the cursor query param on the next call. When next is null, you've reached the end.

Errors

Errors return a JSON body with error and message fields, plus a request ID header.

Code	Name	Meaning
400	bad_request	Request was malformed or failed validation.
401	unauthorized	Missing, expired, or invalid credentials.
403	forbidden	Authenticated but not allowed to perform this action.
404	not_found	The requested resource does not exist.
409	conflict	State conflict, e.g. duplicate resource.
422	unprocessable	Semantic validation failed on the payload.
429	rate_limited	You've exceeded your rate limit. Retry after the `Retry-After` header.
500	server_error	Unexpected server error. Safe to retry with backoff.

Rate limits

Every response includes X-RateLimit-Remaining and X-RateLimit-Reset headers. On 429, honour Retry-After.

Tier	Sustained	Burst
Anonymous	60 req/min	120
Personal token	600 req/min	1,200
OAuth app	3,000 req/min	6,000
Enterprise	Custom	Custom

Endpoints

Vibe Feed

GET/feed

List feed posts

Returns a paginated slice of the public Vibe Feed. Supports filtering by tag, author, and time window. Newest posts first.

Parameters

`cursor` query · string	Opaque cursor returned by a previous call. Omit for the first page.
`limit` query · integer	Page size, 1–100. Defaults to 20.
`tag` query · string	Filter by tag slug, e.g. `launch`, `hiring`.
`author` query · string	Filter by builder username.
`since` query · string	ISO-8601 timestamp; only posts created after this time.

Response codes

200OK— A page of feed posts.
401Unauthorized— Missing or invalid token.
429Too Many Requests— Rate limit exceeded.

Request

curl "https://api.vibecode.xyz/v1/feed?tag=launch&limit=20" \
  -H "Authorization: Bearer $VIBECODE_TOKEN"

Response

JSON

{
  "data": [
    {
      "id": "post_2ZkQx1",
      "author": { "username": "ananya", "name": "Ananya Rao" },
      "text": "Shipped v0.4 of my prompt playground ✨",
      "tags": ["launch", "ai"],
      "created_at": "2026-07-13T04:12:00Z",
      "metrics": { "likes": 128, "replies": 14 }
    }
  ],
  "next": "cursor_abc123"
}

POST/feed

Create a post

Publish a new post to the Vibe Feed on behalf of the authenticated builder.

Parameters

`text`required body · string	Post body. Max 2,000 characters. Markdown allowed.
`tags` body · string[]	Up to 5 tag slugs.
`media` body · string[]	Array of asset URLs (images or short video).

Response codes

201Created— Post created.
400Bad Request— Validation failed.
401Unauthorized— Missing or invalid token.

Request

curl -X POST "https://api.vibecode.xyz/v1/feed" \
  -H "Authorization: Bearer $VIBECODE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"Just deployed the new webhook signer!","tags":["shipping"]}'

Response

JSON

{
  "id": "post_2ZkQx2",
  "author": { "username": "you", "name": "You" },
  "text": "Just deployed the new webhook signer!",
  "tags": ["shipping"],
  "created_at": "2026-07-14T09:20:00Z"
}

Endpoints

Jobs

GET/jobs

List jobs

Search the jobs board. Filter by stack, city, remote-friendliness, and seniority. Results are ranked by recency and relevance.

Parameters

`q` query · string	Full-text query across title and description.
`stack` query · string[]	One or more stack slugs, e.g. `nextjs`, `supabase`.
`city` query · string	City slug. Combine with `remote=true` to include remote roles.
`remote` query · boolean	If true, includes fully-remote roles.
`limit` query · integer	Page size, 1–100. Defaults to 20.

Response codes

200OK— A page of jobs.
401Unauthorized— Missing or invalid token.

Request

curl "https://api.vibecode.xyz/v1/jobs?stack=nextjs&remote=true&limit=10" \
  -H "Authorization: Bearer $VIBECODE_TOKEN"

Response

JSON

{
  "data": [
    {
      "id": "job_9F1a",
      "title": "Founding Full-Stack Engineer",
      "company": { "name": "Loopstack", "slug": "loopstack" },
      "location": "Remote",
      "stack": ["nextjs", "supabase", "typescript"],
      "salary": { "min": 90000, "max": 140000, "currency": "USD" },
      "posted_at": "2026-07-10T00:00:00Z"
    }
  ],
  "next": null
}

GET/jobs/{id}

Retrieve a job

Fetch a single job by its ID.

Parameters

idrequired

path · string

The job ID, e.g. `job_9F1a`.

Response codes

200OK— Job returned.
404Not Found— No job with that ID.

Request

curl "https://api.vibecode.xyz/v1/jobs/job_9F1a" \
  -H "Authorization: Bearer $VIBECODE_TOKEN"

Response

JSON

{
  "id": "job_9F1a",
  "title": "Founding Full-Stack Engineer",
  "company": { "name": "Loopstack", "slug": "loopstack" },
  "description": "We're hiring our first engineer to build...",
  "stack": ["nextjs", "supabase"],
  "apply_url": "https://loopstack.co/apply"
}

Endpoints

Prompts

GET/prompts

List prompts

Browse the community prompt library. Filter by model, category, or minimum score.

Parameters

`model` query · string	Model slug, e.g. `gpt-5`, `claude-4-opus`.
`category` query · string	Category slug, e.g. `marketing`, `coding`.
`min_score` query · number	Only return prompts with community score ≥ this value (0–5).
`limit` query · integer	Page size, 1–100. Defaults to 20.

Response codes

200OK— A page of prompts.

Request

curl "https://api.vibecode.xyz/v1/prompts?model=gpt-5&min_score=4.5" \
  -H "Authorization: Bearer $VIBECODE_TOKEN"

Response

JSON

{
  "data": [
    {
      "id": "prm_88",
      "title": "Landing page copy that converts",
      "body": "You are a senior conversion copywriter...",
      "model": "gpt-5",
      "category": "marketing",
      "score": 4.8,
      "author": { "username": "kiran" }
    }
  ],
  "next": null
}

Endpoints

Profiles

GET/profiles/{username}

Retrieve a builder profile

Public profile including XP, streak, badges, and recent projects.

Parameters

usernamerequired

path · string

The builder's handle, without `@`.

Response codes

200OK— Profile returned.
404Not Found— No profile with that username.

Request

curl "https://api.vibecode.xyz/v1/profiles/ananya" \
  -H "Authorization: Bearer $VIBECODE_TOKEN"

Response

JSON

{
  "username": "ananya",
  "name": "Ananya Rao",
  "bio": "Building tiny AI tools in public.",
  "xp": 12480,
  "streak_days": 42,
  "badges": ["og", "shipper", "top-1"],
  "projects": [{ "id": "prj_31", "title": "Prompt Playground" }]
}

Endpoints

Search

GET/search

Universal search

Cross-entity search over posts, jobs, prompts, and profiles.

Parameters

`q`required query · string	The search query.
`types` query · string[]	Any of `post`, `job`, `prompt`, `profile`. Defaults to all.
`limit` query · integer	Per-type page size, 1–50. Defaults to 10.

Response codes

200OK— Results returned.
400Bad Request— Missing `q`.

Request

curl "https://api.vibecode.xyz/v1/search?q=langgraph&types=post,prompt" \
  -H "Authorization: Bearer $VIBECODE_TOKEN"

Response

JSON

{
  "posts": [{ "id": "post_1", "text": "LangGraph tips..." }],
  "prompts": [{ "id": "prm_9", "title": "LangGraph agent boilerplate" }]
}

Endpoints

Webhooks

GET/webhooks

List webhook endpoints

Returns all webhook endpoints registered for the current workspace.

Response codes

200OK— Endpoints returned.

Request

curl "https://api.vibecode.xyz/v1/webhooks" \
  -H "Authorization: Bearer $VIBECODE_TOKEN"

Response

JSON

{
  "data": [
    {
      "id": "wh_1",
      "url": "https://example.com/hooks/vc",
      "events": ["post.created", "job.published"],
      "created_at": "2026-06-01T10:00:00Z"
    }
  ]
}