Skip to main content

Get specific department details using department Id

This API helps you retrieve the details of a specific department using department Id.

API: https://meeting.zoho.com/api/v2/{orgId}/department/{departmentId} 

Method: Get 

OAuth Scope: ZohoMeeting.department.READ 

Path Params: 
orgId - organization id which is retrieved from currentUser api 
departmentId - department id which is retrieved from get list of department api

Request Example:

Copiedhttps://meeting.zoho.com/api/v2/1234567/department/40219600000

Response Example:

Copied{
    "representation": {
        "departmentId": "402196000000",
        "departmentName": "MEETING",
        "source": "MEETING",
        "createdTime": "1685988322741",
        "modifiedTime": "1685988322741",
        "adminUserIds": [
            "402196000000"
        ],
        "memberUserIds": [
            "4021960000000018001"
        ]
    },
    "resourceType": "/api/v2/1234567/department/402196000000"
}

POSSIBLE ERROR CASES

1. Invalid DC or Invalid token
 

HTTP Code: 400

HTTP Body:

Copied{
    "error": {
        "code": 2000,
        "message": "INVALID_OAUTHTOKEN"
    }
}

Resolution: Check whether the entered DC is correct and entered token is not expired.

2. Invalid orgId

HTTP Code: 403
HTTP Body:

Copied{
    "error": {
        "code": 1025,
        "message": "Org doesn't matches with request uri"
    },
    "resourceType": "/meeting/api/v2/1234567/user"
}

Resolution: Check whether the entered organization id is correct.

3. Invalid Org Admin

HTTP Code: 403
HTTP Body:

Copied{
    "error": {
        "code": 1009,
        "message": "Invalid org admin"
    },
    "resourceType": "/meeting/api/v2/1234567/user"
}

Resolution: Only admin can access this API. Kindly contact the admin.