Platform Labels

Create workspace-level labels and attach them to issues for categorisation

Colour-coded labels organise platform issues by type, priority, or team — attach them from an agent or the SDK.

import os
from praisonaiagents import Agent
from praisonai_platform.client import PlatformClient

agent = Agent(
    name="label-manager",
    instructions="Categorise issues with workspace labels (bug, feature, urgent).",
)

async with PlatformClient(
    os.getenv("PLATFORM_URL", "http://localhost:8000"),
    token=os.getenv("PLATFORM_TOKEN"),
) as client:
    label = await client.create_label("ws-123", name="bug", color="#dc2626")
    await client.add_label_to_issue("ws-123", "issue-456", label["id"])

The user asks to triage issues; the agent creates labels and attaches them on the platform.

Quick Start

1. Simple Usage

   Create a label and attach it to an issue:

   import os
   import asyncio
   from praisonai_platform.client import PlatformClient
   
   async def tag_issue():
       async with PlatformClient(
           os.getenv("PLATFORM_URL", "http://localhost:8000"),
           token=os.getenv("PLATFORM_TOKEN"),
       ) as client:
           label = await client.create_label(
               "ws-123",
               name="bug",
               color="#dc2626",
           )
           await client.add_label_to_issue("ws-123", "issue-456", label["id"])
   
   asyncio.run(tag_issue())

2. With Configuration

   List labels, update colours, and remove labels from issues:

   import os
   import asyncio
   from praisonai_platform.client import PlatformClient
   
   async def manage_labels():
       async with PlatformClient(
           os.getenv("PLATFORM_URL", "http://localhost:8000"),
           token=os.getenv("PLATFORM_TOKEN"),
       ) as client:
           labels = await client.list_labels("ws-123")
           await client.update_label("ws-123", labels[0]["id"], color="#991b1b")
           await client.remove_label_from_issue("ws-123", "issue-456", labels[0]["id"])
   
   asyncio.run(manage_labels())

How It Works

Configuration Options

Best Practices

Related