Skip to main content
GET
/
projects
/
{workspaceId}
List projects
curl --request GET \
  --url https://productlane.com/api/v1/projects/{workspaceId}
{
  "projects": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "color": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "icon": "<string>",
      "linearProjectId": "<string>",
      "linearTeamIds": [
        "<string>"
      ],
      "progress": 123,
      "sortOrder": 123,
      "state": "<string>",
      "upvotes": 123,
      "importanceScore": 123
    }
  ]
}

​
List Projects

List all projects from a workspace by ID. Important: The workspace needs to have their portal/roadmap published, or the request will fail with the error ‘Workspace not found’. No authorization is required.

​
Path Parameters

​
workspaceId
string
required
Unique identifier of the workspace

​
Response

​
projects
object[]
Array of project objects
​
projects[].id
string
Unique identifier for the project
​
projects[].name
string
Project name
​
projects[].description
string
Project description
​
projects[].color
string
Project color (hex code)
​
projects[].createdAt
string
Timestamp when the project was created
​
projects[].icon
string
Project icon
​
projects[].linearProjectId
string
Associated Linear project ID
​
projects[].linearTeamIds
string[]
Associated Linear team IDs
​
projects[].progress
number
Project completion percentage (0-100)
​
projects[].sortOrder
number
Sort order for display
​
projects[].state
string
Project state
​
projects[].upvotes
number
Number of upvotes for this project
​
projects[].importanceScore
number
Calculated importance score

​
Example Request

GET /api/v1/projects/ws_123456789

​
Example Response

{
  "projects": [
    {
      "id": "proj_123456789",
      "name": "Dashboard Redesign",
      "description": "Complete redesign of the user dashboard with improved navigation",
      "color": "#3B82F6",
      "createdAt": "2024-01-15T10:30:00Z",
      "icon": "dashboard",
      "linearProjectId": "linear_proj_123",
      "linearTeamIds": ["team_456", "team_789"],
      "progress": 75,
      "sortOrder": 1,
      "state": "IN_PROGRESS",
      "upvotes": 42,
      "importanceScore": 8.5
    }
  ]
}

Path Parameters

​
workspaceId
string
required

Response

Successful response

​
projects
object[]
required