# List Projects

GET /api/v2/projects

Lists the projects the caller can reach, each with its app configs. Pass id to return only that project; an unknown or inaccessible id returns 404. Omit id for every reachable project. take pages that list, and includeId keeps one project on the page without filtering. API keys are scoped to a single project. An MCP URL with ?projectId= is limited to that project. The MCP tool returns a short summary; this REST response is the full record.

## Request

- id: string, query — Return only the project with this ID. An unknown or inaccessible ID is an error.
- includeId: string, query — When take is set, keep this project on the page if the caller can reach it. Does not filter the list. Ignored when id is set.
- orderBy: name | description | createdAt, query — Field to sort by. Omit to keep the default ordering.
- orderDirection: asc | desc, query — Sort direction. Defaults to `desc`. Ignored unless `orderBy` is set.
- skip: number, query — Number of projects to skip before collecting results.
- take: number, query — Maximum number of projects to return. Omit to return every project.

## Response

- 200: Successful response
- 400: Invalid input data
- 401: Authorization not provided
- 403: Insufficient access
- 404: Not found
- 500: Internal server error
