Endpoint#
| Property | Value |
|---|
| Type | mutation |
| Method | POST |
| Path | /api/external/v1/spaces/update_tools |
| Handler | OperatelyWeb.Api.Spaces.UpdateTools |
Authentication#
- Requires a valid API token.
- Requires a write-enabled token.
- Read-only tokens return
403.
| Field | Type | Required | Nullable | Default |
|---|
space_id | id primitive (encoded as string) | Yes | No | - |
tools | update_space_tools_payload object | Yes | No | - |
Outputs#
| Field | Type | Required | Nullable |
|---|
success | boolean | Yes | Yes |
tools | space_tools object | Yes | Yes |
cURL Example#
Copiedcurl --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
}
}