Registry↗Dashboard↗

Projects

Create, list, update, and delete projects. Projects are the top-level organizational unit for validation runs and issues.

16 methods

client.projects.list()

List all projects for the authenticated user.

Requires authentication
idrequiredstringuuid

Project ID.

namerequiredstring

Project name.

ownerIdrequiredstringuuid

Owner user ID.

createdAtrequiredstringdate-time

Creation timestamp.

updatedAtrequiredstringdate-time

Last update timestamp.

list(): Promise<Project[]>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.list();

console.log(result.id);
Response Type
// Promise<Project[]>
{
  id: string;
  name: string;
  ownerId: string;
  createdAt: string;
  updatedAt: string;
}

client.projects.get()

Get a project by ID or name.

Requires authentication
idOrNamerequiredstring

Project ID (UUID) or name.

idrequiredstringuuid

Project ID.

namerequiredstring

Project name.

ownerIdrequiredstringuuid

Owner user ID.

createdAtrequiredstringdate-time

Creation timestamp.

updatedAtrequiredstringdate-time

Last update timestamp.

get(idOrName: string): Promise<Project>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.get('my-project');

console.log(result.id);
Response Type
// Promise<Project>
{
  id: string;
  name: string;
  ownerId: string;
  createdAt: string;
  updatedAt: string;
}

client.projects.create()

Create a new project. Project names must be unique within the account.

Requires authentication
namerequiredstring

Project name. Must be unique, 1-200 characters.

idrequiredstringuuid

Project ID.

namerequiredstring

Project name.

createdAtrequiredstringdate-time

Creation timestamp.

create(input: CreateProjectInput): Promise<Project>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.create({ name: 'my-project' });

console.log(result.id);
Response Type
// Promise<Project>
{
  id: string;
  name: string;
  createdAt: string;
}

client.projects.update()

Update a project's fields.

Requires authentication
idOrNamerequiredstring

Project ID or name.

nameoptionalstring

New project name.

idrequiredstringuuid

Project ID.

namerequiredstring

Project name.

update(idOrName: string, input: UpdateProjectInput): Promise<Project>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.update({ idOrName: 'my-project' });

console.log(result.id);
Response Type
// Promise<Project>
{
  id: string;
  name: string;
}

client.projects.delete()

Permanently delete a project. Requires confirmation phrase matching the project name.

Requires authentication
idOrNamerequiredstring

Project ID or name.

confirmrequiredtrue

Must be literal `true`.

confirmationPhraserequiredstring

Must match the project name exactly.

deletedrequiredboolean

Always `true` on success.

delete(idOrName: string, input: DeleteProjectInput): Promise<DeleteResult>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.delete({
    idOrName: 'my-project',
    confirm: true,
    confirmationPhrase: 'DELETE my-project',
  });

console.log(result.deleted);
Response Type
// Promise<DeleteResult>
{
  deleted: boolean;
}

client.projects.softDelete()

Soft-delete a project. Can be restored later with `restore()`.

Requires authentication
idOrNamerequiredstring

Project ID or name.

confirmrequiredtrue

Must be literal `true`.

confirmationPhraserequiredstring

Must match the project name exactly.

deletedrequiredboolean

Always `true` on success.

softDelete(idOrName: string, input: DeleteProjectInput): Promise<DeleteResult>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.softDelete({
    idOrName: 'my-project',
    confirm: 'example-value',
    confirmationPhrase: 'DELETE my-project',
  });

console.log(result.deleted);
Response Type
// Promise<DeleteResult>
{
  deleted: boolean;
}

client.projects.restore()

Restore a soft-deleted project.

Requires authentication
idOrNamerequiredstring

Project ID or name.

restore(idOrName: string): Promise<Project>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.restore('my-project');
Response Type
Promise<Project>

client.projects.rename()

Rename a project by old name.

Requires authentication
oldNamerequiredstring

Current project name.

newNamerequiredstring

New project name.

rename(input: RenameProjectInput): Promise<Project>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.rename({ oldName: 'example-value', newName: 'my-fork' });
Response Type
Promise<Project>

client.projects.getSummary()

Get project summary with issue counts and run statistics.

Requires authentication
idOrNamerequiredstring

Project ID or name.

projectrequiredPublicProject

Project metadata.

statsrequiredobject

Summary statistics.

getSummary(idOrName: string): Promise<ProjectSummaryResponse>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.getSummary('my-project');

console.log(result.project);
Response Type
// Promise<ProjectSummaryResponse>
{
  project: PublicProject;
  stats: object;
}

client.projects.getTrends()

Get issue trend data over time for a project.

Requires authentication
idOrNamerequiredstring

Project ID or name.

daysoptionalnumber

Time window in days (1-365).

Default: 30
projectrequiredProject

Project metadata.

daysrequirednumber

Time window used.

dailyrequiredDailyIssueCounts[]

Daily issue counts.

summaryrequiredTrendsSummary

Aggregate summary of trend data.

getTrends(idOrName: string, query?: ProjectTrendsQuery): Promise<ProjectTrends>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.getTrends('my-project');

console.log(result.project);
Response Type
// Promise<ProjectTrends>
{
  project: Project;
  days: number;
  daily: DailyIssueCounts[];
  summary: TrendsSummary;
}

client.projects.listIssues()

List issues in a project with optional filters.

Requires authentication
idOrNamerequiredstring

Project ID or name.

statusoptionalStatusFilter

Filter by status.

opencompleteddeferredwontfixmergedfalse-positiveobservationall
priorityoptionalPriority

Filter by priority.

criticalhighsuggestedbacklog
agentoptionalstring

Filter by agent name.

limitoptionalnumber

Max results (1-100).

Default: 50
offsetoptionalnumber

Pagination offset.

Default: 0
listIssues(idOrName: string, query?: ListProjectIssuesQuery): Promise<Issue[]>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.listIssues('my-project');
Response Type
Promise<Issue[]>

client.projects.bulkUpdateIssueStatus()

Bulk update issue statuses in a project.

Requires authentication
idOrNamerequiredstring

Project ID or name.

updatesrequiredBulkIssueStatusUpdate[]

Array of status updates.

idrequiredstringuuid

Issue ID.

previousStatusrequiredStatus

Previous status.

newStatusrequiredStatus

Updated status.

updatedAtrequiredstringdate-time

Update timestamp.

bulkUpdateIssueStatus(idOrName: string, updates: BulkIssueStatusUpdate[]): Promise<BulkIssueStatusResult>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.bulkUpdateIssueStatus({
    idOrName: 'my-project',
    updates: [{
        issueId: '550e8400-e29b-41d4-a716-446655440000',
        status: 'open',
      }],
  });

console.log(result.id);
Response Type
// Promise<BulkIssueStatusResult>
{
  id: string;
  previousStatus: Status;
  newStatus: Status;
  updatedAt: string;
}

client.projects.mergeIssues()

Merge multiple issues into one target issue.

Requires authentication
idOrNamerequiredstring

Project ID or name.

targetIssueIdrequiredstringuuid

ID of the target issue.

sourceIssueIdsrequiredstring[]

IDs of issues to merge into target.

strategyoptionalstring

Merge strategy.

keep_targetkeep_highest_priority
Default: keep_target
targetIssueIdrequiredstringuuid

Target issue ID.

mergedCountrequirednumber

Number of source issues merged.

migratedOccurrencesrequirednumber

Total occurrences migrated.

mergeIssues(idOrName: string, input: MergeIssuesInput): Promise<MergeIssuesResult>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.mergeIssues({
    idOrName: 'my-project',
    targetIssueId: '550e8400-e29b-41d4-a716-446655440000',
    sourceIssueIds: [],
  });

console.log(result.targetIssueId);
Response Type
// Promise<MergeIssuesResult>
{
  targetIssueId: string;
  mergedCount: number;
  migratedOccurrences: number;
}

client.projects.mergeProjects()

Merge one project into another: runs and issues are re-keyed into the target, colliding issues are deduplicated by fingerprint, and the source is soft-deleted. Pairwise only — chain calls to consolidate several. Run with `dryRun: true` first; the merge is durable and has no undo.

Requires authentication
inputrequiredMergeProjectsInput

`source` and `target` project name or UUID, plus `dryRun` (preview and roll back), `deleteSource` (soft-delete the source, default true) and `confirmCrossOrg`.

mergeProjects(input: MergeProjectsInput): Promise<MergeProjectsResult>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.mergeProjects('example-value');
Response Type
Promise<MergeProjectsResult>

client.projects.getLog()

The project's second history: runs (what was examined) and decisions (what was decided, with reasons) interleaved newest first, keyset-paged. Regressions a run re-detected appear as their own events. Same read as `ulu log`.

Requires authentication
idOrNamerequiredstring

Project id or name, resolved in the call's org.

queryoptionalProjectLogQuery

since/until (ISO 8601), limit (1–500, default 50), cursor (from the previous page's nextCursor), kind (subset of run, decision, regression), workflowType, agent, includeArchived. Keys go to the wire camelCase as named.

datarequiredLogEvent[]

Events, newest first. Each has `type`: run (runNumber, workflowType, definition, averageScore, allGatesPassed, counts new/recurring/regressions/observed), decision (issue fingerprint, from/to status, reason or null, by run or by decision), regression (fingerprint, title, via run).

countrequirednumber

Events in this page.

hasMorerequiredboolean

Whether a further page exists.

nextCursorrequiredstring | null

Opaque cursor for the next page.

getLog(idOrName: string, query?: ProjectLogQuery): Promise<ProjectLogPage>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.getLog('my-project');

console.log(result.data);
Response Type
// Promise<ProjectLogPage>
{
  data: LogEvent[];
  count: number;
  hasMore: boolean;
  nextCursor: string | null;
}

client.projects.getLogStat()

The rollup — examined / found / decided / cameBack / activity for a window. `cameBack.detected` counts resolved findings a later run caught again (run_id set); `cameBack.reopened` counts reopens by decision. Two frames on two clocks: `decided` is the current status of findings first seen in the window, `activity` is transitions inside the window. Same numbers `ulu log --stat` prints.

Requires authentication
idOrNamerequiredstring

Project id or name.

queryoptionalLogStatQuery

since / until (ISO 8601). Unwindowed = all time.

examinedrequiredobject

runs, definitions (distinct name@version), byWorkflow.

foundrequiredobject

issues (findings tracked), bySeverity.

decidedrequiredobject

Fixed seven-key byStatus over open · completed · deferred · wontfix · merged · false-positive · observation, plus withReason per status.

cameBackrequiredobject

detected (caught by a run) and reopened (by decision).

activityrequiredobject

Transitions inside the window, incl. restated (same-status re-reasonings dropped from the stream).

getLogStat(idOrName: string, query?: LogStatQuery): Promise<ProjectLogStat>
typescript
import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({
  apiKey: 'ulr_your-api-key',
});

const result = await client.projects.getLogStat('my-project');

console.log(result.examined);
Response Type
// Promise<ProjectLogStat>
{
  examined: object;
  found: object;
  decided: object;
  cameBack: object;
  activity: object;
}