Taiga how-tos

Owned by Peter Atthem (Unlicensed)
Last updated: 2023-08-31 by Peter Atthem
1 min read

  1. You need your API username and password for authentication purposes.

  2. API base URL for Taiga instance (like https://api.taiga.io/api/v1).



  1. Authenticate your user

    • Set the request type to POST.

    • Use this URL: <API-base-URL>/auth. Replace <API-base-URL> with your Taiga instance's API URL.

    • Next, set your headers. Under the headers tab, enter:

      • Key is Content-Type

      • Value is application/json

    • Now switch to the body tab and choose the raw option. Add your credentials in form of JSON:

      { "type": "normal", "username": "<Your-Username>", "password": "<Your-Password>" }

    • Click send to make the request. The response contains your auth token which you will need in the subsequent steps, so keep this open.

  2. Create your ticket 

    This action needs to be a child of the first action

    Whichever project you're putting the ticket in, you'll need the project id.

    • Set the request type to POST.

    • Set the URL to <API-base-URL>/issues.

    • Add your headers next:

      • Key is Content-Type

      • Value is application/json

      • Key is Authorization

      • Value is Bearer {Your Auth Token}. Replace {Your Auth Token} with the token got from step 1.

    • Set your body to raw and add your issue details. You'd have to replace each of the <values> with their actual values.

      json

      { "project": <id_of_project>, "subject": "<title_of_issue>", "description": "<description_of_issue>", "tags": ["example-tag-1", "example-tag-2"], "priority": <priority-id>, "status": <status-id> }

    • You can find priority and status ids from the Taiga UI.

    • Click send. Your ticket would be created with the details in the body, it should return a 201 status code.