UNPKG

box-node-sdk

Version:

Official SDK for Box Plaform APIs

117 lines (116 loc) 5.46 kB
import BoxClient from '../box-client'; import * as schemas from '../schemas'; /** */ declare class IntegrationMappingsManager { client: BoxClient; /** * @param {BoxClient} client The Box API Client that is responsible for making calls to the API */ constructor(client: BoxClient); /** * List Slack integration mappings * * Lists [Slack integration mappings](https://support.box.com/hc/en-us/articles/4415585987859-Box-as-the-Content-Layer-for-Slack) in a users' enterprise. * * You need Admin or Co-Admin role to * use this endpoint. * @param {object} [options] Options for the request * @param {string} [options.marker] Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires `usemarker` to be set to `true`. * @param {number} [options.limit] The maximum number of items to return per page. * @param {"channel"} [options.partner_item_type] Mapped item type, for which the mapping should be returned * @param {string} [options.partner_item_id] ID of the mapped item, for which the mapping should be returned * @param {string} [options.box_item_id] Box item ID, for which the mappings should be returned * @param {"folder"} [options.box_item_type] Box item type, for which the mappings should be returned * @param {boolean} [options.is_manually_created] Whether the mapping has been manually created * @param {Function} [callback] Passed the result if successful, error otherwise * @returns {Promise<schemas.IntegrationMappings>} A promise resolving to the result or rejecting with an error */ getSlackIntegrationMappings(options?: { /** * Defines the position marker at which to begin returning results. This is * used when paginating using marker-based pagination. * * This requires `usemarker` to be set to `true`. */ readonly marker?: string; /** * The maximum number of items to return per page. */ readonly limit?: number; /** * Mapped item type, for which the mapping should be returned */ readonly partner_item_type?: 'channel'; /** * ID of the mapped item, for which the mapping should be returned */ readonly partner_item_id?: string; /** * Box item ID, for which the mappings should be returned */ readonly box_item_id?: string; /** * Box item type, for which the mappings should be returned */ readonly box_item_type?: 'folder'; /** * Whether the mapping has been manually created */ readonly is_manually_created?: boolean; }, callback?: Function): Promise<schemas.IntegrationMappings>; /** * Create Slack integration mapping * * Creates a [Slack integration mapping](https://support.box.com/hc/en-us/articles/4415585987859-Box-as-the-Content-Layer-for-Slack) * by mapping a Slack channel to a Box item. * * You need Admin or Co-Admin role to * use this endpoint. * @param {schemas.IntegrationMappingSlackCreateRequest} body * @param {object} [options] Options for the request * @param {Function} [callback] Passed the result if successful, error otherwise * @returns {Promise<schemas.IntegrationMapping>} A promise resolving to the result or rejecting with an error */ createSlackIntegrationMapping(body: schemas.IntegrationMappingSlackCreateRequest, options?: {}, callback?: Function): Promise<schemas.IntegrationMapping>; /** * Update Slack integration mapping * * Updates a [Slack integration mapping](https://support.box.com/hc/en-us/articles/4415585987859-Box-as-the-Content-Layer-for-Slack). * Supports updating the Box folder ID and options. * * You need Admin or Co-Admin role to * use this endpoint. * @param {object} body * @param {object} options Options for the request * @param {string} options.integration_mapping_id An ID of an integration mapping * @param {Function} [callback] Passed the result if successful, error otherwise * @returns {Promise<schemas.IntegrationMapping>} A promise resolving to the result or rejecting with an error */ updateSlackIntegrationMapping(body: object, options: { /** * An ID of an integration mapping */ readonly integration_mapping_id: string; }, callback?: Function): Promise<schemas.IntegrationMapping>; /** * Delete Slack integration mapping * * Deletes a [Slack integration mapping](https://support.box.com/hc/en-us/articles/4415585987859-Box-as-the-Content-Layer-for-Slack). * * * You need Admin or Co-Admin role to * use this endpoint. * @param {object} options Options for the request * @param {string} options.integration_mapping_id An ID of an integration mapping * @param {Function} [callback] Passed the result if successful, error otherwise * @returns {Promise<void>} A promise resolving to the result or rejecting with an error */ deleteSlackIntegrationMappingById(options: { /** * An ID of an integration mapping */ readonly integration_mapping_id: string; }, callback?: Function): Promise<void>; } export = IntegrationMappingsManager;