Get specific department details using department name
This API helps you retrieve the details of a specific department using department name.
API: https://meeting.zoho.com/api/v2/{orgId}/department/name
Method: Get
OAuth Scope: ZohoMeeting.department.READ
Path Params:
orgId - organization id which is retrieved from currentUser api
Params:
departmentName - Name of the department.
Request Example:
Copiedhttps://meeting.zoho.com/api/v2/1234567/department/name?departmentName=MEETING
Response Example:
Copied{
"representation": {
"departmentId": "123456789123",
"departmentName": "MEETING",
"source": "MEETING",
"status": 1,
"createdTime": "1685988322741",
"modifiedTime": "1685988322741"
},
"resourceType": "/api/v2/1234567/department/name"
}
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 Admin
HTTP Code: 403
HTTP Body:
Copied{
"error": {
"code": 1033,
"message": "User is not a departmnet admin and not a org admin"
},
"resourceType": "/meeting/api/v2/1234567/department/123456789123"
}
Resolution: Only org admin or department admin can access this API. Kindly contact the org admin or department admin.
4. Invalid Department Name
HTTP Code: 403
HTTP Body:
Copied{
"error": {
"code": 1032,
"message": "This department name is not available"
},
"resourceType": "/meeting/api/v2/1234567/department/name"
}
Resolution: Check whether the department name is entered or the entered department name is correct.