### Install jq Source: https://docs.taiga.io/api.html Installs the jq command-line JSON processor on Ubuntu systems. ```bash $ sudo apt-get install jq ``` -------------------------------- ### Projects - Transfer start Source: https://docs.taiga.io/api.html Starts the project transfer process. ```APIDOC ## Projects - Transfer start ### Description Starts the project transfer process. ### Method POST ### Endpoint /projects/{id}/transfer/start ### Parameters #### Path Parameters - **id** (integer) - Required - The ID of the project. ``` -------------------------------- ### Transfer start Source: https://docs.taiga.io/api.html Initiates the transfer of one of your projects to another user. ```APIDOC ## POST /api/v1/projects/{project_id}/transfer_start ### Description Starts 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. #### Request Body - **user** (integer) - Required - The user ID of the other admin member of the project. ### Request Example ```json { "user": 5 } ``` ### Response #### Success Response (200 OK) An empty body response indicates success. ``` -------------------------------- ### Get Epic by Reference Source: https://docs.taiga.io/api.html Send a GET request to retrieve a specific epic using its reference and project ID or slug. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/epics/by_ref?ref=121&project=3 ``` -------------------------------- ### Get Project Source: https://docs.taiga.io/api.html Retrieve a specific project by its ID. Requires authentication. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/projects/1 ``` -------------------------------- ### Projects - Watch a project Source: https://docs.taiga.io/api.html Starts watching a project. ```APIDOC ## Projects - Watch a project ### Description Starts watching a project. ### Method POST ### Endpoint /projects/{id}/watchers ### Parameters #### Path Parameters - **id** (integer) - Required - The ID of the project. ``` -------------------------------- ### Create Project (Basic) Source: https://docs.taiga.io/api.html Create a new project with required name and description. Authentication is required. ```bash 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 ``` -------------------------------- ### Create Project (Full Configuration) Source: https://docs.taiga.io/api.html Create a new project with detailed configuration including template, features, and milestones. ```bash 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 Webhook Source: https://docs.taiga.io/api.html Retrieves a specific webhook by its ID. Requires a GET request. ```APIDOC ## GET /api/v1/webhooks/{webhook_id} ### Description To get a webhook send a GET request specifying the webhook id in the url. ### Method GET ### Endpoint /api/v1/webhooks/{webhook_id} ### Parameters #### Path Parameters - **webhook_id** (integer) - Required - The ID of the webhook to retrieve. ### Response #### Success Response (200 OK) - The response body is a JSON webhook detail object. ``` -------------------------------- ### List Projects (Basic) Source: https://docs.taiga.io/api.html Retrieve a list of all projects. Authentication is required. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/projects ``` -------------------------------- ### Create Task with Full Details Source: https://docs.taiga.io/api.html Send a POST request with a JSON body to create a new task. This example includes all possible fields for task creation. ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -d '{ "assigned_to": null, "blocked_note": "blocking reason", "description": "Implement API CALL", "external_reference": null, "is_blocked": false, "is_closed": true, "is_iocaine": false, "milestone": null, "project": 1, "status": 1, "subject": "Customer personal data", "tags": [ "service catalog", "customer" ], "taskboard_order": 1, "us_order": 1, "user_story": 17, "watchers": [] }' \ -s http://localhost:8000/api/v1/tasks ``` -------------------------------- ### Get Issue Source: https://docs.taiga.io/api.html Retrieves a specific issue by its ID using a GET request. ```APIDOC ## GET /api/v1/issues/{issue_id} ### Description Retrieves a specific issue by its ID. ### Method GET ### Endpoint /api/v1/issues/{issue_id} ### Parameters #### Path Parameters - **issue_id** (integer) - Required - The ID of the issue to retrieve. ### Response #### Success Response (200 OK) - The response body is a JSON issue detail object. ``` -------------------------------- ### Get User Stats Source: https://docs.taiga.io/api.html Send a GET request to retrieve the statistics for a specific user. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/users/6/stats ``` -------------------------------- ### Create Wiki Link Source: https://docs.taiga.io/api.html Create a new wiki link. Requires project ID, title, and href. The order parameter is optional. ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -d '{ "href": "home", "order": 1, "project": 1, "title": "Home page" }' \ -s http://localhost:8000/api/v1/wiki-links ``` ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -d '{ "href": "home", "project": 1, "title": "Home page" }' \ -s http://localhost:8000/api/v1/wiki-links ``` -------------------------------- ### Get Current User Source: https://docs.taiga.io/api.html Send a GET request to retrieve the details of the currently authenticated user. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/users/me ``` -------------------------------- ### Get Issue Type Source: https://docs.taiga.io/api.html Send a GET request to retrieve a specific issue type by its ID. ```curl curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/issue-types/1 ``` -------------------------------- ### List Project Templates Source: https://docs.taiga.io/api.html Send a GET request to list project templates. Requires Content-Type and Authorization headers. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/project-templates ``` -------------------------------- ### Import Trello Project Source: https://docs.taiga.io/api.html Initiate a project import from Trello. Specify project details, template, and user bindings. The response indicates success (200 OK) or acceptance for asynchronous processing (202 Accepted). ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -d '{ \ "description": "New project description", \ "is_private": false, \ "keep_external_reference": false, \ "name": "New project name", \ "project": "123ABC", \ "template": "kanban", \ "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", \ "users_bindings": { \ "user-1": "123", \ "user-2": "321" \ } \ }' \ -s http://localhost:8000/api/v1/importers/trello/import ``` -------------------------------- ### Get User Story Source: https://docs.taiga.io/api.html Retrieves a specific user story by its ID using a GET request. ```APIDOC ## GET /api/v1/userstories/{id} ### Description Retrieves a specific user story by its ID. ### Method GET ### Endpoint /api/v1/userstories/{id} ### Parameters #### Path Parameters - **id** (integer) - Required - The ID of the user story to retrieve. ### Response #### Success Response (200 OK) - **User Story Detail Object** (object) - A JSON object representing the user story. #### Response Example (JSON user story detail object) ``` -------------------------------- ### Get Epic by ID Source: https://docs.taiga.io/api.html Send a GET request to retrieve a specific epic using its ID. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/epics/1 ``` -------------------------------- ### Create Issue with Full Details Source: https://docs.taiga.io/api.html Use this endpoint to create a new issue with all possible fields populated. Ensure you have the correct project ID and authentication token. ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -d '{ "assigned_to": null, "blocked_note": "blocking reason", "description": "Implement API CALL", "is_blocked": false, "is_closed": true, "milestone": null, "priority": 3, "project": 1, "severity": 2, "status": 3, "subject": "Customer personal data", "tags": [ "service catalog", "customer" ], "type": 1, "watchers": [] }' \ -s http://localhost:8000/api/v1/issues ``` -------------------------------- ### Get Discover Stats Source: https://docs.taiga.io/api.html Send a GET request to retrieve discover statistics. Requires Content-Type and Authorization headers. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/stats/discover ``` -------------------------------- ### Create Project Source: https://docs.taiga.io/api.html Creates a new project with specified details. ```APIDOC ## POST /api/v1/projects ### Description Creates a new project. ### 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 - Whether backlog is activated. - **is_issues_activated** (boolean) - Optional - Whether issues are activated. - **is_kanban_activated** (boolean) - Optional - Whether Kanban is activated. - **is_private** (boolean) - Optional - Whether the project is private. - **is_wiki_activated** (boolean) - Optional - Whether the wiki is activated. - **videoconferences** (string) - Optional - The third-party service for meetups (e.g., "jitsi", "whereby-com", "talky", "custom"). - **videoconferences_extra_data** (string) - Optional - Extra data for videoconference URL generation. - **total_milestones** (integer) - Optional - The total number of milestones. - **total_story_points** (float) - Optional - The total number of story points. ### Request Example ```json { "description": "Beta description", "name": "Beta project" } ``` ### Response #### Success Response (201) - The response body is a JSON project detail object. ``` -------------------------------- ### Get User by ID Source: https://docs.taiga.io/api.html Send a GET request to retrieve a specific user's details using their ID. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/users/6 ``` -------------------------------- ### Create Project Template Source: https://docs.taiga.io/api.html Generate a project template from an existing project. Requires `template_name` and `template_description` in the request body. ```bash 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 a User Story by ID Source: https://docs.taiga.io/api.html Send a GET request with the user story ID in the URL to retrieve its details. ```curl curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/userstories/1 ``` -------------------------------- ### Create Priority Source: https://docs.taiga.io/api.html Create a new priority. Requires name and project ID. Color and order are optional. ```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 ``` -------------------------------- ### Get Milestone Stats Source: https://docs.taiga.io/api.html Retrieve statistics for a specific milestone by sending a GET request with the milestone ID in the URL. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/milestones/1/stats ``` -------------------------------- ### Import Project Dump Source: https://docs.taiga.io/api.html Send a POST request with a multipart/form-data payload containing the 'dump' file to import a project. The response indicates acceptance or successful creation. ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -F dump=@dump.json \ -s http://localhost:8000/api/v1/importer/load_dump ``` -------------------------------- ### Get Milestone Source: https://docs.taiga.io/api.html Retrieve a specific milestone's details by sending a GET request with the milestone ID in the URL. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/milestones/1 ``` -------------------------------- ### Import Github Project Source: https://docs.taiga.io/api.html Initiate a project import from Github. Specify project details, template, and user bindings. The response indicates success (200 OK) or acceptance for asynchronous processing (202 Accepted). ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -d '{ \ "description": "New project description", \ "is_private": false, \ "keep_external_reference": false, \ "name": "New project name", \ "project": "user/project", \ "template": "kanban", \ "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", \ "users_bindings": { \ "user-1": "123", \ "user-2": "321" \ } \ }' \ -s http://localhost:8000/api/v1/importers/github/import ``` -------------------------------- ### List All Tasks Source: https://docs.taiga.io/api.html Send a GET request to list all tasks. Results can be filtered by various parameters like project, status, tags, and more. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/tasks ``` -------------------------------- ### Get Role Details Source: https://docs.taiga.io/api.html Retrieve details for a specific role by sending a GET request with the role ID in the URL. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/roles/1 ``` -------------------------------- ### Get Membership Details Source: https://docs.taiga.io/api.html Retrieve details for a specific membership by sending a GET request with the membership ID in the URL. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/memberships/1 ``` -------------------------------- ### Create Wiki Page Source: https://docs.taiga.io/api.html Creates a new wiki page. Requires project ID, slug, and content. Watchers can optionally be included. ```APIDOC ## POST /api/v1/wiki ### Description Creates a new wiki page. ### Method POST ### Endpoint /api/v1/wiki ### Parameters #### Request Body - **project** (integer) - Required - The ID of the project. - **slug** (string) - Required - The slug for the wiki page. - **content** (string) - Required - The content of the wiki page. - **watchers** (array) - Optional - An array of watcher IDs. ### Request Example ```json { "content": "Lorem ipsum dolor.", "project": 1, "slug": "new-page", "watchers": [] } ``` ### Response #### Success Response (201) - **wiki page detail object** (object) - Details of the newly created wiki page. ``` -------------------------------- ### Get Notify Policy Source: https://docs.taiga.io/api.html Retrieve a specific notification policy by its ID. This is a GET request specifying the policy ID in the URL. ```curl curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/notify-policies/7 ``` -------------------------------- ### Get Epic Attachment Source: https://docs.taiga.io/api.html Send a GET request to retrieve a specific epic attachment. Requires the attachment ID in the URL. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/epics/attachments/773 ``` -------------------------------- ### List Users Source: https://docs.taiga.io/api.html Send a GET request to list all users. Results can be filtered by project ID. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/users ``` ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/users?project=1 ``` -------------------------------- ### Get Webhook Source: https://docs.taiga.io/api.html Send a GET request with the webhook ID in the URL to retrieve webhook details. Requires 'Content-Type' and 'Authorization' headers. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/webhooks/1 ``` -------------------------------- ### Projects - Create Source: https://docs.taiga.io/api.html Creates a new project. ```APIDOC ## Projects - Create ### Description Creates a new project. ### Method POST ### Endpoint /projects ### Parameters #### Request Body - **name** (string) - Required - The name of the project. - **slug** (string) - Required - The slug for the project URL. - **owner_id** (integer) - Required - The ID of the project owner. - **template_id** (integer) - Optional - The ID of the project template to use. ``` -------------------------------- ### Get User Liked Content Source: https://docs.taiga.io/api.html Send a GET request to retrieve content liked by a user. Results can be filtered by a search query. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/users/6/liked ``` ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/users/6/liked?q=test ``` -------------------------------- ### List Project Timeline Source: https://docs.taiga.io/api.html Send a GET request to list a project's timeline actions. Requires Content-Type and Authorization headers. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/timeline/project/1 ``` -------------------------------- ### Get Issue Status Source: https://docs.taiga.io/api.html Send a GET request to retrieve details of a specific issue status. Requires the status ID in the URL. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/issue-statuses/1 ``` -------------------------------- ### Like a Project Source: https://docs.taiga.io/api.html Send a POST request to like a project. This action increments the project's like count. ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/projects/1/like ``` -------------------------------- ### Get Issue Attachment Source: https://docs.taiga.io/api.html Send a GET request to retrieve details of a specific issue attachment. Requires the attachment ID in the URL. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/issues/attachments/747 ``` -------------------------------- ### Get Specific Task by ID Source: https://docs.taiga.io/api.html Send a GET request specifying the task ID in the URL to retrieve the details of a single task. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/tasks/1 ``` -------------------------------- ### List Github Repositories Source: https://docs.taiga.io/api.html List your Github repositories. Requires a valid token. ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -d '{ \ "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ }' \ -s http://localhost:8000/api/v1/importers/github/list_projects ``` -------------------------------- ### Create Project Template Source: https://docs.taiga.io/api.html Use this cURL command to create a new project template. Ensure you replace placeholder values and include necessary headers. ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${ADMIN_AUTH_TOKEN}" \ -d '{ "default_owner_role": "product-owner", "description": "Sample description", "name": "New simple template" }' \ -s http://localhost:8000/api/v1/project-templates ``` -------------------------------- ### Get User Story Status Source: https://docs.taiga.io/api.html Retrieves a specific user story status by its ID. Requires a GET request with the status ID. ```curl curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/userstory-statuses/1 ``` -------------------------------- ### Get User Story Attachment Source: https://docs.taiga.io/api.html Retrieves a specific user story attachment by its ID. Requires a GET request with the attachment ID. ```curl curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/userstories/attachments/415 ``` -------------------------------- ### Export Project Source: https://docs.taiga.io/api.html Send a GET request with the project ID to initiate a project export. The response varies based on server configuration (synchronous or asynchronous). ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/exporter/1 ``` -------------------------------- ### List Projects (Filtered and Ordered) Source: https://docs.taiga.io/api.html Retrieve a list of projects filtered by member and ordered by user's membership order. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/projects?member=1\&order_by=memberships__user_order ``` -------------------------------- ### Get Epic Status Source: https://docs.taiga.io/api.html Send a GET request to retrieve a specific epic status. Requires the epic status ID in the URL. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/epic-statuses/1 ``` -------------------------------- ### Create Role Source: https://docs.taiga.io/api.html Create a new role by sending a POST request with role details including name, order, project ID, computability, and permissions. ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -d '{ "name": "New role", "order": 10, "permissions": [ "view_us", "view_project" ], "project": 1 }' \ -s http://localhost:8000/api/v1/roles ``` ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -d '{ "name": "New role name", "project": 1 }' \ -s http://localhost:8000/api/v1/roles ``` -------------------------------- ### Get Invitation by Token Source: https://docs.taiga.io/api.html Retrieve invitation details using the invitation token by sending a GET request with the invitation ID in the URL. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/invitations/00000000-0000-0000-0000-000000000000 ``` -------------------------------- ### Get Specific Webhook Log Source: https://docs.taiga.io/api.html Send a GET request to retrieve a specific webhook log by its ID. Requires Content-Type and Authorization headers. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/webhooklogs/1 ``` -------------------------------- ### Create Project Template Source: https://docs.taiga.io/api.html Use this cURL command to send a POST request to create a new project template. Ensure you include your authorization token and the required JSON payload. ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${ADMIN_AUTH_TOKEN}" \ -d '{ "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 } ] }' ``` -------------------------------- ### Get User Voted Content Source: https://docs.taiga.io/api.html Send a GET request to retrieve content voted on by a user. Results can be filtered by type and search query. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/users/6/voted ``` -------------------------------- ### Get Project by Slug Source: https://docs.taiga.io/api.html Retrieve project details by specifying its slug in the query parameters. Requires authentication. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/projects/by_slug?slug=project-0 ``` -------------------------------- ### Get User Watched Content Source: https://docs.taiga.io/api.html Send a GET request to retrieve content watched by a user. Results can be filtered by type and search query. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/users/1/watched ``` ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/users/1/watched?type=project\&q=test ``` -------------------------------- ### List Trello Projects Source: https://docs.taiga.io/api.html Use this endpoint to list your Trello boards. Requires a valid authorization token. ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -d '{ \ "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ }' \ -s http://localhost:8000/api/v1/importers/trello/list_projects ``` -------------------------------- ### Create wiki link Source: https://docs.taiga.io/api.html Creates a new wiki link. Requires project ID, title, and href. Order is optional. ```APIDOC ## POST /api/v1/wiki-links ### Description Creates a new wiki link. ### Method POST ### Endpoint /api/v1/wiki-links ### Parameters #### Request Body - **project** (integer) - Required - The ID of the project. - **title** (string) - Required - The title of the wiki link. - **href** (string) - Required - The wiki page slug. - **order** (integer) - Optional - The order of the wiki link. ### Request Example ```json { "href": "home", "order": 1, "project": 1, "title": "Home page" } ``` ### Response #### Success Response (201) - **wiki_link_detail** (object) - A JSON wiki link detail object. ``` -------------------------------- ### Get Issue Voters List Source: https://docs.taiga.io/api.html Retrieve a list of users who have voted on a specific issue. The issue ID is required in the URL for this GET request. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/issues/3/voters ``` -------------------------------- ### Create Point Source: https://docs.taiga.io/api.html Create a new point by sending a POST request with required fields like 'name', 'value', and 'project'. Optional fields include 'color' and 'order'. ```bash curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -d '{ "color": "#AAAAAA", "name": "Huge", "order": 8, "project": 1, "value": 40 }' \ -s http://localhost:8000/api/v1/points ``` -------------------------------- ### Get epic voters list Source: https://docs.taiga.io/api.html Retrieves a list of users who have voted for a specific epic. Requires a GET request with the epic ID in the URL. ```APIDOC ## GET /api/v1/epics/{epic_id}/voters ### Description Retrieves a list of users who have voted for a specific epic. ### Method GET ### Endpoint /api/v1/epics/{epic_id}/voters ### Parameters #### Path Parameters - **epic_id** (integer) - Required - The ID of the epic for which to retrieve the voters list. ``` -------------------------------- ### Create Wiki Page Source: https://docs.taiga.io/api.html Create a new wiki page by sending a POST request with project ID, slug, content, and optionally watchers. The response is a 201 Created status with the new page details. ```curl curl -X POST \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -d "{ "content": "Lorem ipsum dolor.", "project": 1, "slug": "new-page", "watchers": [] }" \ -s http://localhost:8000/api/v1/wiki ``` ```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 related userstory Source: https://docs.taiga.io/api.html Retrieves a specific user story related to an epic. Requires a GET request with both epic and user story IDs in the URL. ```APIDOC ## GET /api/v1/epics/{epic_id}/related_userstories/{user_story_id} ### Description Retrieves a specific user story that is related to a particular epic. ### Method GET ### Endpoint /api/v1/epics/{epic_id}/related_userstories/{user_story_id} ### Parameters #### Path Parameters - **epic_id** (integer) - Required - The ID of the epic. - **user_story_id** (integer) - Required - The ID of the related user story. ``` -------------------------------- ### Get Project Modules Configuration Source: https://docs.taiga.io/api.html Retrieve the modules configuration for a specific project using its ID. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/projects/1/modules ``` -------------------------------- ### Get System Stats Source: https://docs.taiga.io/api.html Send a GET request to retrieve system statistics. This API requires system stats to be enabled. Requires Content-Type and Authorization headers. ```bash curl -X GET \ -H "Content-Type: application/json" \ -H "Authorization: Bearer ${AUTH_TOKEN}" \ -s http://localhost:8000/api/v1/stats/system ```