serviceos

Python SDK for ServiceOS API.

Installation

pip install serviceos

Quick Start

from serviceos import ServiceOS

client = ServiceOS(api_key="sk_...", org_id="org_123")

# List open tickets
tickets = client.tickets.list(status="open")

# Create a ticket
ticket = client.tickets.create(title="Bug report", priority="high")

# Update a ticket
client.tickets.update(ticket["data"]["ticket_id"], status="resolved")

# Auto-paginate
for ticket in client.tickets.list_all(status="open"):
    print(ticket["title"])

# Teams and queues
teams = client.teams.list()
queues = client.queues.list()

Error Handling

from serviceos import ServiceOS, NotFoundError, RateLimitError

try:
    client.tickets.get("nonexistent")
except NotFoundError:
    print("Ticket not found")
except RateLimitError as e:
    print(f"Retry after {e.retry_after}s")

Features

• Sync HTTP client (httpx)
• Pydantic models for type-safe parameters
• Auto-retry with tenacity (429 + 5xx, exponential backoff)
• Pagination iterator via list_all()
• Context manager support
• Debug mode for request logging