Taiga

https://docs.taiga.io
Admin
Taiga is a free, open-source, and powerful project management platform designed for startups and...
Tokens:233,109
Snippets:944
Trust Score:9.7
Update:9 months ago
Show doc for...
Tokens:
Raw
### Get User Story by Reference (GET)

Source: https://docs.taiga.io/api

Retrieves a specific user story using its reference and either the project ID or project slug. Requires authentication. Useful for accessing user stories when the exact ID is unknown.

```curl
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/userstories/by_ref?ref=1\&project=1
```

--------------------------------

### GET /api/v1/stats/system

Source: https://docs.taiga.io/api

Retrieves system statistics for the Taiga.io instance, if enabled.

```APIDOC
## GET /api/v1/stats/system

### Description
To get the system stats send a GET request. This API will only work if your instance has system stats enabled.

### Method
GET

### Endpoint
/api/v1/stats/system

### Parameters

### Query Parameters

### Request Body

### Request Example
```
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/stats/system
```

### Response
#### Success Response (200)
- **stats** (object) - A JSON object containing system statistics.

#### Response Example
```json
{
  "disk_usage": "70%",
  "memory_usage": "60%"
}
```
```

--------------------------------

### GET /websites/taiga_io/milestone_stats

Source: https://docs.taiga.io/api

Retrieves detailed statistics for a specific milestone within a project. This endpoint returns information about completed tasks, user stories, daily point progression, estimated start and finish dates, and total points accumulated.

```APIDOC
## GET /websites/taiga_io/milestone_stats

### Description
Retrieves detailed statistics for a specific milestone within a project. This endpoint returns information about completed tasks, user stories, daily point progression, estimated start and finish dates, and total points accumulated.

### Method
GET

### Endpoint
/websites/taiga_io/milestone_stats

### Parameters

#### Query Parameters
- **project_id** (string) - Required - The ID of the project.
- **milestone_id** (string) - Required - The ID of the milestone.

### Request Example
```json
{
  "message": "GET request example, no body needed"
}
```

### Response
#### Success Response (200)
- **completed_tasks** (integer) - The number of tasks completed within the milestone.
- **completed_userstories** (integer) - The number of user stories completed within the milestone.
- **days** (array) - An array of daily statistics.
  - **day** (string) - The date of the statistics in YYYY-MM-DD format.
  - **name** (integer) - The day of the month.
  - **open_points** (number) - The number of open points for that day.
  - **optimal_points** (number) - The optimal number of points for that day.
- **estimated_finish** (string) - The estimated finish date of the milestone.
- **estimated_start** (string) - The estimated start date of the milestone.
- **name** (string) - The name of the milestone.
- **total_points** (object) - An object containing total points by status.
- **total_tasks** (integer) - The total number of tasks in the milestone.
- **total_userstories** (integer) - The total number of user stories in the milestone.

#### Response Example
```json
{
    "completed_points": [],
    "completed_tasks": 4,
    "completed_userstories": 0,
    "days": [
        {
            "day": "2020-05-08",
            "name": 8,
            "open_points": 124.0,
            "optimal_points": 124.0
        }
    ],
    "estimated_finish": "2020-05-23",
    "estimated_start": "2020-05-08",
    "iocaine_doses": 0,
    "name": "Sprint 2020-5-8",
    "total_points": {
        "1": 63.0,
        "2": 41.0,
        "3": 17.0,
        "4": 3.0
    },
    "total_tasks": 12,
    "total_userstories": 3
}
```
```

--------------------------------

### Create Project (Basic) - cURL

Source: https://docs.taiga.io/api

Creates a new project with a name and description using a POST request. Requires authentication and content type headers. Returns a 201 Created status on success.

```cURL
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-d '{
        "description": "Beta description",
        "name": "Beta project"
    }' \
-s http://localhost:8000/api/v1/projects
```

--------------------------------

### Get Issue by ID with Curl

Source: https://docs.taiga.io/api

Retrieve a specific issue from Taiga.io by its unique ID using a GET request.

```curl
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/issues/3
```

--------------------------------

### Create Project (Full Options) - cURL

Source: https://docs.taiga.io/api

Creates a new project with comprehensive configuration options including template, module activation, privacy, video conferencing, milestones, and story points. Requires authentication and content type headers. Returns a 201 Created status on success.

```cURL
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-d '{
        "creation_template": 1,
        "description": "Taiga",
        "is_backlog_activated": false,
        "is_issues_activated": true,
        "is_kanban_activated": true,
        "is_private": false,
        "is_wiki_activated": true,
        "name": "Beta project",
        "total_milestones": 3,
        "total_story_points": 20.0,
        "videoconferences": "jitsi",
        "videoconferences_extra_data": null
    }' \
-s http://localhost:8000/api/v1/projects
```

--------------------------------

### GET /api/v1/epic-custom-attributes/{id} - Get Epic Custom Attribute

Source: https://docs.taiga.io/api

Retrieves a specific epic custom attribute by its ID.

```APIDOC
## GET /api/v1/epic-custom-attributes/{id}

### Description
Retrieves a specific epic custom attribute by its ID.

### Method
GET

### Endpoint
/api/v1/epic-custom-attributes/{id}

### Parameters
#### Path Parameters
- **id** (integer) - Required - The ID of the epic custom attribute to retrieve.

### Request Example
```
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/epic-custom-attributes/14
```

### Response
#### Success Response (200 OK)
- **epic custom attribute detail object** (object) - Details of the requested custom attribute.

#### Response Example
```json
{
    "project": 1,
    "name": "Duration 1",
    "order": 10,
    "description": "Initial description",
    "id": 14,
    "created_date": "2023-10-27T09:00:00Z",
    "modified_date": "2023-10-27T09:30:00Z"
}
```
```

--------------------------------

### Create Priority (API)

Source: https://docs.taiga.io/api

Creates a new priority. Requires a name and project ID, and optionally accepts color and order. Returns the created priority object upon success.

```bash
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-d '{
        "color": "#AAAAAA",
        "name": "New priority",
        "order": 8,
        "project": 1
    }' \
-s http://localhost:8000/api/v1/priorities
```

```bash
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-d '{
        "name": "New priority name",
        "project": 1
    }' \
-s http://localhost:8000/api/v1/priorities
```

--------------------------------

### List Projects (Basic)

Source: https://docs.taiga.io/api

Retrieves a list of projects. Requires an authorization token. The response is a 200 OK status with a JSON list of project objects.

```curl
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/projects
```

--------------------------------

### Epic Get API

Source: https://docs.taiga.io/api

Retrieve details for a specific epic by sending a GET request with the epic ID in the URL.

```APIDOC
## GET /api/v1/epics/{epic_id}

### Description
Retrieves the details of a specific epic.

### Method
GET

### Endpoint
`/api/v1/epics/{epic_id}`

### Parameters
#### Path Parameters
- **epic_id** (integer) - Required - The ID of the epic to retrieve.

### Response
#### Success Response (200)
- Returns a JSON object containing the epic's details.

#### Response Example
```json
{
  "id": 1,
  "subject": "Example Epic Subject",
  "project": 1,
  "status": {
    "id": 2,
    "name": "In Progress",
    "is_closed": false
  },
  "assigned_to": {
    "id": 1,
    "username": "user1",
    "full_name": "User One"
  },
  "is_blocked": false,
  "is_closed": false,
  "color": "#FFFFFF",
  "description": "Detailed description of the epic.",
  "tags": ["example", "feature"],
  "created_date": "2023-01-01T10:00:00Z",
  "modified_date": "2023-01-01T11:00:00Z"
}
```
```

--------------------------------

### POST /websites/taiga_io/project_templates

Source: https://docs.taiga.io/api

Create a new project template by sending a POST request with the project's configuration details.

```APIDOC
## POST /websites/taiga_io/project_templates

### Description
To create project templates send a POST request with the following data:

### Method
POST

### Endpoint
/websites/taiga_io/project_templates

### Parameters
#### Request Body
- **name** (string) - Required - The name of the project template.
- **slug** (string) - Optional - The slug for the project template.
- **description** (string) - Required - A description for the project template.
- **default_owner_role** (string) - Required - The default role for the project owner.
- **is_backlog_activated** (boolean) - Optional - Whether the backlog feature is activated.
- **is_kanban_activated** (boolean) - Optional - Whether the kanban feature is activated.
- **is_wiki_activated** (boolean) - Optional - Whether the wiki feature is activated.
- **is_issues_activated** (boolean) - Optional - Whether the issues feature is activated.
- **videoconferences** (string) - Optional - The videoconferencing service to use (e.g., "whereby-com", "jitsi", "talky", "custom").
- **videoconferences_extra_data** (string) - Optional - Additional data for videoconferencing configuration.
- **default_options** (object) - Optional - Default options for the project, including:
  - **points** (string) - Optional - Default points slug.
  - **us_status** (string) - Optional - Default user story status slug.
  - **task_status** (string) - Optional - Default task status slug.
  - **issue_status** (string) - Optional - Default issue status slug.
  - **issue_type** (string) - Optional - Default issue type slug.
  - **priority** (string) - Optional - Default priority slug.
  - **severity** (string) - Optional - Default severity slug.
- **us_statuses** (array) - Optional - A list of user story status objects, each with:
  - **name** (string) - Required - The name of the status.
  - **slug** (string) - Required - The slug for the status.
  - **is_closed** (boolean) - Required - Whether the status indicates a closed state.
  - **color** (string) - Required - The color of the status in #rgb format.
  - **wip_limit** (integer) - Optional - The work-in-progress limit.
  - **order** (integer) - Required - The display order of the status.
- **points** (array) - Optional - A list of points objects, each with:
  - **name** (string) - Required - The name of the point value.
  - **value** (integer or null) - Optional - The numeric value of the point.
  - **order** (integer) - Required - The display order of the point.
- **task_statuses** (array) - Optional - A list of task status objects, each with:
  - **name** (string) - Required - The name of the status.
  - **slug** (string) - Required - The slug for the status.
  - **is_closed** (boolean) - Required - Whether the status indicates a closed state.
  - **color** (string) - Required - The color of the status in #rgb format.
  - **order** (integer) - Required - The display order of the status.
- **issue_statuses** (array) - Optional - A list of issue status objects, each with:
  - **name** (string) - Required - The name of the status.
  - **slug** (string) - Required - The slug for the status.
  - **is_closed** (boolean) - Required - Whether the status indicates a closed state.
  - **color** (string) - Required - The color of the status in #rgb format.
  - **order** (integer) - Required - The display order of the status.
- **issue_types** (array) - Optional - A list of issue type objects, each with:
  - **name** (string) - Required - The name of the issue type.
  - **color** (string) - Required - The color of the issue type in #rgb format.
  - **order** (integer) - Required - The display order of the issue type.
- **priorities** (array) - Optional - A list of priority objects, each with:
  - **name** (string) - Required - The name of the priority.
  - **color** (string) - Required - The color of the priority in #rgb format.
  - **order** (integer) - Required - The display order of the priority.
- **severities** (array) - Optional - A list of severity objects, each with:
  - **name** (string) - Required - The name of the severity.
  - **color** (string) - Required - The color of the severity in #rgb format.
  - **order** (integer) - Required - The display order of the severity.
- **roles** (array) - Optional - A list of role objects, each with:
  - **name** (string) - Required - The name of the role.
  - **slug** (string) - Required - The slug for the role.
  - **permissions** (array) - Required - A list of permissions for the role.
  - **order** (integer) - Required - The display order of the role.
  - **computable** (boolean) - Required - Whether the role is computable.

### Request Example
```json
{
    "default_options": {
        "issue_status": "New",
        "issue_type": "Bug",
        "points": "?",
        "priority": "Normal",
        "severity": "Normal",
        "task_status": "New",
        "us_status": "New"
    },
    "default_owner_role": "product-owner",
    "description": "Sample description",
    "id": 2,
    "is_backlog_activated": false,
    "is_issues_activated": false,
    "is_kanban_activated": true,
    "is_wiki_activated": false,
    "issue_statuses": [
        {
            "color": "#999999",
            "is_closed": false,
            "name": "New",
            "order": 1
        },
        {
            "color": "#729fcf",
            "is_closed": false,
            "name": "In progress",
            "order": 2
        },
        {
            "color": "#f57900",
            "is_closed": true,
            "name": "Ready for test",
            "order": 3
        },
        {
            "color": "#4e9a06",
            "is_closed": true,
            "name": "Closed",
            "order": 4
        },
        {
            "color": "#cc0000",
            "is_closed": false,
            "name": "Needs Info",
            "order": 5
        },
        {
            "color": "#d3d7cf",
            "is_closed": true,
            "name": "Rejected",
            "order": 6
        },
        {
            "color": "#75507b",
            "is_closed": false,
            "name": "Postponed",
            "order": 7
        }
    ],
    "issue_types": [
        {
            "color": "#cc0000",
            "name": "Bug",
            "order": 1
        },
        {
            "color": "#729fcf",
            "name": "Question",
            "order": 2
        },
        {
            "color": "#4e9a06",
            "name": "Enhancement",
            "order": 3
        }
    ],
    "name": "New Template",
    "points": [
        {
            "name": "?",
            "order": 1,
            "value": null
        },
        {
            "name": "0",
            "order": 2,
            "value": 0.0
        },
        {
            "name": "1/2",
            "order": 3,
            "value": 0.5
        },
        {
            "name": "1",
            "order": 4,
            "value": 1.0
        },
        {
            "name": "2",
            "order": 5,
            "value": 2.0
        }
    ]
}
```

### Response
#### Success Response (200)
- **id** (integer) - The ID of the newly created project template.
- **name** (string) - The name of the project template.
- **slug** (string) - The slug of the project template.
- **description** (string) - The description of the project template.
- **default_owner_role** (string) - The default owner role.
- **is_backlog_activated** (boolean) - Indicates if backlog is activated.
- **is_kanban_activated** (boolean) - Indicates if kanban is activated.
- **is_wiki_activated** (boolean) - Indicates if wiki is activated.
- **is_issues_activated** (boolean) - Indicates if issues are activated.
- **videoconferences** (string) - The videoconferencing service configured.
- **videoconferences_extra_data** (string) - Extra data for videoconferencing.
- **default_options** (object) - Default options for the project.
- **us_statuses** (array) - List of user story statuses.
- **points** (array) - List of points configurations.
- **task_statuses** (array) - List of task statuses.
- **issue_statuses** (array) - List of issue statuses.
- **issue_types** (array) - List of issue types.
- **priorities** (array) - List of priorities.
- **severities** (array) - List of severities.
- **roles** (array) - List of roles.

#### Response Example
```json
{
    "id": 1,
    "name": "New Template",
    "slug": "new-template",
    "description": "Sample description",
    "default_owner_role": "product-owner",
    "is_backlog_activated": false,
    "is_kanban_activated": true,
    "is_wiki_activated": false,
    "is_issues_activated": false,
    "videoconferences": null,
    "videoconferences_extra_data": null,
    "default_options": {
        "issue_status": "New",
        "issue_type": "Bug",
        "points": "?",
        "priority": "Normal",
        "severity": "Normal",
        "task_status": "New",
        "us_status": "New"
    },
    "us_statuses": [],
    "points": [
        {
            "name": "?",
            "order": 1,
            "value": null
        },
        {
            "name": "0",
            "order": 2,
            "value": 0.0
        },
        {
            "name": "1/2",
            "order": 3,
            "value": 0.5
        },
        {
            "name": "1",
            "order": 4,
            "value": 1.0
        },
        {
            "name": "2",
            "order": 5,
            "value": 2.0
        }
    ],
    "task_statuses": [],
    "issue_statuses": [
        {
            "color": "#999999",
            "is_closed": false,
            "name": "New",
            "order": 1,
            "slug": "new"
        },
        {
            "color": "#729fcf",
            "is_closed": false,
            "name": "In progress",
            "order": 2,
            "slug": "in-progress"
        },
        {
            "color": "#f57900",
            "is_closed": true,
            "name": "Ready for test",
            "order": 3,
            "slug": "ready-for-test"
        },
        {
            "color": "#4e9a06",
            "is_closed": true,
            "name": "Closed",
            "order": 4,
            "slug": "closed"
        },
        {
            "color": "#cc0000",
            "is_closed": false,
            "name": "Needs Info",
            "order": 5,
            "slug": "needs-info"
        },
        {
            "color": "#d3d7cf",
            "is_closed": true,
            "name": "Rejected",
            "order": 6,
            "slug": "rejected"
        },
        {
            "color": "#75507b",
            "is_closed": false,
            "name": "Postponed",
            "order": 7,
            "slug": "postponed"
        }
    ],
    "issue_types": [
        {
            "color": "#cc0000",
            "name": "Bug",
            "order": 1,
            "slug": "bug"
        },
        {
            "color": "#729fcf",
            "name": "Question",
            "order": 2,
            "slug": "question"
        },
        {
            "color": "#4e9a06",
            "name": "Enhancement",
            "order": 3,
            "slug": "enhancement"
        }
    ],
    "priorities": [],
    "severities": [],
    "roles": []
}
```
```

--------------------------------

### GET /api/v1/epics/custom-attributes-values/{id} - Get Epic Custom Attribute Value

Source: https://docs.taiga.io/api

Retrieves the value of a specific epic custom attribute for an epic.

```APIDOC
## GET /api/v1/epics/custom-attributes-values/{id}

### Description
Retrieves the value of a specific epic custom attribute for an epic.

### Method
GET

### Endpoint
/api/v1/epics/custom-attributes-values/{id}

### Parameters
#### Path Parameters
- **id** (integer) - Required - The ID of the epic for which to retrieve custom attribute values.

### Request Example
```
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/epics/custom-attributes-values/15
```

### Response
#### Success Response (200 OK)
- **epic custom attribute detail object** (object) - Details of the epic's custom attribute values.

#### Response Example
```json
{
    "attributes_values": {
        "14": "240 min",
        "13": "High"
    },
    "version": 1
}
```
```

--------------------------------

### Create Project Template using curl

Source: https://docs.taiga.io/api

Creates a project template from a selected project by sending a POST request with project ID and template details. Requires 'name' and 'description' parameters. Successful creation returns a 201 Created status and a JSON project template detail object.

```curl
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${ADMIN_AUTH_TOKEN}" \
-d '{
        "template_description": "Beta template description",
        "template_name": "Beta template"
    }' \
-s http://localhost:8000/api/v1/projects/1/create_template
```

--------------------------------

### Get Task Status by ID via GET

Source: https://docs.taiga.io/api

Retrieves a specific task status by its ID using a GET request. The task status ID is included in the URL. Requires 'Content-Type: application/json' and 'Authorization' headers. Returns a 200 OK with the task status object on success.

```shell
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/task-statuses/1
```

--------------------------------

### Create Simple Wiki Page

Source: https://docs.taiga.io/api

Creates a new wiki page with essential details like content, project, and slug. This endpoint does not require specifying watchers explicitly. A 201 Created status indicates successful creation.

```curl
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-d '{
        "content": "Lorem ipsum dolor.",
        "project": 1,
        "slug": "new-simple-page"
    }' \
-s http://localhost:8000/api/v1/wiki
```

--------------------------------

### Get Priority by ID (API)

Source: https://docs.taiga.io/api

Retrieves a specific priority by its ID. This operation uses a GET request and requires the priority ID in the URL.

```bash
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/priorities/1
```

--------------------------------

### Start Project Transfer using curl

Source: https://docs.taiga.io/api

Initiates the transfer of a project to another user by sending a POST request with the project ID and the target user's ID. The target user must be an admin member of the project. Successful initiation returns a 200 OK status with an empty response body.

```curl
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-d '{
        "user": 5
    }' \
-s http://localhost:8000/api/v1/projects/1/transfer_start
```

--------------------------------

### Get User Story Detail (GET) - Taiga.io API

Source: https://docs.taiga.io/api

This snippet demonstrates the structure of a GET request response for a specific user story in Taiga.io. It includes comprehensive details such as assigned users, attachments, descriptions, dates, epics, project information, status, and more. The 'neighbors' field is read-only.

```json
{
    "assigned_to": 9,
    "assigned_to_extra_info": {
        "big_photo": null,
        "full_name_display": "Catalina Fernandez",
        "gravatar_id": "9971a763f5dfc5cbd1ce1d2865b4fcfa",
        "id": 9,
        "is_active": true,
        "photo": null,
        "username": "user3"
    },
    "assigned_users": [
        9
    ],
    "attachments": [],
    "backlog_order": 1593690981217,
    "blocked_note": "",
    "blocked_note_html": "",
    "client_requirement": false,
    "comment": "",
    "created_date": "2020-07-02T11:56:21.217Z",
    "description": "Expedita quos dolore adipisci animi harum hic ut sed fugiat, harum voluptates iste obcaecati totam eos deleniti, dolores quo nemo quibusdam? Dolorum expedita veniam eveniet numquam officiis laudantium? Voluptate voluptas molestiae necessitatibus id facilis animi odit dolores enim, maxime cupiditate perspiciatis modi odit eveniet ullam. Consequuntur doloremque sit deserunt earum corrupti architecto eveniet quis amet obcaecati, non ex amet rerum aut facere rem vel delectus fugit tempora nobis, ut debitis ipsam alias iure tenetur, quae voluptatem illum tenetur porro voluptas doloribus, obcaecati corporis porro neque itaque temporibus nulla unde quas tempora.",
    "description_html": "<p>Expedita quos dolore adipisci animi harum hic ut sed fugiat, harum voluptates iste obcaecati totam eos deleniti, dolores quo nemo quibusdam? Dolorum expedita veniam eveniet numquam officiis laudantium? Voluptate voluptas molestiae necessitatibus id facilis animi odit dolores enim, maxime cupiditate perspiciatis modi odit eveniet ullam. Consequuntur doloremque sit deserunt earum corrupti architecto eveniet quis amet obcaecati, non ex amet rerum aut facere rem vel delectus fugit tempora nobis, ut debitis ipsam alias iure tenetur, quae voluptatem illum tenetur porro voluptas doloribus, obcaecati corporis porro neque itaque temporibus nulla unde quas tempora.</p>",
    "due_date": null,
    "due_date_reason": "",
    "due_date_status": "not_set",
    "epic_order": null,
    "epics": [
        {
            "color": "#f57900",
            "id": 15,
            "project": {
                "id": 3,
                "name": "Project Example 2",
                "slug": "project-2"
            },
            "ref": 121,
            "subject": "Patching subject"
        }
    ],
    "external_reference": null,
    "finish_date": null,
    "generated_from_issue": null,
    "generated_from_task": null,
    "id": 1,
    "is_blocked": false,
    "is_closed": false,
    "is_voter": false,
    "is_watcher": false,
    "kanban_order": 1593690981217,
    "milestone": 1,
    "milestone_name": "Sprint 2020-5-8",
    "milestone_slug": "sprint-2020-5-8",
    "modified_date": "2020-07-03T08:40:36.879Z",
    "neighbors": {
        "next": {
            "id": 2,
            "ref": 6,
            "subject": "Lighttpd x-sendfile support"
        },
        "previous": {
            "id": 142,
            "ref": 79,
            "subject": "Customer personal data"
        }
    },
    "origin_issue": null,
    "origin_task": null,
    "owner": 6,
    "owner_extra_info": {
        "big_photo": null,
        "full_name_display": "Vanesa Torres",
        "gravatar_id": "b579f05d7d36f4588b11887093e4ce44",
        "id": 6,
        "is_active": true,
        "photo": null,
        "username": "user2114747470430251528"
    },
    "points": {
        "1": 12,
        "2": 2,
        "3": 5,
        "4": 5
    },
    "project": 1,
    "project_extra_info": {
        "id": 1,
        "logo_small_url": null,
        "name": "Project Example 0",
        "slug": "project-0"
    },
    "ref": 1,
    "sprint_order": 10,
    "status": 4,
    "status_extra_info": {
        "color": "#fcc000",
        "is_closed": false,
        "name": "Ready for test"
    },
    "subject": "Patching subject",
    "tags": [
        [
            "cum",
            null
        ]
    ],
    "tasks": [],
    "team_requirement": false,
    "total_attachments": 4,
    "total_comments": 1,
    "total_points": 44.0,
    "total_voters": 1,
    "total_watchers": 0,
    "tribe_gig": null,
    "version": 2,
    "watchers": []
}
```

--------------------------------

### POST /api/v1/projects

Source: https://docs.taiga.io/api

Creates a new project with specified details. Supports setting various configurations like templates, issue tracking, and privacy.

```APIDOC
## POST /api/v1/projects

### Description
Creates a new project with the provided details. You can specify various configurations such as the name, description, creation template, and module activation status.

### Method
POST

### Endpoint
/api/v1/projects

### Parameters
#### Request Body
- **name** (string) - Required - The name of the project.
- **description** (string) - Required - The description of the project.
- **creation_template** (integer) - Optional - The base template for the project.
- **is_backlog_activated** (boolean) - Optional - Enables the backlog feature.
- **is_issues_activated** (boolean) - Optional - Enables the issue tracking feature.
- **is_kanban_activated** (boolean) - Optional - Enables the Kanban board feature.
- **is_private** (boolean) - Optional - Makes the project private.
- **is_wiki_activated** (boolean) - Optional - Enables the wiki feature.
- **videoconferences** (string) - Optional - The videoconferencing service to use (e.g., "jitsi", "whereby-com").
- **videoconferences_extra_data** (string) - Optional - Additional data for videoconference URL generation.
- **total_milestones** (integer) - Optional - The total number of milestones.
- **total_story_points** (float) - Optional - The total story points for the project.

### Request Example
```json
{
    "description": "Beta description",
    "name": "Beta project"
}
```
```json
{
    "creation_template": 1,
    "description": "Taiga",
    "is_backlog_activated": false,
    "is_issues_activated": true,
    "is_kanban_activated": true,
    "is_private": false,
    "is_wiki_activated": true,
    "name": "Beta project",
    "total_milestones": 3,
    "total_story_points": 20.0,
    "videoconferences": "jitsi",
    "videoconferences_extra_data": null
}
```

### Response
#### Success Response (201)
- **Project Detail Object** (object) - A JSON object representing the newly created project.

#### Response Example
```json
{
  "id": 1,
  "name": "Beta project",
  "description": "Beta description",
  "slug": "beta-project",
  "is_private": false,
  "//": "... other project details ..."
}
```
```

--------------------------------

### Get Issue by Reference with Curl

Source: https://docs.taiga.io/api

Retrieve a specific issue from Taiga.io using its reference and either the project ID or project slug with a GET request.

```curl
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/issues/by_ref?ref=63\&project=1
```

--------------------------------

### POST /api/v1/importers/jira/list_projects

Source: https://docs.taiga.io/api

Lists available Jira projects for import.

```APIDOC
## POST /api/v1/importers/jira/list_projects

### Description
List your Jira projects.

### Method
POST

### Endpoint
/api/v1/importers/jira/list_projects

### Parameters
#### Request Body
- **token** (string) - Required - Your Jira access token.
- **url** (string) - Required - The URL of your Jira server.

### Request Example
```json
{
    "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "url": "http://your.jira.server"
}
```

### Response
#### Success Response (200)
- **importer_projects_object** (object) - A JSON object containing a list of importer projects.

#### Response Example
```json
{
    "projects": [
        {
            "id": "123",
            "name": "Project Alpha"
        },
        {
            "id": "456",
            "name": "Project Beta"
        }
    ]
}
```
```

--------------------------------

### Get Task Attachment API (curl)

Source: https://docs.taiga.io/api

Retrieves a specific task attachment by its ID using a GET request. The attachment ID is part of the URL.

```curl
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/tasks/attachments/461
```

--------------------------------

### Get Jira Authorization URL

Source: https://docs.taiga.io/api

Generates the URL required to authorize Taiga to access your Jira account. This is a GET request specifying your Jira server URL.

```shell
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/importers/jira/auth_url?url=http://your.jira.server
```

--------------------------------

### Like a Project (Curl)

Source: https://docs.taiga.io/api

Allows a user to 'like' a project. Requires project ID in the URL and authentication token. Returns a 200 OK with an empty body on success.

```curl
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/projects/1/like
```

--------------------------------

### POST /api/v1/importers/jira/import

Source: https://docs.taiga.io/api

Imports a project from a Jira instance.

```APIDOC
## POST /api/v1/importers/jira/import

### Description
Ask the server to import a project from Jira.

### Method
POST

### Endpoint
/api/v1/importers/jira/import

### Parameters
#### Request Body
- **name** (string) - Required - The name of the new project.
- **project** (string) - Required - The Jira project ID.
- **token** (string) - Required - Your Jira access token.
- **url** (string) - Required - The URL of your Jira server.
- **description** (string) - Optional - A description for the new project.
- **is_private** (boolean) - Optional - Whether the project should be private.
- **keep_external_reference** (boolean) - Optional - Whether to keep external references.
- **project_type** (string) - Optional - The type of project to import (e.g., "kanban").
- **users_bindings** (object) - Optional - Mapping of Jira users to Taiga user IDs.
    - **user-1** (string) - User binding example.

### Request Example
```json
{
    "description": "New project description",
    "is_private": false,
    "keep_external_reference": false,
    "name": "New project name",
    "project": "123",
    "project_type": "kanban",
    "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "url": "http://your.jira.server",
    "users_bindings": {
        "user-1": "123",
        "user-2": "321"
    }
}
```

### Response
#### Success Response (200 or 202)
- **imported_project_result** (object) - If Taiga is in synchronous mode, returns the imported project details.
- **import_project_accepted** (object) - If Taiga is in asynchronous mode, returns acceptance details for the import job.

#### Response Example (Synchronous)
```json
{
    "id": 1,
    "name": "New project name",
    "slug": "new-project-name"
}
```

#### Response Example (Asynchronous)
```json
{
    "job_id": "abc123xyz",
    "status": "pending"
}
```
```

--------------------------------

### Get Issue Type by ID (API)

Source: https://docs.taiga.io/api

Retrieves a specific issue type by its ID. Requires an authorization token and sends a GET request to the issue types endpoint.

```bash
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/issue-types/1
```

--------------------------------

### POST /api/v1/projects/{project_id}/transfer_start

Source: https://docs.taiga.io/api

Initiates the transfer of a project to another user by sending a POST request with the project ID in the URL and the target user ID in the request body.

```APIDOC
## POST /api/v1/projects/{project_id}/transfer_start

### Description
Initiates the transfer of a project to another user.

### Method
POST

### Endpoint
/api/v1/projects/{project_id}/transfer_start

### Parameters
#### Path Parameters
- **project_id** (integer) - Required - The ID of the project to transfer.

#### Query Parameters
None

#### Request Body
- **user** (integer) - Required - The user ID of the admin member to transfer the project to.

### Request Example
```json
{
  "user": 5
}
```

### Response
#### Success Response (200 OK)
- Empty body.

#### Response Example
(Empty response)
```

--------------------------------

### Get User Story by ID (GET)

Source: https://docs.taiga.io/api

Retrieves a specific user story by its unique ID. Requires authentication. The response includes detailed information about the user story.

```curl
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/userstories/1
```

--------------------------------

### Get Discover Stats (API)

Source: https://docs.taiga.io/api

Fetch discover statistics for the Taiga instance. Send a GET request to the /api/v1/stats/discover endpoint. The response is a JSON object containing the discover stats.

```shell
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/stats/discover
```

--------------------------------

### Bulk Update User Story Kanban Order with cURL

Source: https://docs.taiga.io/api

This cURL example shows how to reorder multiple user stories in the kanban view. It takes the project ID and a list of user stories with their IDs and new order values. A successful operation results in a 200 OK status and returns the updated user story details.

```cURL
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-d '{
        "bulk_stories": [
            {
                "order": 10,
                "us_id": 1
            },
            {
                "order": 15,
                "us_id": 2
            }
        ],
        "project_id": 1
    }' \
-s http://localhost:8000/api/v1/userstories/bulk_update_kanban_order
```

--------------------------------

### Get Wiki Attachment (GET)

Source: https://docs.taiga.io/api

Retrieves a specific wiki page attachment by its ID. Requires the attachment ID in the URL. Returns a 200 OK status with the attachment details.

```curl
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${AUTH_TOKEN}" \
-s http://localhost:8000/api/v1/wiki/attachments/749
```
Tokens:
Raw