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

ActionWhat it does
Add commentComment on an issue, user story or task.
Create issueCreate 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 taskCreate a task, on a user story or on its own.
Create user storyCreate a user story in a project's backlog or a sprint.
Delete itemDelete an issue, user story or task for good, with its comments.
Find issuesFind issues in a project by status, type, priority, severity, assignee, tags, sprint or words.
Find user storiesFind user stories in a project by status, sprint, assignee, tags or words.
Get itemGet an issue, user story or task, with its comments if you ask for them.
List projectsList every project the connected account is a member of.
Update issueChange an issue's status, assignee, priority, severity, type, tags or text, with a comment saying why.
Update taskMove a task to another status, assign it, change its tags or text, with a comment saying why.
Update user storyMove 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

Projectprojecttext
The project it's in. Not needed when you give its link.
Item typeitem_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.
ItemitemtextRequired
Its number as Taiga shows it, such as #12, or its link.
CommentcommenttextRequired
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

ProjectprojecttextRequired
The project to add it to.
SubjectsubjecttextRequired
Its one-line title.
Descriptiondescriptiontext
The details, in Markdown.
Typetypetext
What kind of issue, such as Bug, Question or Enhancement. Leave blank for the project's default.
Priorityprioritytext
How urgent it is. Leave blank for the project's default.
Severityseveritytext
How serious it is. Leave blank for the project's default.
Statusstatustext
Its status. Leave blank for the project's default, usually New.
Assigned toassigned_totext
Who will do it: a project member's username or name, or me.
Tagstagslist
Tags to give it, such as support, website.
Sprintsprinttext
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

ProjectprojecttextRequired
The project to add it to.
SubjectsubjecttextRequired
Its one-line title.
User storyuser_storytext
Add it to this user story: its number, such as #12, or its link. Leave blank for a task on its own.
Descriptiondescriptiontext
The details, in Markdown.
Statusstatustext
Its status. Leave blank for the project's default, usually New.
Assigned toassigned_totext
Who will do it: a project member's username or name, or me.
Tagstagslist
Tags to give it, such as support, website.
Sprintsprinttext
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

ProjectprojecttextRequired
The project to add it to.
SubjectsubjecttextRequired
Its one-line title.
Descriptiondescriptiontext
The details, in Markdown.
Statusstatustext
Its status. Leave blank for the project's default, usually New.
Sprintsprinttext
Put it in this sprint. Leave blank for the backlog.
Assigned toassigned_totext
Who will do it: a project member's username or name, or me.
Tagstagslist
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

Projectprojecttext
The project it's in. Not needed when you give its link.
Item typeitem_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.
ItemitemtextRequired
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

ProjectprojecttextRequired
The project to look in.
Statusstatustext
Any open status, any closed status, any status, or one status. Leave blank for open issues.
Typetypetext
Only this type.
Priorityprioritytext
Only this priority.
Severityseveritytext
Only this severity.
Assigned toassigned_totext
Only issues assigned to this member, me, or none for those assigned to nobody.
Tagstagslist
Only those with any of these tags.
Wordstexttext
Only those with these words in their title, description or tags, or this number.
Sprintsprinttext
Only issues in this sprint, or backlog for those in none.
How manylimitnumber
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

ProjectprojecttextRequired
The project to look in.
Statusstatustext
Any open status, any closed status, any status, or one status. Leave blank for open stories.
Sprintsprinttext
Only stories in this sprint, or backlog for those in the backlog.
Assigned toassigned_totext
Only stories assigned to this member, me, or none for those assigned to nobody.
Tagstagslist
Only those with any of these tags.
Wordstexttext
Only those with these words in their title, description or tags, or this number.
How manylimitnumber
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

Projectprojecttext
The project it's in. Not needed when you give its link.
Item typeitem_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.
ItemitemtextRequired
Its number as Taiga shows it, such as #12, or its link.
Include commentsinclude_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

Projectprojecttext
The project it's in. Not needed when you give its link.
IssueissuetextRequired
The issue's number as Taiga shows it, such as #12, or its link.
Statusstatustext
Move it to this status, such as In progress or Closed. Leave blank to keep it.
Assigned toassigned_totext
Who will do it: a member's username or name, me, or none to leave it with nobody. Leave blank to keep it.
Priorityprioritytext
A new priority. Leave blank to keep it.
Severityseveritytext
A new severity. Leave blank to keep it.
Typetypetext
A new type. Leave blank to keep it.
Subjectsubjecttext
A new one-line title. Leave blank to keep it.
Descriptiondescriptiontext
A new description, in Markdown, replacing the old one. Leave blank to keep it.
Add tagsadd_tagslist
Tags to add to the ones it has.
Remove tagsremove_tagslist
Tags to take off it.
Sprintsprinttext
Move it to this sprint, or backlog for none. Leave blank to keep it.
Commentcommenttext
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

Projectprojecttext
The project it's in. Not needed when you give its link.
TasktasktextRequired
The task's number as Taiga shows it, such as #12, or its link.
Statusstatustext
Move it to this status, such as In progress or Closed. Leave blank to keep it.
Assigned toassigned_totext
Who will do it: a member's username or name, me, or none to leave it with nobody. Leave blank to keep it.
Subjectsubjecttext
A new one-line title. Leave blank to keep it.
Descriptiondescriptiontext
A new description, in Markdown, replacing the old one. Leave blank to keep it.
Add tagsadd_tagslist
Tags to add to the ones it has.
Remove tagsremove_tagslist
Tags to take off it.
Commentcommenttext
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

Projectprojecttext
The project it's in. Not needed when you give its link.
User storyuser_storytextRequired
The user story's number as Taiga shows it, such as #12, or its link.
Statusstatustext
Move it to this status, such as In progress or Done. Leave blank to keep it.
Sprintsprinttext
Move it to this sprint, or backlog to take it out of its sprint. Leave blank to keep it.
Assigned toassigned_totext
Who will do it: a member's username or name, me, or none to leave it with nobody. Leave blank to keep it.
Subjectsubjecttext
A new one-line title. Leave blank to keep it.
Descriptiondescriptiontext
A new description, in Markdown, replacing the old one. Leave blank to keep it.
Add tagsadd_tagslist
Tags to add to the ones it has.
Remove tagsremove_tagslist
Tags to take off it.
Commentcommenttext
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
}

On this page