{ "opencollection": "1.0.0", "info": { "name": "API Endpoints subpackage_activities subpackage_roles API", "version": "1.0.0" }, "items": [ { "info": { "name": "subpackage_roles", "type": "folder" }, "items": [ { "info": { "name": "List all the roles defined for your organization", "type": "http" }, "http": { "method": "GET", "url": "https://api.close.com/api/v1/role/", "headers": [ { "name": "Authorization", "value": "" } ] }, "docs": "List all the roles defined for your organization" }, { "info": { "name": "Create a new role", "type": "http" }, "http": { "method": "POST", "url": "https://api.close.com/api/v1/role/", "headers": [ { "name": "Authorization", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "`visibility_user_lcf_ids` (optional)\n\nA list of Lead Custom Field IDs that define which leads user with this role can see. If the role has `view_all_leads` permission, this field should be empty.\n\n`visibility_user_lcf_behavior` (optional)\n\nDefines how lead visibility works for leads that don't have assigned users. If the role has `view_all_leads` permission, this field should be empty.\n\n - `require_assignment` - leads without assigned users are not visible to this role\n - `allow_unassigned` - le" }, { "info": { "name": "Fetch a single role", "type": "http" }, "http": { "method": "GET", "url": "https://api.close.com/api/v1/role/:id/", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" } ] }, "docs": "Fetch a single role" }, { "info": { "name": "Update existing role", "type": "http" }, "http": { "method": "PUT", "url": "https://api.close.com/api/v1/role/:id/", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Update existing role" }, { "info": { "name": "Delete a role", "type": "http" }, "http": { "method": "DELETE", "url": "https://api.close.com/api/v1/role/:id/", "headers": [ { "name": "Authorization", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" } ] }, "docs": "Delete a custom role. You must first move all users off this role by reassigning them to another role." } ] } ], "bundled": true }