Skip to main content
PATCH
/
api
/
v1
/
workspace
Update workspace
curl --request PATCH \
  --url https://api.example.com/api/v1/workspace \
  --header 'Content-Type: application/json' \
  --header 'x-calry-api-key: <api-key>' \
  --data '
{
  "name": "New Workspace Name",
  "defaultCurrency": "EUR",
  "defaultDiscountPercentage": 15
}
'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "My Workspace",
  "slug": "my-workspace",
  "defaultCurrency": "USD",
  "createdAt": "2025-01-01T00:00:00.000Z",
  "updatedAt": "2025-01-02T00:00:00.000Z",
  "defaultDiscountPercentage": 10
}

Authorizations

x-calry-api-key
string
header
required

Body

application/json
name
string

Updated name for the workspace

Example:

"New Workspace Name"

defaultCurrency
string

Updated default currency for the workspace

Example:

"EUR"

defaultDiscountPercentage
number

Updated default discount percentage

Required range: 0 <= x <= 100
Example:

15

Response

Workspace updated successfully

id
string
required

Unique identifier of the workspace

Example:

"123e4567-e89b-12d3-a456-426614174000"

name
string
required

Name of the workspace

Example:

"My Workspace"

slug
string
required

Slug of the workspace

Example:

"my-workspace"

defaultCurrency
string
required

Default currency for the workspace

Example:

"USD"

createdAt
string<date-time>
required

When the workspace was created

Example:

"2025-01-01T00:00:00.000Z"

updatedAt
string<date-time>
required

When the workspace was last updated

Example:

"2025-01-02T00:00:00.000Z"

defaultDiscountPercentage
number

Default discount percentage to apply

Example:

10