v1

Remove Spaces from a Niche

Changed on

Takes the Niche out of the given Spaces, from GET /v1/spaces. A delta: Spaces you do not list are left as they are, and so are assignee tags. Ids already detached are counted in removed / notPresent, never errors.

All or nothing: if any id is not a Space of your organization the call fails with 404 and unknownIds, if the acting member cannot manage a Space it fails with 403 and forbiddenSpaceIds, and nothing changes. The acting member needs Manage access to the Niche; x-api-key calls act as the owner.

Rate limited to 2 requests per minute per Niche.

post/v1/niches/{nicheId}/spaces/remove

Request

  • Base URL
    https://api.datadive.tools
  • URL
    https://api.datadive.tools/v1/niches/{nicheId}/spaces/remove
  • Auth
    API key in header x-api-key

Path parameters

nicheIdstring required

The unique identifier of the Niche

Request body

spaceIdsnumber[] required

Ids of the Spaces to change, from GET /v1/spaces. 1-100, unique.

Example request

{
  "spaceIds": [
    12,
    34
  ]
}

Response

messagestring

Example response

{
  "data": {
    "removed": 1,
    "notPresent": 1
  }
}

Changes