weinc

WeInc AI website builder API client for Ruby. Zero dependencies (pure standard library, Net::HTTP only).

WeInc (we.inc) is an AI website builder: describe an app in natural language and get a live, deployable React + Vite + Tailwind site. This gem is a thin, honest client for the WeInc v1 REST API — it wraps the documented endpoints and adds nothing else.

API docs: https://my.we.inc/docs/api
OpenAPI spec: https://my.we.inc/api/v1/docs
Website: https://we.inc

Install

gem install weinc

Or in your Gemfile:

gem "weinc"

Requires Ruby 2.6+.

Quickstart

Get an API key (starts with wk_) from your WeInc agency dashboard.

require "weinc"

weinc = WeInc::Client.new(api_key: ENV["WEINC_API_KEY"])

# 1. List your projects
result = weinc.list_projects(limit: 10)
puts result["total"]

# 2. Fetch one project
project = weinc.get_project(result["projects"].first["id"])["project"]

# 3. Create a project for a client
created = weinc.create_project(
  "client_email" => "client@example.com",
  "name" => "New Site"
)

# 4. Where is it live?
preview = weinc.get_preview_urls(project["id"])
puts preview["published_url"] # nil if never published

# 5. Clients, templates, plans, analytics
clients   = weinc.list_clients
templates = weinc.list_templates
plans     = weinc.list_plans
analytics = weinc.get_analytics(days: 30)

API

All methods return parsed JSON (Hash/Array) and raise WeInc::Error on any failure (with #status and #body when the server responded).

Method	Endpoint
`list_projects(limit:, offset:, client_id:, status:)`	`GET /projects`
`get_project(project_id)`	`GET /projects/{id}`
`create_project(data)`	`POST /projects` (`client_email`, `name` required)
`update_project(project_id, data)`	`PATCH /projects/{id}`
`delete_project(project_id)`	`DELETE /projects/{id}`
`get_preview_urls(project_id)`	`GET /projects/{id}/preview`
`list_clients`	`GET /clients`
`create_client(data)`	`POST /clients` (`email` required)
`get_client(client_id)`	`GET /clients/{id}`
`update_client(client_id, data)`	`PATCH /clients/{id}`
`list_templates`	`GET /templates`
`list_plans`	`GET /plans`
`get_analytics(days:, project_id:)`	`GET /analytics`

An escape hatch is included for endpoints this client does not wrap:

webhooks = weinc.request("GET", "/webhooks")

Notes on accuracy

All wrapped endpoints match the published OpenAPI spec at https://my.we.inc/api/v1/docs, except get_preview_urls, which is implemented by the API but not yet listed in the OpenAPI document; its shape was verified against the WeInc server source on 2026-08-04. If the spec later documents it differently, the spec wins.
Authentication: Authorization: Bearer wk_... org API key.

Testing

ruby test/smoke.rb

The smoke test uses a mocked transport — no live API calls are made.

License

MIT