Folders API Endpoint Ingrid ⇤ Endpoints https://api.bitsighttech.com/ratings/v1/folders Manage your portfolio folders and their contents: List details about all folders. List details about a single folder. Update information about a folder and change its settings. Edit folder sharing. Create and delete folders. Add or remove organizations in your subscriptions to and from folders. The folders API is meant to manage folders and their contents only. If you want to add an organization to your portfolio using the API (so that you can then add it to a folder), use the /subscriptions endpoint to first subscribe, and then use the /folders endpoint for sorting. When using PATCH or POST HTTP methods, you will need to specify “application/json” in the Content-Type header and send the data payload as binary data. Paths Path Purpose Description /v1/folders GET: Folder Details This returns each folder as separate objects and shared folders that are owned by you or are associated with you. Append a folder GUID to the URL for details of a single folder. /v1/folders/ POST: Create a Folder Create a new folder. /v1/folders/folder_guid DELETE: Delete a Folder Delete a folder and remove it from your portfolio. /v1/folders/folder_guid PATCH: Edit Folder Properties Edit folder properties including how long companies will be in the folder (expiration), folder description, folder name, and sharing options. /v1/folders/folder_guid PATCH: Manage Shared Folder Permissions Manage permissions for shared folders. /v1/folders/folder_guid/companies PATCH: Add Companies to a Folder Add companies to an existing folder. /v1/folders/folder_guid/companies PATCH: Remove Companies from a Folder Remove companies from a folder. /v1/folders/folder_guid/findings/summary GET: Findings in a Folder See the presence of findings in a folder. /v1/folders/folder_guid/graph_data GET: Ratings Graph Data of a Folder Get the ratings graph data of a folder. /v1/folders/folder_guid/products GET: Products in a Folder Get the enterprise products used in a folder. /v1/folders/folder_guid/products/product_guid/companies GET: Product Usage of Companies in a Folder List the third parties in a folder that use a particular service provider product. /v1/folders/folder_guid/product-types GET: Product Types in a Folder Get the product types that are used by all companies in a particular folder. /v1/folders/folder_guid/providers GET: Service Providers in a Folder Get the service providers that are used in particular folder. /v1/folders/folder_guid/providers/provider_guid/companies GET: Companies in a Folder that Depends on a Specific Service Provider Get all companies within a folder that depends on a specific service provider. /v1/folders/folder_guid/providers/provider_guid/products GET: Products in a Specific Folder Get the products of a particular service provider used by companies within a specific folder. July 10, 2023: Removed PDF. October 19, 2020: Added GET: Product Usage of Companies in a Folder [/v1/folders/{folder_guid}/products/{product_guid}/companies]. Related articles GET: Folder Details PATCH: Add Companies to a Folder POST: Create a Folder GET: Findings in a Folder PATCH: Edit a Folder Feedback 0 comments Please sign in to leave a comment.