Issues

SDK methods for the federated bug / support-ticket workflow.

The client.issues namespace creates and lists federated issues — bug reports and support tickets that traverse application boundaries. Available in TypeScript, Python, and Go SDKs.

SDK	Install	Namespace
TypeScript	npm install @caldera/platformxe-sdk	client.issues
Python	pip install platformxe	client.issues
Go	go get github.com/calderax/platformxe-go	client.Issues

List issues

// All open issues for the calling org
const issues = await client.issues.list();

// Filter by app + status
const lettingsBugs = await client.issues.list({ app: 'lettings', status: 'OPEN' });

Create an issue

const created = await client.issues.create({
  app: 'lettings',
  reporterId: 'user_123',
  title: 'Booking confirmation email shows wrong nights',
  description: 'Booked 3 nights, email says 2. Check booking_confirmation template.',
  priority: 'HIGH',
  tags: ['email', 'template'],
  metadata: { bookingId: 'bk_abc', templateId: 'booking_confirmation' },
});
console.log(created.id); // 'iss_…'

created = client.issues.create(
    app="lettings",
    reporter_id="user_123",
    title="Booking confirmation email shows wrong nights",
    description="Booked 3 nights, email says 2.",
    priority="HIGH",
)

Fields

Issue record

Field	Type	Description
id	string	iss_<cuid>
organizationId	string	Owning tenant.
app	string	Source app raising the issue.
reporterId	string	Reporting user.
title	string
description	string
priority	'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT'	Defaults to MEDIUM.
status	'OPEN' | 'IN_PROGRESS' | 'RESOLVED' | 'CLOSED'
tags	string[]
metadata	Record<string, unknown>	Free-form structured context.
createdAt / updatedAt	string	ISO 8601 timestamps.

Scopes required

Method	Scope
issues.list()	issues:read
issues.create()	issues:write