---
title: "GET /orgs/{org_id}/projects"
method: GET
path: "/orgs/{org_id}/projects"
tags: ["projects"]
---

# GET /orgs/{org_id}/projects

`GET /orgs/{org_id}/projects`

List projects for an organization

## Path parameters

- `org_id` string, required

## Query parameters

- `view` 'list' | 'full'

## Response `200`

Projects listed successfully

- union
  - object
    - `projects` ProjectPreview[], required
      - `created_at` integer, required — Creation timestamp in epoch milliseconds
      - `default_role` string, nullable — Project's default role. All organization members will be assigned this role by default for this project
      - `description` string, nullable — Project description
      - `id` string, required — Unique project identifier
      - `is_public_template` boolean, required — Whether the project is a public template
      - `name` string, required — Project name
      - `role` string, required — Authenticated user's role in the project
      - `screenshot_url` string, nullable — URL of the project's screenshot image
      - `template_uses` integer, required — Number of times this template has been used
  - object
    - `projects` ProjectDetail[], required
      - `created_at` integer, required — Creation timestamp in epoch milliseconds
      - `default_role` string, nullable — Project's default role. All organization members will be assigned this role by default for this project
      - `description` string, nullable — Project description
      - `environments` EnvPreview[], required — Project environments with their latest deployment status
        - `color` string, required — Environment color
        - `id` string, required — Environment identifier
        - `last_deployment_status` string, nullable — Status of the latest deployment in this environment
        - `name` string, required — Environment name
      - `has_ui` boolean, required — Whether the project has a UI interface
      - `id` string, required — Unique project identifier
      - `integrations` IntegrationPreview[], required — Integrations active in this project
        - `id` string, required — Integration identifier
        - `logo_url` string, nullable — Integration logo URL
        - `name` string, required — Integration display name
        - `provider` string, required — Integration provider key
      - `is_public_template` boolean, required — Whether the project is a public template
      - `knowledge_bases` KbPreview[], required — Knowledge bases connected to this project (new KB system only)
        - `description` string, nullable — Knowledge base description
        - `id` string, required — Knowledge base identifier
        - `name` string, required — Knowledge base name
        - `uid` string, required — Knowledge base unique identifier
      - `name` string, required — Project name
      - `publishable_api_key` string, required — Publishable API key for this project
      - `repository_url` string, nullable — URL of the project's source code repository. When null, the project does not have source code available
      - `role` string, required — Authenticated user's role in the project
      - `screenshot_url` string, nullable — URL of the project's screenshot image
      - `template_uses` integer, required — Number of times this template has been used
      - `updated_at` integer, required — Last update timestamp in epoch milliseconds
      - `use_platform_iam` boolean, required — Whether the project uses the platform's IAM system for access control

## Changes

- **2026-04-22** `63b3777893c7` — 1 breaking
  - removed the required property `oneOf[subschema #2]/projects/items/workforce` from the response with the `200` status
- **2026-04-15** `2da1655ba706` — 1 info
  - added the optional property `oneOf[subschema #2]/projects/items/workforce/items/deleted_at` to the response with the `200` status
- **2026-04-15** `62bed9af160c` — 1 info
  - added the optional property `oneOf[subschema #2]/projects/items/workforce/items/url` to the response with the `200` status
- **2026-03-28** `03807319958f` — 1 warning
  - added the new `unknown` enum value to the `oneOf[subschema #2]/projects/items/workforce/items/type` response property for the response status `200`
- **2026-03-24** `f0c5860bb28a` — 3 breaking, 1 info
  - added `subschema #1, subschema #2` to the response body `oneOf` list for the response status `200`
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `projects` from the response with the `200` status
  - added the new optional `query` request parameter `view`

[Full history](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/changes/orgs/:org_id/projects/get.md)

---

[API](https://skmtc.dev/timbal-ai/apis/timbal-platform-api.md) · [All operations](https://skmtc.dev/timbal-ai/apis/timbal-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/timbal-ai/timbal-platform-api/revisions/ceedf3f59b46/schema)