Working with Tickets

Create, search, get, and update Znuny tickets with the Python SDK.

Working with tickets — Znuny

All ticket operations are async. Use async with ZnunyClient(...) or call await client.aclose() when finished.

Authentication

Every API call requires a prior login():

from znuny import BasicAuth

client.login(BasicAuth(user_login="agent1", password="secret"))

Get a ticket

ticket = await client.get_ticket(12345)
print(ticket.title, ticket.queue)

Update a ticket

from znuny import IdName, TicketUpdate

updated = await client.update_ticket(
    TicketUpdate(
        id=12345,
        state=IdName(name="closed successful"),
    )
)

Search tickets

from znuny import IdName, TicketSearch

ids = await client.search_tickets(
    TicketSearch(
        queues=[IdName(name="Raw")],
        limit=50,
    )
)

Search and fetch full tickets

search_and_get runs search, then loads each ticket concurrently:

tickets = await client.search_and_get(
    TicketSearch(queues=[IdName(name="Raw")])
)
for t in tickets:
    print(t.id, t.title)

Error handling

GenericInterface business errors raise ZnunyError with code and message. HTTP transport problems raise httpx exceptions.

from znuny import ZnunyError

try:
    await client.get_ticket(999999)
except ZnunyError as e:
    print(e.code, e.message)

Dynamic fields

Pass dynamic fields as dict[str, str] on ticket models. The client maps them to GenericInterface DynamicField payloads automatically — the same field names you configured in Znuny.