Forum Discussion

Imtiaz's avatar
Imtiaz
Ace
16 hours ago

Classic: How to delete a board under grouphub using board delete v2 API

I am trying to delete a board under a Group Hub using the Board Delete v2 API:

DELETE /api/2.0/boards/{board_id}

However, I am receiving a 403 Permission Denied error, even though I am making the API call using a system user with Administrator permissions.

Response:

{ "status": "error", "message": "Permission Denied", "data": { "type": "error_data", "code": 414, "developer_message": "", "more_info": "" }, "metadata": {} }

Could you please let me know if there are any additional permissions or prerequisites required to delete a board under a Group Hub using this API?

1 Reply

  • RahulBi's avatar
    RahulBi
    Khoros Staff
    2 hours ago

    🔴 Root Cause: API v2 Limitation with Group Hub Boards

    The official Classic documentation explicitly states:

    "Community API v2 does not support review boards or group boards. Use Community API v1 for reviews and groups."

    ✅ Solution: Use Community API v1 Instead

    To delete a board under a Group Hub, use the Community API v1 endpoint:

    DELETE /restapi/vc/boards/id/{board_id}

    Alternative: Delete via Community Admin UI

    If the API v1 approach doesn't work for your use case, you can delete the board through the Community Admin UI:

    1. Go to Community Admin > Community Structure
    2. Navigate to the Group Hub
    3. Hover over the board you want to delete
    4. Click Manage → Delete

    ⚠️ Important Notes

    1. The board must be empty — You may need to delete or move all messages from the board before the API allows deletion.
    2. Ensure the board is not the last/default board in the Group Hub — Group Hubs require at least one discussion board.
    3. Authentication: Make sure the API v1 call is made using a properly authenticated admin session, not just a session key from a system user that may lack specific Group Hub permissions.
    4. Group Hub Permissions: Even with an Administrator role at the community level, Group Hub boards have their own permission layer. The user making the API call may need to be an Owner of the Group Hub, or have specific Group Hub-level permissions granted.

    Thanks

    Rahul Bisht