list_projects
ManagementList Projects
List projects within a specific team. Use this after list_teams when an OAuth workflow needs a project_id.
Args:
- team_id: required — team to list projects for
- response_format: optional — 'json' (default) or 'markdown'
Returns: the projects available in the given team. If multiple projects are returned, ask the user which project to use before calling write or generation tools.
Examples:
- "Show projects for this team" -> team_id="<team_id from list_teams>"
- "Pick a project before run_model" -> call list_projects after the user confirms the team
Don't use when: You do not know the team yet. Use list_teams first.
read-onlyidempotentopen-world
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| team_id | string | — | Team ID. Required from list_teams before listing projects. |
| response_format | enum(json | markdown) | json | Output format: 'json' for structured data, 'markdown' for human-readable text. |
Example Request
JSON
{
"team_id": "team_abc123"
}Example Response
JSON
{
"projects": [
{
"id": "proj_xyz789",
"name": "Fantasy RPG"
}
]
}Common Use Cases
- Find project IDs for a selected team before using OAuth-protected tools
- Confirm whether a team has multiple projects and prompt the user to choose one