added route for building a tag (no branch param)

README.md

@@ -179,6 +179,33 @@ ci.startBuild({
 });
 ```  
 
+### startBuildTag
+
+Triggers a new build with no branch, returns a summary of the build.
+
+#### Example Usage
+
+```javascript
+ci.startBuildTag({
+  username: "jpstevens",
+  project: "circleci",
+  body:
+    parallel: null
+    revision: null
+    tag: "v0.1.0"
+    build_parameters:
+      NODE_ENV: "production"
+}).then(function(build){
+  console.log(build);
+});
+```
+
+#### Options
+- **username** [required] - The username for the project
+- **project** [required] - The project (repo) name
+- **options** [optional] - Additional parameters you can pass in
+
+
 ### cancelBuild
 
 Cancels the build, returns a summary of the build.

src/circleci-request.coffee

@@ -39,6 +39,8 @@ class CircleCIRequest
     config.json = true
     if data and data.body
       config.body = data.body
+    if data and data.tag
+      config.body.tag = data.tag
     config
 
   buildQueryObject: (availableOptions, data) ->

src/circleci.coffee

@@ -30,6 +30,9 @@ class CircleCI
   startBuild: (opts) ->
     @request.process @routes['startBuild'], opts
 
+  startBuildTag: (opts) ->
+    @request.process @routes['startBuildTag'], opts
+
   cancelBuild: (opts) ->
     @request.process @routes['cancelBuild'], opts
 

src/routes.json

@@ -41,6 +41,10 @@
     "path": "\/project\/:username\/:project\/tree\/:branch",
     "method": "POST"
   },
+  "startBuildTag": {
+    "path": "\/project\/:username\/:project",
+    "method": "POST"
+  },
   "cancelBuild": {
     "path": "\/project\/:username\/:project\/:build_num\/cancel",
     "method": "POST"

tests/integration/start-build-tag-spec.coffee

@@ -0,0 +1,27 @@
+require 'coffee-script/register'
+expect = require('chai').expect
+sinon = require('sinon')
+CircleCI = require "../../src/circleci"
+APIHelper = require "../helpers/api-helper"
+
+describe "startBuild", ->
+
+  before ->
+    @circleci = new CircleCI { auth: process.env.CIRCLE_TOKEN }
+    @config =
+      username: process.env.CIRCLE_USER
+      project: process.env.CIRCLE_PROJECT
+      body:
+        tag: 'v0.1.0'
+        parallel: null
+        revision: null
+        build_parameters:
+          NODE_ENV: "production"
+          FOO: "bar"
+
+  it "starts the build", (done) ->
+    @circleci.startBuildTag(@config).then (res) ->
+      expect(res).to.be.ok
+      APIHelper.cancelBuild res.build_num, -> done()
+    .catch (err) ->
+      done(err)