Taiga
App · 12 actions
Run your agile projects in Taiga: create and update issues, user stories and tasks, comment, find issues and stories, and start a workflow when an issue or story is created or anything changes status.
Actions
| Action | What it does |
|---|---|
| Add comment | Comment on an issue, user story or task. |
| Create issue | Create an issue in a project, such as a bug from an alert, a question from a support ticket or a request from a form. |
| Create task | Create a task, on a user story or on its own. |
| Create user story | Create a user story in a project's backlog or a sprint. |
| Delete item | Delete an issue, user story or task for good, with its comments. |
| Find issues | Find issues in a project by status, type, priority, severity, assignee, tags, sprint or words. |
| Find user stories | Find user stories in a project by status, sprint, assignee, tags or words. |
| Get item | Get an issue, user story or task, with its comments if you ask for them. |
| List projects | List every project the connected account is a member of. |
| Update issue | Change an issue's status, assignee, priority, severity, type, tags or text, with a comment saying why. |
| Update task | Move a task to another status, assign it, change its tags or text, with a comment saying why. |
| Update user story | Move a user story to another status or sprint, assign it, change its tags or text, with a comment saying why. |
Add comment
Comment on an issue, user story or task. Markdown works.
Inputs
- Project
projecttext - The project it's in. Not needed when you give its link.
- Item type
item_typetext - Whether it's an issue, a user story or a task. A link says which itself.One of:
issue,user_story(User story),task. Default:issue. - Item
itemtextRequired - Its number as Taiga shows it, such as #12, or its link.
- Comment
commenttextRequired - What to write.
Outputs
authortext- Who it's from: the connected account
commenttext- The comment added
comment_idtext- The comment's ID
created_attext- When it was added (ISO 8601)
idnumber- Its ID in Taiga's API
item_typetext- What was commented on: issue, user_story or task
linktext- A link to the item in Taiga
refnumber- Its number in the project (#12)
Example output
{
"author": "Jane Doe",
"comment": "The customer confirmed the fix works.",
"comment_id": "c506e574-da16-11f1-bcb8-e2cb3603feb2",
"created_at": "2026-11-05T15:20:00.031Z",
"id": 412,
"item_type": "issue",
"link": "https://tree.taiga.io/project/acme-website/issue/37",
"ref": 37
}Create issue
Create an issue in a project, such as a bug from an alert, a question from a support ticket or a request from a form.
Inputs
- Project
projecttextRequired - The project to add it to.
- Subject
subjecttextRequired - Its one-line title.
- Description
descriptiontext - The details, in Markdown.
- Type
typetext - What kind of issue, such as Bug, Question or Enhancement. Leave blank for the project's default.
- Priority
prioritytext - How urgent it is. Leave blank for the project's default.
- Severity
severitytext - How serious it is. Leave blank for the project's default.
- Status
statustext - Its status. Leave blank for the project's default, usually New.
- Assigned to
assigned_totext - Who will do it: a project member's username or name, or me.
- Tags
tagslist - Tags to give it, such as support, website.
- Sprint
sprinttext - Put it in this sprint. Leave blank for none.
Outputs
assigned_totext- Who it's assigned to; empty if nobody
assigned_to_usernametext- Their username; empty if nobody
created_attext- When it was created (ISO 8601)
created_bytext- Who created it
descriptiontext- Its description, in Markdown
idnumber- Its ID in Taiga's API
is_closedtrue/false- Whether its status counts as closed
item_typetext- What it is: issue, user_story or task
linktext- A link to it in Taiga
modified_attext- When it last changed (ISO 8601)
prioritytext- Its priority, such as Low, Normal or High
projecttext- The project it's in
project_idnumber- The project's ID
refnumber- Its number in the project, as Taiga shows it (#12)
severitytext- Its severity, such as Minor, Normal or Critical
sprinttext- The sprint it's in; empty if none
sprint_idnumber- The sprint's ID; 0 if none
statustext- Its status, such as New or In progress
subjecttext- Its one-line title
tagslist- Its tags
typetext- The issue's type, such as Bug, Question or Enhancement
versionnumber- Its version, which goes up each time it changes
Example output
{
"assigned_to": "Sam Patel",
"assigned_to_username": "sam",
"created_at": "2026-11-05T09:12:44.512Z",
"created_by": "Jane Doe",
"description": "Submitting the form on /contact never finishes.",
"id": 412,
"is_closed": false,
"item_type": "issue",
"link": "https://tree.taiga.io/project/acme-website/issue/37",
"modified_at": "2026-11-05T14:03:10.207Z",
"priority": "High",
"project": "Website",
"project_id": 8,
"ref": 37,
"severity": "Critical",
"sprint": "Sprint 4",
"sprint_id": 21,
"status": "In progress",
"subject": "Contact form shows a spinner and nothing arrives",
"tags": [
"support",
"website"
],
"type": "Bug",
"version": 3
}Create task
Create a task, on a user story or on its own.
Inputs
- Project
projecttextRequired - The project to add it to.
- Subject
subjecttextRequired - Its one-line title.
- User story
user_storytext - Add it to this user story: its number, such as #12, or its link. Leave blank for a task on its own.
- Description
descriptiontext - The details, in Markdown.
- Status
statustext - Its status. Leave blank for the project's default, usually New.
- Assigned to
assigned_totext - Who will do it: a project member's username or name, or me.
- Tags
tagslist - Tags to give it, such as support, website.
- Sprint
sprinttext - Put it in this sprint. Leave blank for its user story's sprint.
Outputs
assigned_totext- Who it's assigned to; empty if nobody
assigned_to_usernametext- Their username; empty if nobody
created_attext- When it was created (ISO 8601)
created_bytext- Who created it
descriptiontext- Its description, in Markdown
idnumber- Its ID in Taiga's API
is_closedtrue/false- Whether its status counts as closed
item_typetext- What it is: issue, user_story or task
linktext- A link to it in Taiga
modified_attext- When it last changed (ISO 8601)
projecttext- The project it's in
project_idnumber- The project's ID
refnumber- Its number in the project, as Taiga shows it (#12)
sprinttext- The sprint it's in; empty if none
sprint_idnumber- The sprint's ID; 0 if none
statustext- Its status, such as New or In progress
subjecttext- Its one-line title
tagslist- Its tags
user_storytext- That user story's title; empty if none
user_story_refnumber- The number of the user story it's on; 0 if none
versionnumber- Its version, which goes up each time it changes
Example output
{
"assigned_to": "Sam Patel",
"assigned_to_username": "sam",
"created_at": "2026-11-05T09:12:44.512Z",
"created_by": "Jane Doe",
"description": "Plain text and HTML versions.",
"id": 412,
"is_closed": false,
"item_type": "task",
"link": "https://tree.taiga.io/project/acme-website/task/15",
"modified_at": "2026-11-05T14:03:10.207Z",
"project": "Website",
"project_id": 8,
"ref": 15,
"sprint": "Sprint 4",
"sprint_id": 21,
"status": "New",
"subject": "Design the reset email",
"tags": [],
"user_story": "Customers can reset their password",
"user_story_ref": 12,
"version": 3
}Create user story
Create a user story in a project's backlog or a sprint.
Inputs
- Project
projecttextRequired - The project to add it to.
- Subject
subjecttextRequired - Its one-line title.
- Description
descriptiontext - The details, in Markdown.
- Status
statustext - Its status. Leave blank for the project's default, usually New.
- Sprint
sprinttext - Put it in this sprint. Leave blank for the backlog.
- Assigned to
assigned_totext - Who will do it: a project member's username or name, or me.
- Tags
tagslist - Tags to give it, such as support, website.
Outputs
assigned_totext- Who it's assigned to; empty if nobody
assigned_to_usernametext- Their username; empty if nobody
created_attext- When it was created (ISO 8601)
created_bytext- Who created it
descriptiontext- Its description, in Markdown
idnumber- Its ID in Taiga's API
is_closedtrue/false- Whether its status counts as closed
item_typetext- What it is: issue, user_story or task
linktext- A link to it in Taiga
modified_attext- When it last changed (ISO 8601)
projecttext- The project it's in
project_idnumber- The project's ID
refnumber- Its number in the project, as Taiga shows it (#12)
sprinttext- The sprint it's in; empty if none
sprint_idnumber- The sprint's ID; 0 if none
statustext- Its status, such as New or In progress
subjecttext- Its one-line title
tagslist- Its tags
total_pointsnumber- The user story's points, added up over every role
versionnumber- Its version, which goes up each time it changes
Example output
{
"assigned_to": "Sam Patel",
"assigned_to_username": "sam",
"created_at": "2026-11-05T09:12:44.512Z",
"created_by": "Jane Doe",
"description": "As a customer, I can reset my password from the sign-in page.",
"id": 412,
"is_closed": false,
"item_type": "user_story",
"link": "https://tree.taiga.io/project/acme-website/us/12",
"modified_at": "2026-11-05T14:03:10.207Z",
"project": "Website",
"project_id": 8,
"ref": 12,
"sprint": "Sprint 4",
"sprint_id": 21,
"status": "Ready",
"subject": "Customers can reset their password",
"tags": [
"accounts"
],
"total_points": 5.0,
"version": 3
}Delete item
Delete an issue, user story or task for good, with its comments. A user story's tasks are kept, on their own. It can't be restored.
Inputs
- Project
projecttext - The project it's in. Not needed when you give its link.
- Item type
item_typetext - Whether it's an issue, a user story or a task. A link says which itself.One of:
issue,user_story(User story),task. Default:issue. - Item
itemtextRequired - Its number as Taiga shows it, such as #12, or its link.
Outputs
deletedtrue/false- True once deleted
idnumber- Its ID in Taiga's API
item_typetext- What was deleted: issue, user_story or task
refnumber- Its number in the project (#12)
subjecttext- Its title
Example output
{
"deleted": true,
"id": 412,
"item_type": "issue",
"ref": 37,
"subject": "Contact form shows a spinner and nothing arrives"
}Find issues
Find issues in a project by status, type, priority, severity, assignee, tags, sprint or words. Most recently changed first.
Inputs
- Project
projecttextRequired - The project to look in.
- Status
statustext - Any open status, any closed status, any status, or one status. Leave blank for open issues.
- Type
typetext - Only this type.
- Priority
prioritytext - Only this priority.
- Severity
severitytext - Only this severity.
- Assigned to
assigned_totext - Only issues assigned to this member, me, or none for those assigned to nobody.
- Tags
tagslist - Only those with any of these tags.
- Words
texttext - Only those with these words in their title, description or tags, or this number.
- Sprint
sprinttext - Only issues in this sprint, or backlog for those in none.
- How many
limitnumber - The most to list. Defaults to 25.From 1 to 200.
Outputs
countnumber- How many are listed
issueslist- The issues found, most recently changed first
totalnumber- How many match in all
Example output
{
"count": 1,
"issues": [
{
"assigned_to": "Sam Patel",
"assigned_to_username": "sam",
"created_at": "2026-11-05T09:12:44.512Z",
"created_by": "Jane Doe",
"id": 412,
"is_closed": false,
"item_type": "issue",
"link": "https://tree.taiga.io/project/acme-website/issue/37",
"modified_at": "2026-11-05T14:03:10.207Z",
"priority": "High",
"project": "Website",
"project_id": 8,
"ref": 37,
"severity": "Critical",
"sprint": "Sprint 4",
"sprint_id": 21,
"status": "In progress",
"subject": "Contact form shows a spinner and nothing arrives",
"tags": [
"support",
"website"
],
"type": "Bug",
"version": 3
}
],
"total": 1
}Find user stories
Find user stories in a project by status, sprint, assignee, tags or words. Most recently changed first.
Inputs
- Project
projecttextRequired - The project to look in.
- Status
statustext - Any open status, any closed status, any status, or one status. Leave blank for open stories.
- Sprint
sprinttext - Only stories in this sprint, or backlog for those in the backlog.
- Assigned to
assigned_totext - Only stories assigned to this member, me, or none for those assigned to nobody.
- Tags
tagslist - Only those with any of these tags.
- Words
texttext - Only those with these words in their title, description or tags, or this number.
- How many
limitnumber - The most to list. Defaults to 25.From 1 to 200.
Outputs
countnumber- How many are listed
totalnumber- How many match in all
user_storieslist- The user stories found, most recently changed first
Example output
{
"count": 1,
"total": 1,
"user_stories": [
{
"assigned_to": "Sam Patel",
"assigned_to_username": "sam",
"created_at": "2026-11-05T09:12:44.512Z",
"created_by": "Jane Doe",
"id": 412,
"is_closed": false,
"item_type": "user_story",
"link": "https://tree.taiga.io/project/acme-website/us/12",
"modified_at": "2026-11-05T14:03:10.207Z",
"project": "Website",
"project_id": 8,
"ref": 12,
"sprint": "Sprint 4",
"sprint_id": 21,
"status": "Ready",
"subject": "Customers can reset their password",
"tags": [
"accounts"
],
"total_points": 5.0,
"version": 3
}
]
}Get item
Get an issue, user story or task, with its comments if you ask for them.
Inputs
- Project
projecttext - The project it's in. Not needed when you give its link.
- Item type
item_typetext - Whether it's an issue, a user story or a task. A link says which itself.One of:
issue,user_story(User story),task. Default:issue. - Item
itemtextRequired - Its number as Taiga shows it, such as #12, or its link.
- Include comments
include_commentstrue/false - Also get its comments, oldest first (the newest 50).
Outputs
assigned_totext- Who it's assigned to; empty if nobody
assigned_to_usernametext- Their username; empty if nobody
commentslist- Its comments, oldest first (the newest 50); empty unless asked for
created_attext- When it was created (ISO 8601)
created_bytext- Who created it
descriptiontext- Its description, in Markdown
idnumber- Its ID in Taiga's API
is_closedtrue/false- Whether its status counts as closed
item_typetext- What it is: issue, user_story or task
linktext- A link to it in Taiga
modified_attext- When it last changed (ISO 8601)
prioritytext- Its priority, such as Low, Normal or High
projecttext- The project it's in
project_idnumber- The project's ID
refnumber- Its number in the project, as Taiga shows it (#12)
severitytext- Its severity, such as Minor, Normal or Critical
sprinttext- The sprint it's in; empty if none
sprint_idnumber- The sprint's ID; 0 if none
statustext- Its status, such as New or In progress
subjecttext- Its one-line title
tagslist- Its tags
total_pointsnumber- The user story's points, added up over every role
typetext- The issue's type, such as Bug, Question or Enhancement
user_storytext- That user story's title; empty if none
user_story_refnumber- The number of the user story it's on; 0 if none
versionnumber- Its version, which goes up each time it changes
Example output
{
"assigned_to": "Sam Patel",
"assigned_to_username": "sam",
"comments": [
{
"author": "Sam Patel",
"author_username": "sam",
"comment": "Reproduced on Safari; looking at the mail settings.",
"created_at": "2026-11-05T14:03:10.207Z",
"id": "c506e574-da16-11f1-bcb8-e2cb3603feb2"
}
],
"created_at": "2026-11-05T09:12:44.512Z",
"created_by": "Jane Doe",
"description": "Submitting the form on /contact never finishes.",
"id": 412,
"is_closed": false,
"item_type": "issue",
"link": "https://tree.taiga.io/project/acme-website/issue/37",
"modified_at": "2026-11-05T14:03:10.207Z",
"priority": "High",
"project": "Website",
"project_id": 8,
"ref": 37,
"severity": "Critical",
"sprint": "Sprint 4",
"sprint_id": 21,
"status": "In progress",
"subject": "Contact form shows a spinner and nothing arrives",
"tags": [
"support",
"website"
],
"total_points": 0.0,
"type": "Bug",
"user_story": "",
"user_story_ref": 0,
"version": 3
}List projects
List every project the connected account is a member of.
Inputs
None.
Outputs
countnumber- How many
projectslist- The projects
Example output
{
"count": 1,
"projects": [
{
"created_at": "2026-01-14T10:00:00.000Z",
"description": "The company website",
"i_am_admin": true,
"id": 8,
"is_private": true,
"link": "https://tree.taiga.io/project/acme-website",
"name": "Website",
"slug": "acme-website"
}
]
}Update issue
Change an issue's status, assignee, priority, severity, type, tags or text, with a comment saying why. A change someone made to another field at the same moment is kept.
Inputs
- Project
projecttext - The project it's in. Not needed when you give its link.
- Issue
issuetextRequired - The issue's number as Taiga shows it, such as #12, or its link.
- Status
statustext - Move it to this status, such as In progress or Closed. Leave blank to keep it.
- Assigned to
assigned_totext - Who will do it: a member's username or name, me, or none to leave it with nobody. Leave blank to keep it.
- Priority
prioritytext - A new priority. Leave blank to keep it.
- Severity
severitytext - A new severity. Leave blank to keep it.
- Type
typetext - A new type. Leave blank to keep it.
- Subject
subjecttext - A new one-line title. Leave blank to keep it.
- Description
descriptiontext - A new description, in Markdown, replacing the old one. Leave blank to keep it.
- Add tags
add_tagslist - Tags to add to the ones it has.
- Remove tags
remove_tagslist - Tags to take off it.
- Sprint
sprinttext - Move it to this sprint, or backlog for none. Leave blank to keep it.
- Comment
commenttext - A comment to add with the change, saying why. Markdown works.
Outputs
assigned_totext- Who it's assigned to; empty if nobody
assigned_to_usernametext- Their username; empty if nobody
created_attext- When it was created (ISO 8601)
created_bytext- Who created it
descriptiontext- Its description, in Markdown
idnumber- Its ID in Taiga's API
is_closedtrue/false- Whether its status counts as closed
item_typetext- What it is: issue, user_story or task
linktext- A link to it in Taiga
modified_attext- When it last changed (ISO 8601)
prioritytext- Its priority, such as Low, Normal or High
projecttext- The project it's in
project_idnumber- The project's ID
refnumber- Its number in the project, as Taiga shows it (#12)
severitytext- Its severity, such as Minor, Normal or Critical
sprinttext- The sprint it's in; empty if none
sprint_idnumber- The sprint's ID; 0 if none
statustext- Its status, such as New or In progress
subjecttext- Its one-line title
tagslist- Its tags
typetext- The issue's type, such as Bug, Question or Enhancement
versionnumber- Its version, which goes up each time it changes
Example output
{
"assigned_to": "Sam Patel",
"assigned_to_username": "sam",
"created_at": "2026-11-05T09:12:44.512Z",
"created_by": "Jane Doe",
"description": "Submitting the form on /contact never finishes.",
"id": 412,
"is_closed": false,
"item_type": "issue",
"link": "https://tree.taiga.io/project/acme-website/issue/37",
"modified_at": "2026-11-05T14:03:10.207Z",
"priority": "High",
"project": "Website",
"project_id": 8,
"ref": 37,
"severity": "Critical",
"sprint": "Sprint 4",
"sprint_id": 21,
"status": "In progress",
"subject": "Contact form shows a spinner and nothing arrives",
"tags": [
"support",
"website"
],
"type": "Bug",
"version": 3
}Update task
Move a task to another status, assign it, change its tags or text, with a comment saying why. A change someone made to another field at the same moment is kept.
Inputs
- Project
projecttext - The project it's in. Not needed when you give its link.
- Task
tasktextRequired - The task's number as Taiga shows it, such as #12, or its link.
- Status
statustext - Move it to this status, such as In progress or Closed. Leave blank to keep it.
- Assigned to
assigned_totext - Who will do it: a member's username or name, me, or none to leave it with nobody. Leave blank to keep it.
- Subject
subjecttext - A new one-line title. Leave blank to keep it.
- Description
descriptiontext - A new description, in Markdown, replacing the old one. Leave blank to keep it.
- Add tags
add_tagslist - Tags to add to the ones it has.
- Remove tags
remove_tagslist - Tags to take off it.
- Comment
commenttext - A comment to add with the change, saying why. Markdown works.
Outputs
assigned_totext- Who it's assigned to; empty if nobody
assigned_to_usernametext- Their username; empty if nobody
created_attext- When it was created (ISO 8601)
created_bytext- Who created it
descriptiontext- Its description, in Markdown
idnumber- Its ID in Taiga's API
is_closedtrue/false- Whether its status counts as closed
item_typetext- What it is: issue, user_story or task
linktext- A link to it in Taiga
modified_attext- When it last changed (ISO 8601)
projecttext- The project it's in
project_idnumber- The project's ID
refnumber- Its number in the project, as Taiga shows it (#12)
sprinttext- The sprint it's in; empty if none
sprint_idnumber- The sprint's ID; 0 if none
statustext- Its status, such as New or In progress
subjecttext- Its one-line title
tagslist- Its tags
user_storytext- That user story's title; empty if none
user_story_refnumber- The number of the user story it's on; 0 if none
versionnumber- Its version, which goes up each time it changes
Example output
{
"assigned_to": "Sam Patel",
"assigned_to_username": "sam",
"created_at": "2026-11-05T09:12:44.512Z",
"created_by": "Jane Doe",
"description": "Plain text and HTML versions.",
"id": 412,
"is_closed": false,
"item_type": "task",
"link": "https://tree.taiga.io/project/acme-website/task/15",
"modified_at": "2026-11-05T14:03:10.207Z",
"project": "Website",
"project_id": 8,
"ref": 15,
"sprint": "Sprint 4",
"sprint_id": 21,
"status": "New",
"subject": "Design the reset email",
"tags": [],
"user_story": "Customers can reset their password",
"user_story_ref": 12,
"version": 3
}Update user story
Move a user story to another status or sprint, assign it, change its tags or text, with a comment saying why. A change someone made to another field at the same moment is kept.
Inputs
- Project
projecttext - The project it's in. Not needed when you give its link.
- User story
user_storytextRequired - The user story's number as Taiga shows it, such as #12, or its link.
- Status
statustext - Move it to this status, such as In progress or Done. Leave blank to keep it.
- Sprint
sprinttext - Move it to this sprint, or backlog to take it out of its sprint. Leave blank to keep it.
- Assigned to
assigned_totext - Who will do it: a member's username or name, me, or none to leave it with nobody. Leave blank to keep it.
- Subject
subjecttext - A new one-line title. Leave blank to keep it.
- Description
descriptiontext - A new description, in Markdown, replacing the old one. Leave blank to keep it.
- Add tags
add_tagslist - Tags to add to the ones it has.
- Remove tags
remove_tagslist - Tags to take off it.
- Comment
commenttext - A comment to add with the change, saying why. Markdown works.
Outputs
assigned_totext- Who it's assigned to; empty if nobody
assigned_to_usernametext- Their username; empty if nobody
created_attext- When it was created (ISO 8601)
created_bytext- Who created it
descriptiontext- Its description, in Markdown
idnumber- Its ID in Taiga's API
is_closedtrue/false- Whether its status counts as closed
item_typetext- What it is: issue, user_story or task
linktext- A link to it in Taiga
modified_attext- When it last changed (ISO 8601)
projecttext- The project it's in
project_idnumber- The project's ID
refnumber- Its number in the project, as Taiga shows it (#12)
sprinttext- The sprint it's in; empty if none
sprint_idnumber- The sprint's ID; 0 if none
statustext- Its status, such as New or In progress
subjecttext- Its one-line title
tagslist- Its tags
total_pointsnumber- The user story's points, added up over every role
versionnumber- Its version, which goes up each time it changes
Example output
{
"assigned_to": "Sam Patel",
"assigned_to_username": "sam",
"created_at": "2026-11-05T09:12:44.512Z",
"created_by": "Jane Doe",
"description": "As a customer, I can reset my password from the sign-in page.",
"id": 412,
"is_closed": false,
"item_type": "user_story",
"link": "https://tree.taiga.io/project/acme-website/us/12",
"modified_at": "2026-11-05T14:03:10.207Z",
"project": "Website",
"project_id": 8,
"ref": 12,
"sprint": "Sprint 4",
"sprint_id": 21,
"status": "Ready",
"subject": "Customers can reset their password",
"tags": [
"accounts"
],
"total_points": 5.0,
"version": 3
}