Message sent!

Someone from our support team will contact you shortly.

Get a Quote

Your email *

Tell us why you're considering making a switch:

Schedule a demo

Your name *

Your email *

Number of team members *

Industry

Tell us why you're considering making a switch:

API

Items API

Add Item

ROUTE: https://www.vivifyscrum.com/api/v1/task

METHOD: POST

HEADERS: Authorization = Bearer YOUR_API_KEY

REQUEST PAYLOAD:

  • name: required, name of the task
  • board: required, code of the board where the task will be added
  • description: optional, task description
  • sprint: optional, name of the sprint (if it is not provided, the task will go to the backlog)
  • email: optional, email of the person that is adding the task
  • points: optional, is used to set the number of points (choose between any number of points that you specified on the board). If not set the value is 0
  • type: optional, is used to set the type of the item (Choose between: "Story" [default], "Improvement", "Bug", "Task", "Note", "Idea")
  • value: optional, is used to set the value you want to add to the task (Choose between: 1 [default], 2, 5, 8, 10, 15, 20, 30, 40, 50)
  • priority: optional, is used to set type of priority ("Normal" [default], "High")
  • checklists: optional, is array of checklists you want to add on task [{ "title": "Checklist1"}, { "title": "Checklist2"}]
  • labels: optional, array of label names that you want to add to the task (labels must first be added to the board)
  • assignees: optional, array of user emails that you want to set as doers (assignees)
  • reviewers: optional, array of user emails you want to set as reviewers
  • parent_task: optional, hash code of the parent task

EXAMPLE:

curl -X POST -H "Authorization: Bearer YOUR_API_KEY" --data-raw '{ "board": "VSVA", "name": "example name", "sprint": "Sprint 1", "points": 1, "labels": [{"name":"documentation" } ] "assignees": [ {"email": "[email protected]"} ], "reviewers": [ { "email":"[email protected]" } ]}' 'https://www.vivifyscrum.com/api/v1/task'

 

Edit Item

ROUTE: https://www.vivifyscrum.com/api/v1/task

METHOD: PUT

HEADERS: Authorization = Bearer YOUR_API_KEY

REQUEST PAYLOAD:

  • task: required, hash code of task you want to edit
  • name: optional, task name
  • description: optional, task description
  • points: optional, is used to set the number of points (choose between any number of points that you specified on the board)
  • type: optional, is used to set the type of item (Choose between: "Story" [default], "Improvement", "Bug", "Task", "Note", "Idea")
  • value: optional, is used to set value you want to add to your task (Choose between: 1 [default], 2, 5, 8, 10, 15, 20, 30, 40, 50)
  • priority: optional, is used to set type of priority ("Normal" [default], "High")
  • checklists: optional, is array of checklists you want to add on task, example:
    [{"First checklist title" : [ "item1", "item2"]}, {"Another checklist title": [ "item1", "item2"]}]
  • labels: optional, array of labels you want to add to the task (labels must first be added to the board)
  • assignees: optional, array of users ids that you want to set as doers (assignees)
  • reviewers: optional, array of users ids you want to set as reviewers
  • parent_task: optional, hash code of the parent task

EXAMPLE:

curl -X PUT -H "Authorization: Bearer YOUR_API_KEY" --data-raw'{"name": "example name", "points": 5, "value": 5, "priority":"High"}'
'https://www.vivifyscrum.com/api/v1/task'



Delete Item

ROUTE: https://www.vivifyscrum.com/api/v1/task

METHOD: DELETE

HEADERS: Authorization = Bearer YOUR_API_KEY

REQUEST PAYLOAD: 

  • task: required, hash code (item code) of the task you want to delete

PERMISSION: Board write actions

EXAMPLE:

curl -X DELETE -H "Authorization: Bearer YOUR_API_KEY" --data-raw '{"task": "TEAA-25"}' 'https://www.vivifyscrum.com/api/v1/task'