Portal SDK
Projects
Project lifecycle — create, list, fetch.
Projects are the top-level containers for documents, features, workflows, and workspaces. Every artifact in the portal belongs to exactly one project (or is loose at the org level).
fabric_list_projects
> What projects are open right now?Input:
{
status?: "active" | "archived",
limit?: number,
cursor?: string
}Output:
{
projects: Array<{
id, slug, name, description,
status, ownerId,
documentCount, featureCount, workflowCount,
createdAt, updatedAt
}>,
nextCursor?: string
}fabric_get_project
> Show me the payment-rails project.Input: { projectIdOrSlug: string }
Returns the same shape as a list entry, plus members (the team) and recentActivity (last 20 events).
fabric_create_project
> Create a project called "Q1 reliability initiative" with description "SLO target work for the request pipeline".Input:
{
name: string,
description?: string,
slug?: string, // auto-generated from name if omitted
ownerId?: string // defaults to current user
}Output: { project: { id, slug, name, ... } }
Notes
- Updates aren't exposed as a separate tool yet — they're done through the portal UI. The tool surface here is intentionally narrow: things agents create or read, not configure.
- Slugs are unique per organization and are how URLs are formed (
/app/<org>/projects/<slug>).