openapi: 3.0.0 info: title: Webex Admin Address Book Groups API version: 1.0.0 description: The Webex Admin APIs provide comprehensive programmatic access to administrative functions for managing Webex organizations, users, licenses, and settings. These APIs enable automation of user provisioning, license assignment, compliance management, and audit event retrieval. Administrators can integrate with enterprise identity systems, enforce security policies, monitor usage, and streamline onboarding/offboarding processes. The APIs support granular control over organizational resources, making them ideal for large-scale deployments and custom admin tooling. tags: - name: Groups paths: /groups: post: responses: '201': description: Created headers: {} content: application/json: schema: $ref: '#/components/schemas/GroupResponse' example: id: Y2lzY29zcGFyazovL3VzL1NDSU1fR1JPVVAvMjUxMDRiZTAtZjg3NC00MzQzLTk2MDctZGYwMmRmMzdiNWMxOjM0OGFkYjgxLTI4ZjktNGFiNS1iMmQ2LWU5YjQ5NGU3MmEwNg displayName: Sales Group orgId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi8zNDhhZGI4MS0yOGY5LTRhYjUtYjJkNi1lOWI0OTRlNzJhMDY created: '2022-02-17T02:13:29.706Z' lastModified: '2022-02-17T02:13:29.706Z' memberSize: 1 members: - id: Y2lzY29zcGFyazovL3VzL1BFT1BMRS8xOTUzOTdhMi03MTU5LTRjNTgtYTBiOC00NmQ2ZWZlZTdkMTM type: user displayName: Jane Smith '400': description: 'Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.' '401': description: 'Unauthorized: Authentication credentials were missing or incorrect.' '403': description: 'Forbidden: The request is understood, but it has been refused or access is not allowed.' '404': description: 'Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.' '405': description: 'Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.' '409': description: 'Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.' '410': description: 'Gone: The requested resource is no longer available.' '415': description: 'Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.' '423': description: 'Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.' '428': description: 'Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.' '429': description: 'Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.' '500': description: 'Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).' '502': description: 'Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.' '503': description: 'Service Unavailable: Server is overloaded with requests. Try again later.' '504': description: 'Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.' summary: Create a Group operationId: Create a Group description: Create a new group for a given organization. The group may optionally be created with group members. tags: - Groups parameters: [] requestBody: content: application/json: example: displayName: Sales Group orgId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi8zNDhhZGI4MS0yOGY5LTRhYjUtYjJkNi1lOWI0OTRlNzJhMDY description: Salas Group in San Jose members: - id: Y2lzY29zcGFyazovL3VzL1BFT1BMRS8xOTUzOTdhMi03MTU5LTRjNTgtYTBiOC00NmQ2ZWZlZTdkMTM schema: $ref: '#/components/schemas/PostGroup' get: responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/GroupsCollectionResponse' example: totalResults: 3 startIndex: 1 itemsPerPage: 10 groups: - id: Y2lzY29zcGFyazovL3VzL1NDSU1fR1JPVVAvMjUxMDRiZTAtZjg3NC00MzQzLTk2MDctZGYwMmRmMzdiNWMxOjM0OGFkYjgxLTI4ZjktNGFiNS1iMmQ2LWU5YjQ5NGU3MmEwNg displayName: Sales Group orgId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi8zNDhhZGI4MS0yOGY5LTRhYjUtYjJkNi1lOWI0OTRlNzJhMDY created: '2022-02-17T02:13:29.706Z' lastModified: '2022-02-17T02:13:29.706Z' memberSize: 1 members: - id: Y2lzY29zcGFyazovL3VzL1BFT1BMRS8xOTUzOTdhMi03MTU5LTRjNTgtYTBiOC00NmQ2ZWZlZTdkMTM type: user displayName: Jane Smith '400': description: 'Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.' '401': description: 'Unauthorized: Authentication credentials were missing or incorrect.' '403': description: 'Forbidden: The request is understood, but it has been refused or access is not allowed.' '404': description: 'Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.' '405': description: 'Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.' '409': description: 'Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.' '410': description: 'Gone: The requested resource is no longer available.' '415': description: 'Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.' '423': description: 'Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.' '428': description: 'Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.' '429': description: 'Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.' '500': description: 'Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).' '502': description: 'Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.' '503': description: 'Service Unavailable: Server is overloaded with requests. Try again later.' '504': description: 'Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.' summary: List and Search Groups operationId: List and Search Groups description: 'List groups in your organization. * Set the `includeMembers` parameter to `true` to return group members. The total number of members returned is limited to 500. * Use the `startIndex` and `count` parameters to page through result set. * To search for a specific group use the `filter` parameter. * Use `sortBy` parameter to sort the responses by `id` or `displayName`.' tags: - Groups parameters: - name: orgId in: query description: List groups in this organization. Only admin users of another organization (such as partners) may use this parameter. example: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi85NmFiYzJhYS0zZGNjLTExZTUtYTE1Mi1mZTM0ODE5Y2RjOWE schema: type: string - name: filter in: query description: Searches the group by `displayName` with an operator and a value. The available operators are `eq` (equal) and `sw` (starts with). Only `displayName` can be used to filter results. example: displayName eq "Marketing Department" schema: type: string - name: attributes in: query description: The attributes to return. example: displayName schema: type: string - name: sortBy in: query description: Sort the results based by group `displayName`. example: displayName schema: type: string - name: sortOrder in: query description: Sort results alphabetically by group display name, in ascending or descending order. example: ascending schema: type: string - name: includeMembers in: query description: Optionally return group members in the response. The maximum number of members returned is 500. example: 'false' schema: type: boolean - name: startIndex in: query description: The index to start for group pagination. example: '1' schema: type: number - name: count in: query description: Specifies the desired number of search results per page. example: '100' schema: type: number /groups/{groupId}: patch: responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/GroupResponse' example: id: Y2lzY29zcGFyazovL3VzL1NDSU1fR1JPVVAvMjUxMDRiZTAtZjg3NC00MzQzLTk2MDctZGYwMmRmMzdiNWMxOjM0OGFkYjgxLTI4ZjktNGFiNS1iMmQ2LWU5YjQ5NGU3MmEwNg displayName: Sales Group orgId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi8zNDhhZGI4MS0yOGY5LTRhYjUtYjJkNi1lOWI0OTRlNzJhMDY created: '2022-02-17T02:13:29.706Z' lastModified: '2022-02-17T02:13:29.706Z' memberSize: 1 members: - id: Y2lzY29zcGFyazovL3VzL1BFT1BMRS8xOTUzOTdhMi03MTU5LTRjNTgtYTBiOC00NmQ2ZWZlZTdkMTM type: user displayName: Jane Smith '400': description: 'Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.' '401': description: 'Unauthorized: Authentication credentials were missing or incorrect.' '403': description: 'Forbidden: The request is understood, but it has been refused or access is not allowed.' '404': description: 'Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.' '405': description: 'Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.' '409': description: 'Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.' '410': description: 'Gone: The requested resource is no longer available.' '415': description: 'Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.' '423': description: 'Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.' '428': description: 'Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.' '429': description: 'Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.' '500': description: 'Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).' '502': description: 'Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.' '503': description: 'Service Unavailable: Server is overloaded with requests. Try again later.' '504': description: 'Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.' summary: Update a Group operationId: Update a Group description: 'Update the group details, by ID. Specify the group ID in the `groupId` parameter in the URI.' tags: - Groups parameters: - name: groupId in: path description: A unique identifier for the group. required: true example: Y2lzY29zcGFyazovL3VzL1NDSU1fR1JPVVAvYzY1ZjdkODUtYjY5MS00MmI4LWEyMGItODUzMDY0ZTFkNThiOjM0OGFkYjgxLTI4ZjktNGFiNS1iMmQ2LWU5YjQ5NGU3MmEwNg schema: type: string requestBody: content: application/json: example: displayName: New Sales Group description: Sales Group in LA members: - id: Y2lzY29zcGFyazovL3VzL1BFT1BMRS8xOTUzOTdhMi03MTU5LTRjNTgtYTBiOC00NmQ2ZWZlZTdkMTM operation: add schema: $ref: '#/components/schemas/PatchGroup' get: responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/GroupResponse' example: id: Y2lzY29zcGFyazovL3VzL1NDSU1fR1JPVVAvMjUxMDRiZTAtZjg3NC00MzQzLTk2MDctZGYwMmRmMzdiNWMxOjM0OGFkYjgxLTI4ZjktNGFiNS1iMmQ2LWU5YjQ5NGU3MmEwNg displayName: Sales Group orgId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi8zNDhhZGI4MS0yOGY5LTRhYjUtYjJkNi1lOWI0OTRlNzJhMDY created: '2022-02-17T02:13:29.706Z' lastModified: '2022-02-17T02:13:29.706Z' memberSize: 1 members: - id: Y2lzY29zcGFyazovL3VzL1BFT1BMRS8xOTUzOTdhMi03MTU5LTRjNTgtYTBiOC00NmQ2ZWZlZTdkMTM type: user displayName: Jane Smith '400': description: 'Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.' '401': description: 'Unauthorized: Authentication credentials were missing or incorrect.' '403': description: 'Forbidden: The request is understood, but it has been refused or access is not allowed.' '404': description: 'Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.' '405': description: 'Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.' '409': description: 'Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.' '410': description: 'Gone: The requested resource is no longer available.' '415': description: 'Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.' '423': description: 'Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.' '428': description: 'Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.' '429': description: 'Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.' '500': description: 'Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).' '502': description: 'Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.' '503': description: 'Service Unavailable: Server is overloaded with requests. Try again later.' '504': description: 'Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.' summary: Get Group Details operationId: Get Group Details description: 'Get details for a group, by ID. Optionally, the members may be retrieved with this request. The maximum number of members returned is 500.' tags: - Groups parameters: - name: groupId in: path description: A unique identifier for the group. required: true example: Y2lzY29zcGFyazovL3VzL1NDSU1fR1JPVVAvYzY1ZjdkODUtYjY5MS00MmI4LWEyMGItODUzMDY0ZTFkNThiOjM0OGFkYjgxLTI4ZjktNGFiNS1iMmQ2LWU5YjQ5NGU3MmEwNg schema: type: string - name: includeMembers in: query description: Include the members as part of the response. example: 'true' schema: type: boolean default: 'false' delete: responses: '204': description: No Content headers: {} content: {} '400': description: 'Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.' '401': description: 'Unauthorized: Authentication credentials were missing or incorrect.' '403': description: 'Forbidden: The request is understood, but it has been refused or access is not allowed.' '404': description: 'Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.' '405': description: 'Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.' '409': description: 'Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.' '410': description: 'Gone: The requested resource is no longer available.' '415': description: 'Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.' '423': description: 'Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.' '428': description: 'Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.' '429': description: 'Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.' '500': description: 'Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).' '502': description: 'Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.' '503': description: 'Service Unavailable: Server is overloaded with requests. Try again later.' '504': description: 'Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.' summary: Delete a Group operationId: Delete a Group description: 'Remove a group from the system. Specify the group ID in the `groupId` parameter in the URI.' tags: - Groups parameters: - name: groupId in: path description: A unique identifier for the group. required: true example: Y2lzY29zcGFyazovL3VzL1BFT1BMRS9mNWIzNjE4Ny1jOGRkLTQ3MjctOGIyZi1mOWM0NDdmMjkwNDY schema: type: string /groups/{groupId}/members: get: responses: '200': description: OK headers: {} content: application/json: schema: $ref: '#/components/schemas/GroupResponse' example: id: Y2lzY29zcGFyazovL3VzL1NDSU1fR1JPVVAvMjUxMDRiZTAtZjg3NC00MzQzLTk2MDctZGYwMmRmMzdiNWMxOjM0OGFkYjgxLTI4ZjktNGFiNS1iMmQ2LWU5YjQ5NGU3MmEwNg displayName: Sales Group orgId: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi8zNDhhZGI4MS0yOGY5LTRhYjUtYjJkNi1lOWI0OTRlNzJhMDY created: '2022-02-17T02:13:29.706Z' lastModified: '2022-02-17T02:13:29.706Z' memberSize: 1 members: - id: Y2lzY29zcGFyazovL3VzL1BFT1BMRS8xOTUzOTdhMi03MTU5LTRjNTgtYTBiOC00NmQ2ZWZlZTdkMTM type: user displayName: Jane Smith '400': description: 'Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.' '401': description: 'Unauthorized: Authentication credentials were missing or incorrect.' '403': description: 'Forbidden: The request is understood, but it has been refused or access is not allowed.' '404': description: 'Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.' '405': description: 'Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.' '409': description: 'Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.' '410': description: 'Gone: The requested resource is no longer available.' '415': description: 'Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.' '423': description: 'Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.' '428': description: 'Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.' '429': description: 'Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.' '500': description: 'Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).' '502': description: 'Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.' '503': description: 'Service Unavailable: Server is overloaded with requests. Try again later.' '504': description: 'Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.' summary: Get Group Members operationId: Get Group Members description: 'Gets the members of a group. * The default maximum members returned is 500. * Control parameters is available to page through the members and to control the size of the results.' tags: - Groups parameters: - name: groupId in: path description: A unique identifier for the group. required: true example: Y2lzY29zcGFyazovL3VzL1NDSU1fR1JPVVAvYzY1ZjdkODUtYjY5MS00MmI4LWEyMGItODUzMDY0ZTFkNThiOjM0OGFkYjgxLTI4ZjktNGFiNS1iMmQ2LWU5YjQ5NGU3MmEwNg schema: type: string - name: startIndex in: query description: The index to start for group pagination. example: '1' schema: type: number - name: count in: query description: Non-negative integer that specifies the desired number of search results per page. Maximum value for the count is 500. example: '100' schema: type: number components: schemas: PostGroup: type: object required: - schemas - displayName properties: schemas: type: array items: type: string example: urn:ietf:params:scim:schemas:core:2.0:Group,urn:scim:schemas:extension:cisco:webexidentity:2.0:Group description: Input JSON schemas. displayName: type: string example: group1@example.com description: A human-readable name for the Group. externalId: type: string example: test description: An identifier for the resource as defined by the provisioning client. members: type: array items: $ref: '#/components/schemas/GroupMemberObject' description: A list of members of this group. urn:scim:schemas:extension:cisco:webexidentity:2.0:Group: type: object properties: usage: type: string example: policy description: The identifier of this Group. owners: type: array items: type: object properties: value: type: string example: c5349664-9f3d-410b-8bd3-6c31f181f13d description: The identifier of the owner of this group. description: The owners of this group. inheritances: type: array items: $ref: '#/components/schemas/GroupInheritancesObject' description: An array of inheritances managedBy: type: array items: $ref: '#/components/schemas/ManagedByObject' description: A list of delegates of this group. description: The Cisco extension of SCIM 2. PatchGroup: type: object required: - schemas - Operations properties: schemas: type: array items: type: string example: urn:ietf:params:scim:api:messages:2.0:PatchOp description: Input JSON schemas. Operations: type: array items: type: object required: - op properties: op: type: string enum: - add - replace - remove description: The operation to perform. path: type: string example: displayName description: A string containing an attribute path describing the target of the operation. value: type: array items: $ref: '#/components/schemas/GroupInheritancesObject' description: New value. description: A list of patch operations. Member: type: object properties: id: type: string example: Y2lzY29zcGFyazovL3VzL1BFT1BMRS8xOTUzOTdhMi03MTU5LTRjNTgtYTBiOC00NmQ2ZWZlZTdkMTM description: Person ID of the group member. type: type: string example: user description: Member type. displayName: type: string example: Jane Smith ManagedByObject: type: object properties: orgId: type: string example: d1349664-9f3d-410b-8bd3-6c31f181f14e description: The Organization identifier of the resource. type: type: string example: user description: The resource type. id: type: string example: c5349664-9f3d-410b-8bd3-6c31f181f13d description: The identifier of the resource. role: type: string example: location_full_admin description: The delegated role. GroupMemberObject: type: object properties: value: type: string example: c5349664-9f3d-410b-8bd3-6c31f181f13d description: The identifier of the member of this Group. type: type: string example: user description: A label indicating the type of resource, for example user, machine, or group. GroupResponse: type: object properties: id: type: string example: Y2lzY29zcGFyazovL3VzL1NDSU1fR1JPVVAvMjUxMDRiZTAtZjg3NC00MzQzLTk2MDctZGYwMmRmMzdiNWMxOjM0OGFkYjgxLTI4ZjktNGFiNS1iMmQ2LWU5YjQ5NGU3MmEwNg description: A unique identifier for the group. displayName: type: string example: Sales Group description: The name of the group. orgId: type: string example: Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi8zNDhhZGI4MS0yOGY5LTRhYjUtYjJkNi1lOWI0OTRlNzJhMDY description: The ID of the organization to which this group belongs. created: type: string example: '2022-02-17T02:13:29.706Z' description: The timestamp indicating creation date/time of group lastModified: type: string example: '2022-02-17T02:13:29.706Z' description: The timestamp indicating lastModification time of group memberSize: type: number example: 1 members: type: array items: $ref: '#/components/schemas/Member' description: An array of members GroupInheritancesObject: type: object properties: type: type: string enum: - role example: role description: Type of inheritance. Currently, only the `role` type is supported. Only `policy` usage supports inheritance. value: type: string example: id_full_admin description: The value of the inheritance. For the role type, this can be role names such as `id_full_admin`, `id_user_admin`, etc. nested: type: boolean example: false description: Indicates whether this inheritance is nested. scope: type: array items: type: string example: - user description: Indicates which types of entities can inherit this property. GroupsCollectionResponse: type: object properties: totalResults: type: number example: 3 description: Total number of groups returned in the response. startIndex: type: number example: 1 itemsPerPage: type: number example: 10 groups: type: array items: $ref: '#/components/schemas/GroupResponse' description: An array of group objects. securitySchemes: oauth2: flows: authorizationCode: authorizationUrl: / scopes: {} tokenUrl: / type: oauth2 bearer-key: type: http description: e.g. Bearer YOUR_AUTHORIZATION_TOKEN scheme: bearer bearerFormat: JWT bearerAuth: type: oauth2 description: OAuth 2.0 Bearer token authentication flows: authorizationCode: authorizationUrl: https://webexapis.com/v1/authorize tokenUrl: https://webexapis.com/v1/access_token scopes: spark:applications_token: Create access tokens for Service Apps