{ "opencollection": "1.0.0", "info": { "name": "API Endpoints subpackage_activities subpackage_groups API", "version": "1.0.0" }, "items": [ { "info": { "name": "subpackage_groups", "type": "folder" }, "items": [ { "info": { "name": "List Groups for your organization", "type": "http" }, "http": { "method": "GET", "url": "https://api.close.com/api/v1/group/", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "_fields", "value": "", "type": "query", "description": "Comma-separated list of fields to include in the response." } ] }, "docs": "Note that list endpoint does not support retrieving members for all groups. Use individual group endpoint instead." }, { "info": { "name": "Create a Group", "type": "http" }, "http": { "method": "POST", "url": "https://api.close.com/api/v1/group/", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "_fields", "value": "", "type": "query", "description": "Comma-separated list of fields to include in the response." } ], "body": { "type": "json", "data": "{}" } }, "docs": "Create a new group. The `name` is required and must be unique within the organization. The group is created with no members. Use the member endpoint to add users." }, { "info": { "name": "Add a User to a Group", "type": "http" }, "http": { "method": "POST", "url": "https://api.close.com/api/v1/group/:group_id/member/", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "group_id", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Add a user to a group by providing the `user_id`. If the user is already a member, nothing changes." }, { "info": { "name": "Remove a User from a Group", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.close.com/api/v1/group/:group_id/member/:user_id/", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "group_id", "value": "", "type": "path" }, { "name": "user_id", "value": "", "type": "path" } ] }, "docs": "If the user is not a member of the group, nothing changes." }, { "info": { "name": "Fetch an individual Group", "type": "http" }, "http": { "method": "GET", "url": "https://api.close.com/api/v1/group/:id/", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "_fields", "value": "", "type": "query", "description": "Comma-separated list of fields to include in the response." } ] }, "docs": "Fetch an individual Group" }, { "info": { "name": "Update a Group", "type": "http" }, "http": { "method": "PUT", "url": "https://api.close.com/api/v1/group/:id/", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "_fields", "value": "", "type": "query", "description": "Comma-separated list of fields to include in the response." } ], "body": { "type": "json", "data": "{}" } }, "docs": "You can use this endpoint to rename a Group. If a name is not unique, an error will be returned." }, { "info": { "name": "Delete a Group", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.close.com/api/v1/group/:id/", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" } ] }, "docs": "Delete a group. Members will be removed from the group but not from the organization. Deletion is only allowed if the group is not referenced by saved reports or smart views." } ] } ], "bundled": true }