CLclickup
Spaces

Update Space

Changed on

Rename, set the Space color, and enable ClickApps for a Space.

put/v2/space/{space_id}

Request

  • Base URL
    https://api.clickup.com/api
  • URL
    https://api.clickup.com/api/v2/space/{space_id}
  • Auth
    API key in header Authorization

Path parameters

space_idnumber required
Example:790

Request body

namestring required
colorstring required
privateboolean required
admin_can_manageboolean required

Note: Allowing or restricting admins from managing private Spaces using "admin_can_manage" is an Enterprise Plan feature.

multiple_assigneesboolean required

Example request

{
  "name": "Updated Space Name",
  "color": "#7B68EE",
  "private": false,
  "admin_can_manage": false,
  "multiple_assignees": false,
  "features": {
    "due_dates": {
      "enabled": false,
      "start_date": false,
      "remap_due_dates": false,
      "remap_closed_due_date": false
    },
    "time_tracking": {
      "enabled": false
    },
    "tags": {
      "enabled": false
    },
    "time_estimates": {
      "enabled": false
    },
    "checklists": {
      "enabled": true
    },
    "custom_fields": {
      "enabled": true
    },
    "remap_dependencies": {
      "enabled": false
    },
    "dependency_warning": {
      "enabled": false
    },
    "portfolios": {
      "enabled": false
    }
  }
}

Response

idstring required
namestring required
privateboolean required
statusesStatus[] required(unresolved $ref)
multiple_assigneesboolean required
featuresFeatures required(unresolved $ref)

Example response

{
  "id": "790",
  "name": "Updated Space Name",
  "private": false,
  "statuses": [
    {
      "status": "to do",
      "type": "open",
      "orderindex": 0,
      "color": "#d3d3d3"
    },
    {
      "status": "complete",
      "type": "closed",
      "orderindex": 1,
      "color": "#6bc950"
    }
  ],
  "multiple_assignees": false,
  "features": {
    "due_dates": {
      "enabled": false,
      "start_date": false,
      "remap_due_dates": false,
      "remap_closed_due_date": false
    },
    "time_tracking": {
      "enabled": false
    },
    "tags": {
      "enabled": false
    },
    "time_estimates": {
      "enabled": false
    },
    "checklists": {
      "enabled": true
    },
    "custom_fields": {
      "enabled": true
    },
    "remap_dependencies": {
      "enabled": false
    },
    "dependency_warning": {
      "enabled": false
    },
    "portfolios": {
      "enabled": false
    }
  }
}

Changes

  • a0a72ec97ddbRevision changes
    • breaking

      the response's property type changed from no type to object for status

    • breaking

      the / response's property type changed from no type to object for status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status