Whenever you send the incorrect information on app_key or user_token, the response is going to be 401 Unauthorized.
The user_token is per user and when you use this, you will perform actions on behalf of that user, on Runrun.it, it will appear that the user have done the action

How to obtain authentication information to use the API

API access is a premium feature only available for customers of certain paid accounts. To see which plans have API access check here. However developers with ideas for apps taking advantage of Runrun.it are always welcome to contact help@runrun.it about setting up a test account with API access.

Go to your profile on Runrun.it

Then click on Generate

Your app_key will be displayed with the user_token

Data format

All responses will be valid JSON. Requests should be in JSON as well (although for most actions form-encoded data is accepted as well).

All dates will be in ISO 8601 format. The time-zones if specified, will take in account when doing date operations. Another thing to be mentioned is that you need to urlencode your dates if it does contains special characters as + to specify time-zones.

Monitoring

All calls to the API are recorded. Excessive use of the API will result in the offending app_key being revoked to ensure quality of service for other users. If you anticipate a need
to issue a large number of API of calls please enter in contact with support beforehand.

Contacting API Support

If you have any trouble using the API, you can send an email to help@runrun.it.

Response

Stage

302

Headers

Content-Type: text/html; charset=utf-8
Content-Length: 316

Body

<html><body>You are being <a href="https://s3.amazonaws.com/runrunit_dev/data/1/awesome_report_8.txt?AWSAccessKeyId=ABCDEFGHIJKLMNOPQRST&amp;Expires=1542388606&amp;Signature=NJrOAzy4oepfSNVvNn2NomG%2BKb4%3D&amp;response-content-disposition=inline&amp;response-content-type=text%2Fplain">redirected</a>.</body></html>

DELETE

/api/v1.0/documents/:id

Destroy a document

Deleting a document is only possible by the original creator and may only be an option for a limited amount of time. Deleting a document will also delete the file from the cloud storage. It is NOT recoverable.

Body

Manual Work Periods

GET

/api/v1.0/manual_work_periods

List all manual work periods

List all manual work periods. If a user_id and/or task_id is supplied, only
work periods for the given user and/or task will be returned.
from and before can be used to specify a date window, in this resource,
the time and timezone if provided, will be ignored.
The default period is 1 month if not specified.

Response

Stage

204

Headers

Posts

GET

/api/v1.0/posts/unseen_activities

Get unseen post activities

This endpoint will return a data representation for each bulletin board containing the ID of the team, and the number of unread items. The only exception is the enterprise board where the id string: "enterprise".

/api/v1.0/tasks/:task_id/assignments/:id/reopen

Reopen a Task

Reopen a closed task.

IMPORTANT!!: If the task is prerequisite directly or indirectly in
any task that has already been delivered or is under development, it
is necessary to pause or reopen these tasks. You can set the
parameter "reopen_or_pause_descendant_tasks" to automatically pause
or reopen the necessary tasks. To complete this operation with
success it's necessary that the current user is allowed to reopen and
pause all these tasks.

Response

Stage

204

Headers

Tasks

GET

/api/v1.0/tasks

Query tasks

Returns a paginated list of tasks that the user has permission to see.
The number of tasks returned are limited by limit per page and are sorted based on sort and sort_dir.
Use the following Parameters to narrow and customize your query.

Parameters

Name

Description

type

default

ids

IDs of tasks, separated by comma

string

user_id

ID of user who created the task

string

follower_id

ID of user following the task

string

project_id

ID of the project the task belongs to

integer

is_closed

True if the task is delivered

boolean

false

is_working_on

True if any assignee is working on task

boolean

sort

Sort strategy.

string

closed_date if ìs_closed=true; otherwise queue_position

sort_dir

Sort direction. Must be asc or desc

string

desc if ìs_closed=true; otherwise asc

page

The page that will be displayed. Must be equal or greater than 1

integer

1

limit

The number of objects to return per page. The value must be between 1 and 100

integer

1000

bypass_status_default

Set as true to bypass the default value of is_closed param

boolean

false

Request

Route

GET /api/v1.0/tasks?responsible_id=coyote-2&sort=close_date&sort_dir=desc&is_closed=true&project_id=2

/api/v1.0/tasks/:id/reopen

Reopen a Task

Reopen a closed task.

IMPORTANT!!: If the task is prerequisite directly or indirectly in any task that has already been delivered or is under development,
it is necessary to pause or reopen these tasks. You can set the parameter "reopen_or_pause_descendant_tasks" to automatically
pause or reopen the necessary tasks. To complete this operation with success it's necessary that the current user is allowed
to reopen and pause all these tasks.

/api/v1.0/users

Create a user

Create a user on an existing account. Upon creation a temporary password will be created and sent to the new
user by email. Any locale settings (language, time zone, etc.) will be the same as the user issuing the API call. If the
account has reached the maximum number of users a 403 Forbidden will be returned. The make_my_partner and make_everybody_mutual_partners flags are a
convenience for when you may wish to assign tasks to the new user immediately (the same can be accomplished with the Partners API calls).

Parameters

Name

Description

type

user[name]
required

User's full name

string

user[email]
required

User's email

string

make_my_partner

Flag to make the new user a partner of the creating user

boolean

make_everybody_mutual_partners

Flag to make the new user a mutual partner of everybody in enterprise. If not set, defaults to enterprise's configuration

Work Periods

GET

/api/v1.0/work_periods

List all work periods

List all work periods. If a user_id or task_id is supplied, only
work periods for the given user and/or task will be returned.
starting_from, starting_before, ending_from and ending_before can be used
to specify a date window.
The default period is 1 month if not specified.