API Documentation

Integrate VibeCoded into your applications with our RESTful API.

Overview

The VibeCoded API is a REST API that uses standard HTTP verbs, returns JSON, and uses API key authentication. The base URL for all requests is:

https://api.vibecoded.example/v1

Available on Pro and Enterprise plans. API keys can be generated from Settings → API Keys inside your account.

Authentication

Pass your API key in the Authorization header of every request:

curl https://api.vibecoded.example/v1/projects \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

API keys are prefixed with ac_live_ for production and ac_test_ for sandbox environments. Never expose your API key in client-side code.

Errors & Rate Limits

The API uses conventional HTTP status codes. Errors return a JSON body with error.code and error.message fields.

Rate limits: 1,000 requests / minute on Pro • 10,000 requests / minute on Enterprise. Remaining quota is returned in the X-RateLimit-Remaining response header.

Users

Manage members of your VibeCoded organisation.

GET/v1/usersList all users

GET/v1/users/{id}Retrieve a user

POST/v1/usersInvite a user

DEL/v1/users/{id}Remove a user

Projects

Create and manage projects within your workspace.

GET/v1/projectsList projects

POST/v1/projectsCreate a project

PUT/v1/projects/{id}Update a project

DEL/v1/projects/{id}Archive a project

Tasks

Tasks belong to a project. Use project_id to filter tasks by project.

GET/v1/tasksList tasks

POST/v1/tasksCreate a task

PUT/v1/tasks/{id}Update a task

DEL/v1/tasks/{id}Delete a task

Workflows

Trigger and manage automation workflows programmatically.

GET/v1/workflowsList workflows

POST/v1/workflows/{id}/triggerTrigger a workflow

Webhook Events

Configure webhook endpoints under Settings → Webhooks. VibeCoded will POST a JSON payload to your URL on each event. Sign requests are included in the X-VibeCoded-Signature header.

Available events

task.created • task.updated • task.completed • project.created • workflow.run.completed • user.invited