Error clusters

Reference for client.error_clusters in the Future AGI Python and TypeScript SDKs: error_clusters.get, error_clusters.list.

client.error_clusters on fi.Client (Python) and client.errorClusters on Client from @future-agi/sdk (TypeScript). The models these methods return are on Observability response models; how arguments, pagination, errors and strict mode work is in the overview.

Methods

MethodDescription
error_clusters.getReturn an error issue and its grouped trace information.
error_clusters.listList grouped error issues detected in project traces.

client.error_clusters

error_clusters.get

Return an error issue and its grouped trace information.

GET /tracer/feed/issues/{cluster_id}/

MCP tool: get_error_cluster

result = client.error_clusters.get("your-cluster-id")
const result = await client.errorClusters.get("your-cluster-id");
Signature
client.error_clusters.get(
    cluster_id: str,
    *,
    project_id: str | None | NotGiven = NOT_GIVEN,
    extra_query: dict[str, Any] | None = None,
    options: RequestOptions | None = None,
) -> models.FeedDetailCore
client.errorClusters.get(clusterId: string, params: ErrorClustersGetParams = {}, options?: RequestOptions): Promise<models.FeedDetailCore>

export interface ErrorClustersGetParams {
  project_id?: string | null;
}

Parameters

cluster_id string Required

Positional argument cluster_id.

project_id string Optional

Returns

FeedDetailCore.

error_clusters.list

List grouped error issues detected in project traces.

GET /tracer/feed/issues/

MCP tool: list_error_clusters

result = client.error_clusters.list()
const result = await client.errorClusters.list();
Signature
client.error_clusters.list(
    *,
    project_id: str | None | NotGiven = NOT_GIVEN,
    search: str | None | NotGiven = NOT_GIVEN,
    status: Literal['escalating', 'for_review', 'acknowledged', 'resolved'] | None | NotGiven = NOT_GIVEN,
    severity: Literal['critical', 'high', 'medium', 'low'] | None | NotGiven = NOT_GIVEN,
    fix_layer: str | None | NotGiven = NOT_GIVEN,
    source: Literal['scanner', 'eval'] | None | NotGiven = NOT_GIVEN,
    issue_group: str | None | NotGiven = NOT_GIVEN,
    time_range_days: int | None | NotGiven = NOT_GIVEN,
    sort_by: Literal['last_seen', 'first_seen', 'error_count', 'unique_traces', 'severity'] | None | NotGiven = NOT_GIVEN,
    sort_dir: Literal['asc', 'desc'] | None | NotGiven = NOT_GIVEN,
    limit: int | None | NotGiven = NOT_GIVEN,
    offset: int | None | NotGiven = NOT_GIVEN,
    extra_query: dict[str, Any] | None = None,
    options: RequestOptions | None = None,
) -> models.FeedListResponse
client.errorClusters.list(params: ErrorClustersListParams = {}, options?: RequestOptions): Promise<models.FeedListResponse>

export interface ErrorClustersListParams {
  project_id?: string | null;
  search?: string | null;
  status?: "escalating" | "for_review" | "acknowledged" | "resolved" | null;
  severity?: "critical" | "high" | "medium" | "low" | null;
  fix_layer?: string | null;
  source?: "scanner" | "eval" | null;
  issue_group?: string | null;
  time_range_days?: number | null;
  sort_by?: "last_seen" | "first_seen" | "error_count" | "unique_traces" | "severity" | null;
  sort_dir?: "asc" | "desc" | null;
  limit?: number | null;
  offset?: number | null;
}

Parameters

project_id string Optional
search string Optional
status string Optional
Allowed values:
escalatingfor_reviewacknowledgedresolved
severity string Optional
Allowed values:
criticalhighmediumlow
fix_layer string Optional
source string Optional
Allowed values:
scannereval
issue_group string Optional
time_range_days integer Optional
sort_by string Optional
Allowed values:
last_seenfirst_seenerror_countunique_tracesseverity
sort_dir string Optional
Allowed values:
ascdesc
limit integer Optional
offset integer Optional

Returns

FeedListResponse.

Was this page helpful?

Questions & Discussion