Skip to content

spaces/update_tools

Endpoint#

PropertyValue
Typemutation
MethodPOST
Path/api/external/v1/spaces/update_tools
HandlerOperatelyWeb.Api.Spaces.UpdateTools

Authentication#

  • Requires a valid API token.
  • Requires a write-enabled token.
  • Read-only tokens return 403.

Inputs#

FieldTypeRequiredNullableDefault
space_idid primitive (encoded as string)YesNo-
toolsupdate_space_tools_payload objectYesNo-

Outputs#

FieldTypeRequiredNullable
successbooleanYesYes
toolsspace_tools objectYesYes

cURL Example#

Copied
curl --request POST \
  --url "https://app.operately.com/api/external/v1/spaces/update_tools" \
  --header "Authorization: Bearer ${OPERATELY_API_TOKEN}" \
  --header "Content-Type: application/json" \
  --data '{"space_id":"value", "tools":{"discussions_enabled":true, "resource_hub_enabled":true, "tasks_enabled":true}}'

Response Example#

{
  "success": true,
  "tools": {
    "discussions_enabled": true,
    "goals": [
      "<goal>"
    ],
    "messages_boards": [
      "<messages_board>"
    ],
    "projects": [
      "<project>"
    ],
    "resource_hub_enabled": true,
    "resource_hubs": [
      "<resource_hub>"
    ],
    "tasks": [
      "<task>"
    ],
    "tasks_enabled": true
  }
}