Projects

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

client.projects on fi.Client (Python) and client.projects 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
projects.getReturn a tracing project by its identifier.
projects.listList tracing projects available in the current workspace.

client.projects

projects.get

Return a tracing project by its identifier.

GET /tracer/project/{id}/

MCP tool: get_project

result = client.projects.get("your-id")
const result = await client.projects.get("your-id");
Signature
client.projects.get(
    id: str,
    *,
    extra_query: dict[str, Any] | None = None,
    options: RequestOptions | None = None,
) -> models.ProjectDetailResult
client.projects.get(id: string, options?: RequestOptions): Promise<models.ProjectDetailResult>

Parameters

id string Required

Positional argument id.

Returns

ProjectDetailResult.

projects.list

List tracing projects available in the current workspace.

GET /tracer/project/

MCP tool: list_projects

result = client.projects.list()
const result = await client.projects.list();
Signature
client.projects.list(
    *,
    name: str | None | NotGiven = NOT_GIVEN,
    project_type: str | None | NotGiven = NOT_GIVEN,
    tags: str | None | NotGiven = NOT_GIVEN,
    filters: str | None | NotGiven = NOT_GIVEN,
    sort_by: str | None | NotGiven = NOT_GIVEN,
    sort_direction: Literal['asc', 'desc'] | None | NotGiven = NOT_GIVEN,
    page_number: int | None | NotGiven = NOT_GIVEN,
    page_size: int | None | NotGiven = NOT_GIVEN,
    extra_query: dict[str, Any] | None = None,
    options: RequestOptions | None = None,
) -> Any
client.projects.list(params: ProjectsListParams = {}, options?: RequestOptions): Promise<unknown>

export interface ProjectsListParams {
  name?: string | null;
  project_type?: string | null;
  tags?: string | null;
  filters?: string | null;
  sort_by?: string | null;
  sort_direction?: "asc" | "desc" | null;
  page_number?: number | null;
  page_size?: number | null;
}

Parameters

name string Optional
project_type string Optional
tags string Optional
filters string Optional
sort_by string Optional
sort_direction string Optional
Allowed values:
ascdesc
page_number integer Optional
page_size integer Optional

Returns

The decoded response. The contract does not describe its shape, so it is untyped.

Was this page helpful?

Questions & Discussion