List Projects In Workspace
List all projects in a workspace that the user can access.
- Workspace owners: see ALL projects
- Workspace members: see projects where they have access (excludes no_access)
- Member_limited users: see only projects with explicit permission (excludes no_access)
Only active projects are returned unless the status filter says otherwise.
Authorizations
Aspect API key (sk_...) in Authorization header. 'Bearer ' optional.
Path Parameters
Query Parameters
Filter projects by active status (active, inactive, or all). Defaults to active.
active, inactive, all Response
Successful Response
Project ID
Project name
Root directory ID - all user directories/assets are children of this
Trash directory ID - deleted assets are moved here
Default role for workspace members accessing this project
owner, member, member_limited, full_access, editor, commenter, downloader, viewer, no_access Default permission bitmap inherited by children
Deprecated and unused; ignore it.
Whether the project is active. Inactive projects are hidden from listing and discovery surfaces.
Number of assets in project
Total size of assets in bytes
Total tokens used
Total duration in seconds
Chunk size in bytes for chunked uploads
User's permission bitmap on this project
ID of the user that created the project
Creation timestamp
Last update timestamp
Project icon data
Dominant color extracted from project icon (hex format)
System directory ID - the project's Aspect Stash folder under the root where Aspect places files automatically (canvas outputs, canvas uploads, generation outputs); null until it is lazily created on first use
Current user's last project access