github.com/grokify/go-ringcentral-client@v0.3.31/codegen/specs-engagedigital_v3.0.0/extra/openapi-spec_sources-permissions.json (about)

     1  {
     2    "openapi": "3.0.0",
     3    "info": {
     4      "description": "",
     5      "version": "1.0",
     6      "title": "Engage Digital API",
     7      "termsOfService": "https://developer.ringcentral.com"
     8    },
     9    "tags": [
    10      {
    11        "name": "User Sources Permissions"
    12      }
    13    ],
    14    "paths": {
    15      "/users/{userId}/sources_permissions": {
    16        "get": {
    17          "tags": [
    18            "User Sources Permissions"
    19          ],
    20          "summary": "Get a user permissions by source",
    21          "operationId": "getUserSourcesPermission",
    22          "description": "This method gets the permissions the user has on each source.\n\nAuthorization​: only users that can update users. The user affiliated to the token must have at least all the permissions of the other user. If the user affiliated to the token has the `manage_users_of_my_teams` permission, the updated user will need to belong to at least one of the teams he’s the leader of.",
    23          "parameters":[
    24              {
    25                  "name": "userId",
    26                  "in": "path",
    27                  "required": true,
    28                  "schema": {
    29                    "type": "string"
    30                  }
    31                }
    32          ],
    33          "responses": {
    34            "200": {
    35              "description": "Success",
    36              "content": {
    37                "application/json": {
    38                  "schema": {
    39                    "$ref": "#/components/schemas/UserSourcesPermissions"
    40                  }
    41                }
    42              }
    43            }
    44          }
    45        },
    46        "put": {
    47          "tags": [
    48            "User Sources Permissions"
    49          ],
    50          "summary": "Updating a user permissions by source",
    51          "operationId": "updateUserSourcesPermission",
    52          "description": "This method updates the permissions.\n\nAuthorization​: only users that can update users. The user affiliated to the token must have at least all the permissions of the other user. If the user affiliated to the token has the `manage_users_of_my_teams` permission, the updated user will need to belong to at least one of the teams he’s the leader of.",
    53          "parameters": [
    54              {
    55                  "name": "userId",
    56                  "in": "path",
    57                  "required": true,
    58                  "schema": {
    59                    "type": "string"
    60                  }
    61                },
    62            {
    63              "name": "params",
    64              "description": "Parameters are the source_id you want to update and value is a comma separated list of the different permissions you want to set on this source for this user. `<source_id_x>=<string of permission list>`: To update the permission for source X identified by its id source_id_x with the permissions `<string of permission_list>`. Possible permissions are: read, reply, approval_required, initiate_discussion, reply_with_html, destroy ...",
    65              "in": "query",
    66              "required": false,
    67              "style":"form",
    68              "explode": true,
    69              "schema": {
    70                "type": "object"
    71              }
    72            }
    73          ],
    74          "responses": {
    75            "200": {
    76              "description": "Success",
    77              "content": {
    78                "application/json": {
    79                  "schema": {
    80                    "$ref": "#/components/schemas/UserSourcesPermissions"
    81                  }
    82                }
    83              }
    84            }
    85          }
    86        }
    87      }
    88    },
    89    "servers": [
    90      {
    91        "url": "https://DOMAIN.api.engagement.dimelo.com/1.0"
    92      }
    93    ],
    94    "components": {
    95      "schemas": {
    96        "UserSourcesPermissions": {
    97            "type": "object",
    98            "additionalProperties" : {
    99          "type": "string"
   100  
   101            }
   102        }
   103      }
   104    }
   105  }