tasks

Tasks

Task object

{
  "title": "Title of the task",
  "purpose": "<why is this task needed>, optional",
  "featureURL": "<live url of the feature>, optional",
  "type":"feature | group",
  "links": [
    // optional
    <link1>,
    <link2>
  ],
  "endsOn":"<epoch>",
  "startedOn":"<epoch>",
  "status": "AVAILABLE | ASSIGNED | IN_PROGRESS | BLOCKED | SMOKE_TESTING | COMPLETED | NEEDS_REVIEW | IN_REVIEW | APPROVED | MERGED | SANITY_CHECK | REGRESSION_CHECK | RELEASED | VERIFIED",
  "createdBy":"<userId>",
  "assignee":<userId> (in case of individual tasks)",
  "percentCompleted": 0,
  "dependsOn": [
    // optional
    <task_id>,
    <task_id>
  ],
  "level": 1 | 2 | 3 | 4 | 5 // optional - can be added only if category exists, 
  "category": <string> // optional (example: "FRONTEND" | "BACKEND"),
  "participants": [
    // for group tasks
    // optional
    <user_id>
    <user_id>
  ],
  "completionAward": { dinero: 1500, neelam: 1 },
  "lossRate": { dinero: 100 }  // Loss per day of overshoot after deadline,
  'isNoteworthy': true,
  'github': {
    // optional
    'issue': {
      'status': <string>,
      'assignee': <string>, // optional
      'id': <number>,
      'closedAt': <string>, // optional
      'assigneeRdsInfo': {
        // optional
        firstName: <string>,
        lastName: <string>,
        username: <string>
      }
    }
  }
}

Requests

Route	Description
GET /tasks	Returns all tasks
GET /tasks/self	Returns all tasks of a user
POST /tasks	Creates new task
PATCH /tasks/:id	Updates tasks
GET /tasks/:id/details	Get details of a particular task
GET /tasks/:username	Returns all tasks of the user
PATCH /tasks/self/:id	Changes in own task

GET /tasks

Returns all the tasks

• Params
  None
• Query
  None
• Body
  None
• Headers
  None
• Cookie
  None
• Success Response:
• Code: 200
  • Content:

{
  message: 'Tasks returned successfully!'
  tasks: [
           {<task_object>},
           {<task_object>}
         ]
}

• Error Response:
  • Code: 500
    • Content: { 'statusCode': 500, 'error': 'Internal Server Error', 'message': 'An internal server error occurred' }

GET /tasks/self

Returns all the completed tasks of user if query completed=true is passed, else returns all the active and blocked tasks of the user.

• Params
  None
• Query
  completed=[boolean]
• Body
  None
• Headers
  Content-Type: application/json
• Cookie
  rds-session: <JWT>
• Success Response:
  • Code: 200
    • Content:

[
  {<task_object>},
  {<task_object>},
  {<task_object>},
  {<task_object>},
  {<task_object>}
]

• Error Response:
  • Code: 401
    • Content: { 'statusCode': 401, 'error': 'Unauthorized', 'message': 'Unauthenticated User' }
  • Code: 404
    • Content: { 'statusCode': 404, 'error': 'Not Found', 'message': 'User doesn't exist' }
  • Code: 500
    • Content: { 'statusCode': 500, 'error': 'Internal Server Error', 'message': 'An internal server error occurred' }

GET /tasks/:id/details

Returns details of a particular task

• Params
  Required: id=[string]
• Query
  None
• Body
  None
• Headers
  Content-Type: application/json
• Success Response:
  • Code: 200
    • Content:

{
  "message":"task returned successfully",
  "taskData": [
    {<task_object>}
  ]
}

• Error Response:
  • Code: 404
    • Content: { 'statusCode': 404, 'error': 'Not Found', 'message': 'Task not found' }
  • Code: 500
    • Content: { 'statusCode': 500, 'error': 'Internal Server Error', 'message': 'An internal server error occurred' }

GET /tasks/:username

Returns all tasks of the requested user.

• Params
  Required: username=[string]
• Query
  None
• Body
  None
• Headers
  Content-Type: application/json
• Success Response:
  • Code: 200
    • Content:

{
  message: 'Tasks returned successfully!'
  tasks: [
           {<task_object>},
           {<task_object>}
         ]
}

• Error Response:
  • Code: 404
    • Content: { 'statusCode': 404, 'error': 'Not Found', 'message': 'User doesn't exist' }
  • Code: 500
    • Content: { 'statusCode': 500, 'error': 'Internal Server Error', 'message': 'An internal server error occurred' }

POST /tasks

• Params
  None
• Query
  None
• Headers
  Content-Type: application/json
• Body { <task_object> }
• Success Response:
• Code: 200
  • Content:

{
  message: 'Task created successfully!'
  task: {<task_object>}
  id: <newly created task id>
}

• Error Response:
  • Code: 500
    • Content: { 'statusCode': 500, 'error': 'Internal Server Error', 'message': 'An internal server error occurred' }

PATCH /tasks/:id

• Params
  Required: id=[string]

• Headers
  Content-Type: application/json

• Body { <task_object> }

• Success Response:

• Code: 204

  • Content: <No Content>

• Error Response:

  • Code 404
    • Content { 'statusCode': 404, 'error': 'Not found', 'message': 'No tasks found' }
  • Code: 500
    • Content: { 'statusCode': 500, 'error': 'Internal Server Error', 'message': 'An internal server error occurred' }

PATCH /tasks/self/:id

• Params
  Required: id=[string]

• Headers
  Content-Type: application/json

• Body

  { 
    status: <new-status> 
    percentCompleted: <number>
  }
  

• Cookie
  rds-session: <JWT>

• Success Response:

  • Code: 200
    • Content: {'message': 'Task updated successfully!'}

• Error Response:

  • Code: 401
    • Content: { 'statusCode': 401, 'error': 'Unauthorized', 'message': 'User can not be authenticated' }
  • Code: 403
    • Content: { 'statusCode': 403, 'error': 'Forbidden', 'message':'This task is not assigned to you' }
  • Code: 404
    • Content: { 'statusCode': 404, 'error': 'Not Found', 'message': 'Task doesn't exist' }
  • Code: 500
    • Content: { 'statusCode': 500, 'error': 'Internal Server Error', 'message': 'An internal server error occurred' }