WickrClient
Welcome to the Amazon Web Services Wickr API Reference.
The Amazon Web Services Wickr application programming interface (API) is designed for administrators to perform key tasks, such as creating and managing Amazon Web Services Wickr, networks, users, security groups, bots and more. This guide provides detailed information about the Amazon Web Services Wickr API, including operations, types, inputs and outputs, and error codes. You can use an Amazon Web Services SDK, the Amazon Web Services Command Line Interface (Amazon Web Services CLI, or the REST API to make API calls for Amazon Web Services Wickr.
Using Amazon Web Services SDK
The SDK clients authenticate your requests by using access keys that you provide. For more information, see Authentication and access using Amazon Web Services SDKs and tools in the Amazon Web Services SDKs and Tools Reference Guide.
Using Amazon Web Services CLI
Use your access keys with the Amazon Web Services CLI to make API calls. For more information about setting up the Amazon Web Services CLI, see Getting started with the Amazon Web Services CLI in the Amazon Web Services Command Line Interface User Guide for Version 2.
Using REST APIs
If you use REST to make API calls, you must authenticate your request by providing a signature. Amazon Web Services Wickr supports Signature Version 4. For more information, see Amazon Web Services Signature Version 4 for API requests in the Amazon Web Services Identity and Access Management User Guide.
Access and permissions to the APIs can be controlled by Amazon Web Services Identity and Access Management. The managed policy Amazon Web ServicesWickrFullAccess grants full administrative permission to the Amazon Web Services Wickr service APIs. For more information on restricting access to specific operations, see Identity and access management for Amazon Web Services Wickr in the Amazon Web Services Wickr Administration Guide.
Types of Errors:
The Amazon Web Services Wickr APIs provide an HTTP interface. HTTP defines ranges of HTTP Status Codes for different types of error responses.
Client errors are indicated by HTTP Status Code class of 4xx
Service errors are indicated by HTTP Status Code class of 5xx
In this reference guide, the documentation for each API has an Errors section that includes a brief discussion about HTTP status codes. We recommend looking there as part of your investigation when you get an error.
Functions
Creates multiple users in a specified Wickr network. This operation allows you to provision multiple user accounts simultaneously, optionally specifying security groups, and validation requirements for each user.
Deletes multiple users from a specified Wickr network. This operation permanently removes user accounts and their associated data from the network.
Looks up multiple user usernames from their unique username hashes (unames). This operation allows you to retrieve the email addresses associated with a list of username hashes.
Resends invitation codes to multiple users who have pending invitations in a Wickr network. This operation is useful when users haven't accepted their initial invitations or when invitations have expired.
Resets multiple devices for a specific user in a Wickr network. This operation forces the selected devices to log out and requires users to re-authenticate, which is useful for security purposes or when devices need to be revoked.
Suspends or unsuspends multiple users in a Wickr network. Suspended users cannot access the network until they are unsuspended. This operation is useful for temporarily restricting access without deleting user accounts.
Creates a new bot in a specified Wickr network. Bots are automated accounts that can send and receive messages, enabling integration with external systems and automation of tasks.
Creates a data retention bot in a Wickr network. Data retention bots are specialized bots that handle message archiving and compliance by capturing and storing messages for regulatory or organizational requirements.
Creates a new challenge password for the data retention bot. This password is used for authentication when the bot connects to the network.
Creates a new Wickr network with specified access level and configuration. This operation provisions a new communication network for your organization.
Creates a new security group in a Wickr network. Security groups allow you to organize users and control their permissions, features, and security settings.
Deletes a bot from a specified Wickr network. This operation permanently removes the bot account and its associated data from the network.
Deletes the data retention bot from a Wickr network. This operation permanently removes the bot and all its associated data from the database.
Deletes a Wickr network and all its associated resources, including users, bots, security groups, and settings. This operation is permanent and cannot be undone.
Deletes a security group from a Wickr network. This operation cannot be performed on the default security group.
Retrieves detailed information about a specific bot in a Wickr network, including its status, group membership, and authentication details.
Retrieves the count of bots in a Wickr network, categorized by their status (pending, active, and total).
Retrieves information about the data retention bot in a Wickr network, including its status and whether the data retention service is enabled.
Retrieves historical guest user count data for a Wickr network, showing the number of guest users per billing period over the past 90 days.
Retrieves detailed information about a specific Wickr network, including its configuration, access level, and status.
Retrieves all network-level settings for a Wickr network, including client metrics, data retention, and other configuration options.
Retrieves the OpenID Connect (OIDC) configuration for a Wickr network, including SSO settings and optional token information if access token parameters are provided.
Retrieves detailed information about a specific security group in a Wickr network, including its settings, member counts, and configuration.
Retrieves detailed information about a specific user in a Wickr network, including their profile, status, and activity history.
Retrieves the count of users in a Wickr network, categorized by their status (pending, active, rejected) and showing how many users can still be added.
Retrieves a paginated list of guest users who have been blocked from a Wickr network. You can filter and sort the results.
Retrieves a paginated list of bots in a specified Wickr network. You can filter and sort the results based on various criteria.
Retrieves a paginated list of devices associated with a specific user in a Wickr network. This operation returns information about all devices where the user has logged into Wickr.
Retrieves a paginated list of guest users who have communicated with your Wickr network. Guest users are external users from federated networks who can communicate with network members.
Retrieves a paginated list of all Wickr networks associated with your Amazon Web Services account. You can sort the results by network ID or name.
Retrieves a paginated list of security groups in a specified Wickr network. You can sort the results by various criteria.
Retrieves a paginated list of users who belong to a specific security group in a Wickr network.
Retrieves a paginated list of users in a specified Wickr network. You can filter and sort the results based on various criteria such as name, status, or security group membership.
Registers and saves an OpenID Connect (OIDC) configuration for a Wickr network, enabling Single Sign-On (SSO) authentication through an identity provider.
Tests an OpenID Connect (OIDC) configuration for a Wickr network by validating the connection to the identity provider and retrieving its supported capabilities.
Updates the properties of an existing bot in a Wickr network. This operation allows you to modify the bot's display name, security group, password, or suspension status.
Updates the data retention bot settings, allowing you to enable or disable the data retention service, or acknowledge the public key message.
Updates the block status of a guest user in a Wickr network. This operation allows you to block or unblock a guest user from accessing the network.
Updates the properties of an existing Wickr network, such as its name or encryption key configuration.
Updates network-level settings for a Wickr network. You can modify settings such as client metrics, data retention, and other network-wide options.
Updates the properties of an existing security group in a Wickr network, such as its name or settings.
Updates the properties of an existing user in a Wickr network. This operation allows you to modify the user's name, password, security group membership, and invite code settings.
Inherited functions
Creates multiple users in a specified Wickr network. This operation allows you to provision multiple user accounts simultaneously, optionally specifying security groups, and validation requirements for each user.
Deletes multiple users from a specified Wickr network. This operation permanently removes user accounts and their associated data from the network.
Looks up multiple user usernames from their unique username hashes (unames). This operation allows you to retrieve the email addresses associated with a list of username hashes.
Resends invitation codes to multiple users who have pending invitations in a Wickr network. This operation is useful when users haven't accepted their initial invitations or when invitations have expired.
Resets multiple devices for a specific user in a Wickr network. This operation forces the selected devices to log out and requires users to re-authenticate, which is useful for security purposes or when devices need to be revoked.
Suspends or unsuspends multiple users in a Wickr network. Suspended users cannot access the network until they are unsuspended. This operation is useful for temporarily restricting access without deleting user accounts.
Creates a new bot in a specified Wickr network. Bots are automated accounts that can send and receive messages, enabling integration with external systems and automation of tasks.
Creates a data retention bot in a Wickr network. Data retention bots are specialized bots that handle message archiving and compliance by capturing and storing messages for regulatory or organizational requirements.
Creates a new challenge password for the data retention bot. This password is used for authentication when the bot connects to the network.
Creates a new Wickr network with specified access level and configuration. This operation provisions a new communication network for your organization.
Creates a new security group in a Wickr network. Security groups allow you to organize users and control their permissions, features, and security settings.
Deletes a bot from a specified Wickr network. This operation permanently removes the bot account and its associated data from the network.
Deletes the data retention bot from a Wickr network. This operation permanently removes the bot and all its associated data from the database.
Deletes a Wickr network and all its associated resources, including users, bots, security groups, and settings. This operation is permanent and cannot be undone.
Deletes a security group from a Wickr network. This operation cannot be performed on the default security group.
Retrieves detailed information about a specific bot in a Wickr network, including its status, group membership, and authentication details.
Retrieves the count of bots in a Wickr network, categorized by their status (pending, active, and total).
Retrieves information about the data retention bot in a Wickr network, including its status and whether the data retention service is enabled.
Retrieves historical guest user count data for a Wickr network, showing the number of guest users per billing period over the past 90 days.
Retrieves detailed information about a specific Wickr network, including its configuration, access level, and status.
Retrieves all network-level settings for a Wickr network, including client metrics, data retention, and other configuration options.
Retrieves the OpenID Connect (OIDC) configuration for a Wickr network, including SSO settings and optional token information if access token parameters are provided.
Retrieves detailed information about a specific security group in a Wickr network, including its settings, member counts, and configuration.
Retrieves detailed information about a specific user in a Wickr network, including their profile, status, and activity history.
Retrieves the count of users in a Wickr network, categorized by their status (pending, active, rejected) and showing how many users can still be added.
Retrieves a paginated list of guest users who have been blocked from a Wickr network. You can filter and sort the results.
Paginate over ListBlockedGuestUsersResponse results.
Retrieves a paginated list of bots in a specified Wickr network. You can filter and sort the results based on various criteria.
Paginate over ListBotsResponse results.
Retrieves a paginated list of devices associated with a specific user in a Wickr network. This operation returns information about all devices where the user has logged into Wickr.
Paginate over ListDevicesForUserResponse results.
Retrieves a paginated list of guest users who have communicated with your Wickr network. Guest users are external users from federated networks who can communicate with network members.
Paginate over ListGuestUsersResponse results.
Retrieves a paginated list of all Wickr networks associated with your Amazon Web Services account. You can sort the results by network ID or name.
Paginate over ListNetworksResponse results.
Retrieves a paginated list of security groups in a specified Wickr network. You can sort the results by various criteria.
Paginate over ListSecurityGroupsResponse results.
Retrieves a paginated list of users who belong to a specific security group in a Wickr network.
Paginate over ListSecurityGroupUsersResponse results.
Retrieves a paginated list of users in a specified Wickr network. You can filter and sort the results based on various criteria such as name, status, or security group membership.
Paginate over ListUsersResponse results.
Registers and saves an OpenID Connect (OIDC) configuration for a Wickr network, enabling Single Sign-On (SSO) authentication through an identity provider.
Tests an OpenID Connect (OIDC) configuration for a Wickr network by validating the connection to the identity provider and retrieving its supported capabilities.
Updates the properties of an existing bot in a Wickr network. This operation allows you to modify the bot's display name, security group, password, or suspension status.
Updates the data retention bot settings, allowing you to enable or disable the data retention service, or acknowledge the public key message.
Updates the block status of a guest user in a Wickr network. This operation allows you to block or unblock a guest user from accessing the network.
Updates the properties of an existing Wickr network, such as its name or encryption key configuration.
Updates network-level settings for a Wickr network. You can modify settings such as client metrics, data retention, and other network-wide options.
Updates the properties of an existing security group in a Wickr network, such as its name or settings.
Updates the properties of an existing user in a Wickr network. This operation allows you to modify the user's name, password, security group membership, and invite code settings.
Create a copy of the client with one or more configuration values overridden. This method allows the caller to perform scoped config overrides for one or more client operations.