Issues

The Issues resource (client.issues) provides ticket management for tracking data quality incidents, governance tasks, and operational problems.

Methods

create(space_slug, *, title, description_markdown, priority=, product_ids=, impact_assessment=, **extra)

Create a new ticket in a space.

Parameter	Type	Default	Description
space_slug	str	required	Space identifier
title	str	required	Ticket title
description_markdown	str	required	Markdown description
priority	str	"medium"	Priority level (low, medium, high, critical)
product_ids	list[UUID] | None	None	Products to link to this ticket
impact_assessment	dict | None	None	Impact assessment details

Returns: Ticket

ticket = await client.issues.create(
    "marketing-analytics",
    title="Missing data in customer events",
    description_markdown="No events received since 2024-01-15 08:00 UTC.",
    priority="high",
    product_ids=[product_id],
    impact_assessment={
        "business_impact": "Revenue reporting delayed",
        "technical_impact": "Downstream aggregations stale",
        "reach": "marketing-team",
    },
)

---

list(space_slug, *, assignee_id=, search=, priority=, limit=, offset=)

List tickets in a space with optional filters.

Parameter	Type	Default	Description
space_slug	str	required	Space identifier
assignee_id	UUID | None	None	Filter by assignee
search	str | None	None	Search query
priority	str | None	None	Filter by priority
limit	int	50	Pagination limit
offset	int	0	Pagination offset

Returns: list[Ticket]

open_tickets = await client.issues.list(
    "marketing-analytics",
    priority="critical",
)

---

get(ticket_id)

Get a ticket by UUID.

Parameter	Type	Description
ticket_id	UUID	Ticket UUID

Returns: Ticket

---

update(ticket_id, **fields)

Update a ticket (title, status, priority, assignee, etc.).

Parameter	Type	Description
ticket_id	UUID	Ticket UUID
**fields	Any	Fields to update

Returns: Ticket

updated = await client.issues.update(
    ticket_id,
    status="in_progress",
    assignee_id=user_id,
)

---

create_for_product(product_id, *, title, description_markdown, priority=, **extra)

Create a ticket pre-linked to a specific product.

Parameter	Type	Default	Description
product_id	UUID	required	Product UUID
title	str	required	Ticket title
description_markdown	str	required	Markdown description
priority	str	"medium"	Priority level

Returns: Ticket

---

list_for_product(product_id, *, include_closed=)

List tickets associated with a product.

Parameter	Type	Default	Description
product_id	UUID	required	Product UUID
include_closed	bool	False	Include closed tickets

Returns: list[Ticket]

tickets = await client.issues.list_for_product(product_id, include_closed=True)