RESTful API

ScrumNinja—the world’s most elegant, intuitive, easy-to-use agile tool that does all the awesome things you want and need it to do.

API Examples

Our RESTful API incorporates Richardson Maturity Level 3. This means it contains links to related resources, so is a self-discoverable web.

Get a list of a user's projects curl "http://scrumninja.com/projects.xml?api_key=XXXXXXXXXXXXX"

This is top level of the API tree, and contains links to all other parts of the system. The API key can be (re)generated from the user's account page.

Modifying objects

Use the POST method to create objects, the PUT method to update them, and the DELETE method to destroy them. Here are some examples using curl:

Create a new story:

curl -H "Content-Type: application/xml; charset=utf-8" -d "<story><name>newly created story</name></story>" "http://scrumninja.com/projects/##/stories.xml?api_key=XXXXXXXXXX"

Update a story attribute:

curl -H "Content-Type: application/xml; charset=utf-8" -X PUT -d "<story><name>new story name</name></story>" "http://scrumninja.com/projects/##/stories/#####.xml?api_key=XXXXXXXXXXXX"