Skip to main content
PUT
/
organisations
/
{orgId}
/
workspaces
/
{workspaceId}
Update workspace
curl --request PUT \
  --url https://api.meetsquad.ai/organisations/{orgId}/workspaces/{workspaceId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Product Development",
  "homepageUrl": "https://product.example.com",
  "logoUrl": "https://product.example.com/logo.png",
  "missionStatement": "Develop innovative products that solve real customer problems",
  "description": "This workspace focuses on our core product development initiatives, including roadmap planning, feature development, and product improvements.",
  "status": "Initializing"
}
'
{
  "data": {
    "id": "c0e195d9-b918-4a3a-bd8b-f730361d044f",
    "name": "Product Development",
    "missionStatement": "Develop innovative products that solve real customer problems",
    "createdAt": "2025-03-26T22:35:46Z",
    "updatedAt": "2025-03-26T22:35:46Z",
    "status": "Initializing",
    "homepageUrl": "https://product.example.com",
    "logoUrl": "https://product.example.com/logo.png",
    "description": "This workspace focuses on our core product development initiatives, including roadmap planning, feature development, and product improvements."
  }
}

Authorizations

Authorization
string
header
required

JWT authentication for organization-scoped endpoints.

Path Parameters

orgId
string
required

Organization ID

workspaceId
string
required

Workspace ID

Body

application/json

Request schema for updating a workspace

name
string

Name of the workspace

Example:

"Product Development"

homepageUrl
string | null

URL to the workspace's homepage

Example:

"https://product.example.com"

logoUrl
string | null

URL to the workspace's logo

Example:

"https://product.example.com/logo.png"

missionStatement
string

Mission statement for the workspace

Example:

"Develop innovative products that solve real customer problems"

description
string

Detailed description of the workspace

Example:

"This workspace focuses on our core product development initiatives, including roadmap planning, feature development, and product improvements."

status
enum<string>

Status of the workspace

Available options:
Initializing,
OnboardingDeepResearch,
OnboardingConsiderWorkspace,
OnboardingConsiderOpportunities,
OnboardingConsiderOpportunitiesToOutcomes,
OnboardingConsiderSolutionGeneration,
OnboardingConsiderSolutionsToBuild,
OnboardingSelectSolutionsToBuild,
OnboardingMapSolutionsToRoadmap,
Active,
Inactive
Example:

"Initializing"

Response

Workspace updated successfully

Response containing a single workspace

data
object
required

Workspace data