Organize with Labels & Dependencies

Learn how to categorize and prioritize work with labels and dependencies

As your workspace grows, labels and dependencies help you categorize and prioritize work.

python

from praisonaiagents import Agent

agent = Agent(
    name="Triage Agent",
    instructions="Label and prioritise incoming issues.",
)

agent.start("Apply labels to the latest bug reports.")

The user creates labels and dependencies in the UI or API, then agents use them to route and order work.

Diagram

Quick Start

Simple Usage

Create color-coded tags to categorize issues across your workspace.

curl

bash

# Create "bug" label (red)
curl -s -X POST http://localhost:8000/api/v1/workspaces/$WS_ID/labels \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"bug","color":"#FF0000"}' \
  --max-time 10

# Create "feature" label (blue)
curl -s -X POST http://localhost:8000/api/v1/workspaces/$WS_ID/labels \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"feature","color":"#0066FF"}' \
  --max-time 10

Python

python

import asyncio, httpx

async def create_labels():
    base = "http://localhost:8000/api/v1"
    headers = {"Authorization": "Bearer YOUR_TOKEN", "Content-Type": "application/json"}
    ws_id = "your-ws-id"

    async with httpx.AsyncClient() as client:
        # Create bug label
        bug_label = await client.post(f"{base}/workspaces/{ws_id}/labels",
            json={"name": "bug", "color": "#FF0000"}, headers=headers)

        # Create feature label
        feature_label = await client.post(f"{base}/workspaces/{ws_id}/labels",
            json={"name": "feature", "color": "#0066FF"}, headers=headers)

asyncio.run(create_labels())

With Configuration

Connect related issues to show workflow relationships.

curl

bash

# Issue A blocks Issue B
curl -s -X POST http://localhost:8000/api/v1/workspaces/$WS_ID/issues/$ISSUE_A/dependencies/ \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"depends_on_issue_id":"ISSUE_B_ID","type":"blocks"}' \
  --max-time 10

Python

python

async def create_dependency():
    base = "http://localhost:8000/api/v1"
    headers = {"Authorization": "Bearer YOUR_TOKEN", "Content-Type": "application/json"}
    ws_id = "your-ws-id"

    async with httpx.AsyncClient() as client:
        await client.post(f"{base}/workspaces/{ws_id}/issues/{issue_a_id}/dependencies/",
            json={"depends_on_issue_id": issue_b_id, "type": "blocks"}, headers=headers)

How Labels Work

Labels are color-coded tags you attach to issues for easy categorization and filtering.

Diagram

Label Management

Action	Description
Create	Define workspace-wide labels with colors
Tag	Attach labels to issues
Filter	Find issues by label
Remove	Untag labels from issues

Tag an Issue

curl

bash

curl -s -X POST http://localhost:8000/api/v1/workspaces/$WS_ID/issues/$ISSUE_ID/labels/$LABEL_ID \
  -H "Authorization: Bearer $TOKEN" \
  --max-time 10

Python

python

async def tag_issue():
    await client.post(f"{base}/workspaces/{ws_id}/issues/{issue_id}/labels/{label_id}", 
        headers=headers)

List Issue Labels

curl

bash

curl -s http://localhost:8000/api/v1/workspaces/$WS_ID/issues/$ISSUE_ID/labels \
  -H "Authorization: Bearer $TOKEN" \
  --max-time 10

Python

python

async def get_issue_labels():
    response = await client.get(f"{base}/workspaces/{ws_id}/issues/{issue_id}/labels", 
        headers=headers)
    return response.json()

How Dependencies Work

Dependencies link issues to show relationships and execution order.

Diagram

Dependency Types

Type	Description	Use Case
`blocks`	Must finish before dependent can start	Sequential work
`related`	Connected but not blocking	Context sharing
`duplicates`	Same work, different issues	Issue cleanup

View Dependencies

curl

bash

curl -s http://localhost:8000/api/v1/workspaces/$WS_ID/issues/$ISSUE_A/dependencies/ \
  -H "Authorization: Bearer $TOKEN" \
  --max-time 10

Python

python

async def get_dependencies():
    response = await client.get(f"{base}/workspaces/{ws_id}/issues/{issue_id}/dependencies/", 
        headers=headers)
    return response.json()

Putting It Together

Organize a complete workflow using labels and dependencies.

Diagram

Example: Backend Feature Pipeline

curl

bash

# Create backend label
curl -s -X POST http://localhost:8000/api/v1/workspaces/$WS_ID/labels \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"backend","color":"#6366F1"}' \
  --max-time 10

# Create three issues
curl -s -X POST http://localhost:8000/api/v1/workspaces/$WS_ID/issues/ \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"Setup Database"}' \
  --max-time 10

curl -s -X POST http://localhost:8000/api/v1/workspaces/$WS_ID/issues/ \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"Build API"}' \
  --max-time 10

curl -s -X POST http://localhost:8000/api/v1/workspaces/$WS_ID/issues/ \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"Write Tests"}' \
  --max-time 10

# Tag all with backend label
curl -s -X POST http://localhost:8000/api/v1/workspaces/$WS_ID/issues/$DB_ISSUE_ID/labels/$BACKEND_LABEL_ID \
  -H "Authorization: Bearer $TOKEN" \
  --max-time 10

# Create dependency chain: DB blocks API blocks Tests
curl -s -X POST http://localhost:8000/api/v1/workspaces/$WS_ID/issues/$DB_ISSUE_ID/dependencies/ \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"depends_on_issue_id":"API_ISSUE_ID","type":"blocks"}' \
  --max-time 10

curl -s -X POST http://localhost:8000/api/v1/workspaces/$WS_ID/issues/$API_ISSUE_ID/dependencies/ \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"depends_on_issue_id":"TESTS_ISSUE_ID","type":"blocks"}' \
  --max-time 10

Python

python

import asyncio, httpx

async def organize_workflow():
    base = "http://localhost:8000/api/v1"
    headers = {"Authorization": "Bearer YOUR_TOKEN", "Content-Type": "application/json"}
    ws_id = "your-ws-id"

    async with httpx.AsyncClient() as client:
        # Create backend label
        label_response = await client.post(f"{base}/workspaces/{ws_id}/labels",
            json={"name": "backend", "color": "#6366F1"}, headers=headers)
        label = label_response.json()

        # Create three issues
        db_response = await client.post(f"{base}/workspaces/{ws_id}/issues/",
            json={"title": "Setup Database"}, headers=headers)
        db_issue = db_response.json()

        api_response = await client.post(f"{base}/workspaces/{ws_id}/issues/",
            json={"title": "Build API"}, headers=headers)
        api_issue = api_response.json()

        tests_response = await client.post(f"{base}/workspaces/{ws_id}/issues/",
            json={"title": "Write Tests"}, headers=headers)
        tests_issue = tests_response.json()

        # Tag all with backend label
        for issue in [db_issue, api_issue, tests_issue]:
            await client.post(f"{base}/workspaces/{ws_id}/issues/{issue['id']}/labels/{label['id']}", 
                headers=headers)

        # Create dependency chain
        await client.post(f"{base}/workspaces/{ws_id}/issues/{db_issue['id']}/dependencies/",
            json={"depends_on_issue_id": api_issue["id"], "type": "blocks"}, headers=headers)

        await client.post(f"{base}/workspaces/{ws_id}/issues/{api_issue['id']}/dependencies/",
            json={"depends_on_issue_id": tests_issue["id"], "type": "blocks"}, headers=headers)

asyncio.run(organize_workflow())

Best Practices

Use Consistent Label Names

Create standard labels like “bug”, “feature”, “urgent” that team members recognize. Avoid duplicate labels with similar meanings.

Color Code by Priority

Use red for urgent issues, blue for features, green for improvements. Consistent colors help visual scanning.

Plan Dependencies Early

Map blocking relationships before starting work. This prevents bottlenecks and clarifies execution order.

Review Dependencies Regularly

Check if blocking issues are resolved and update dependency status. Remove outdated links to keep the graph clean.

Platform Issues

Create and manage issues in your workspace

Issue IDs

Understanding issue identification and references

Organize with Labels & Dependencies

Quick Start

curl

Python

curl

Python

How Labels Work

Label Management

Tag an Issue

curl

Python

List Issue Labels

curl

Python

How Dependencies Work

Dependency Types

View Dependencies

curl

Python

Putting It Together

Example: Backend Feature Pipeline

curl

Python

Best Practices

Related