---
title: "Retrieve Projects"
method: GET
path: "/v1/projects"
tags: ["Projects"]
---

# Retrieve Projects

`GET /v1/projects`

Retrieve all Projects in your workspace

## Query parameters

- `userId` string
- `name` string
- `limit` number
- `page` number
- `sort` 'LAST_UPDATED' | 'OLDEST_UPDATED' | 'ALPHABETICAL' | 'REVERSE_ALPHABETICAL' | 'NEWEST_CREATED' | 'OLDEST_CREATED'
- `createdAtStart` string
- `createdAtEnd` string
- `q` string

## Response `200`

List of projects

- ProjectResponseDto
  - `requestId` string, required
  - `resource` string, required
  - `data` ProjectData[], required
    - `id` string, required — The unique identifier of the project
    - `name` string, required — The name of the project
    - `userId` string, required — The ID of the user creating the project
    - `appUrl` string, required — The client URL to view the project in the Jasper app
    - `accessLevel` 'PRIVATE' | 'WORKSPACE' — Who currently has access to the project. `WORKSPACE` means every member of the calling workspace can access it; `PRIVATE` means access is limited to the owner (and anyone explicitly shared in).
    - `settings` ProjectSettingsDto
      - `goal` string — High-level goal/description for the project (free text).
      - `toneId` string, nullable — Default Brand Voice (Tone) ID, e.g. `ton_...`. Pass `null` to clear.
      - `audienceId` string, nullable — Default Audience ID, e.g. `aud_...`. Pass `null` to clear.
      - `styleId` string, nullable — Default Style Guide ID, e.g. `sty_...`. Pass `null` to clear.
      - `knowledgeIds` string[] — Knowledge IDs (`kno_*`) to attach to the project. Replaces the existing set of knowledge attachments; pass an empty array to clear them. Non-knowledge attachments are not affected.
    - `metadata` object — Set of key-value pairs previously attached to the project via create/update. Omitted from the response when no metadata is set.

## Other responses

- `400` — Bad request. May be missing required inputs or may have badly formatted inputs.
- `401` — Unauthorized access to the workspace.
- `404` — Not found. May have an incorrect URL path.
- `500` — Internal server error. Unable to get projects.

---

[API](https://skmtc.net/jasper/apis/jasper-api.md) · [All operations](https://skmtc.net/jasper/apis/jasper-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jasper/jasper-api/revisions/438914d9525e/schema)