Skip to content

create

Endpoint#

PropertyValue
Typemutation
MethodPOST
Path/api/external/v1/resource_hubs/create
HandlerOperatelyWeb.Api.ResourceHubs.Create

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-
namestringYesNo-
descriptionstringNoYes-
anonymous_access_levelintegerNoYes-
company_access_levelintegerNoYes-
space_access_levelintegerNoYes-

Outputs#

FieldTypeRequiredNullable
resource_hubresource_hub objectYesNo

cURL Example#

Copied
curl --request POST \
  --url "https://app.operately.com/api/external/v1/resource_hubs/create" \
  --header "Authorization: Bearer ${OPERATELY_API_TOKEN}" \
  --header "Content-Type: application/json" \
  --data '{"anonymous_access_level":123, "company_access_level":123, "description":"value", "name":"value", "space_access_level":123, "space_id":"value"}'

Response Example#

{
  "resource_hub": {
    "description": "value",
    "id": "value",
    "inserted_at": "2026-01-01",
    "name": "value",
    "nodes": [
      "<resource_hub_node>"
    ],
    "permissions": "<resource_hub_permissions>",
    "potential_subscribers": [
      "<subscriber>"
    ],
    "space": "<space>",
    "updated_at": "2026-01-01"
  }
}