# Developer

**URL:** https://community.bluescape.com/c/developer/14.md

[Latest](https://community.bluescape.com/latest.md) · [Categories](https://community.bluescape.com/categories.md) · [Tags](https://community.bluescape.com/tags.md)

---

## [Bluescape API - Getting Started Guide](https://community.bluescape.com/t/bluescape-api-getting-started-guide/2020)

<div class="topic-metadata">

**Author:** [@kkoechley](https://community.bluescape.com/u/kkoechley)\
**Replies:** 0\
**Last updated:** [July 26, 2022, 6:42pm UTC](https://community.bluescape.com/t/bluescape-api-getting-started-guide/2020 "2022-07-26T18:42:49Z")

</div>

This is a list of guides that describes and breaks down using both REST and GraphQL to interact with Bluescape APIs. Each section contains walkthroughs for performing each task with both the REST and GraphQL methods, whi…

---

## [Bluescape API Overview](https://community.bluescape.com/t/bluescape-api-overview/2021)

<div class="topic-metadata">

**Author:** [@Tom\_Garrett](https://community.bluescape.com/u/Tom_Garrett)\
**Replies:** 0\
**Last updated:** [July 26, 2022, 6:42pm UTC](https://community.bluescape.com/t/bluescape-api-overview/2021 "2022-07-26T18:42:39Z")

</div>

The Bluescape API is a REST API that can be accessed through explicit HTTP calls. These APIs expose most of the features available in the Bluescape product. The Bluescape API enables developers to programmatically crea…

---

## [API Documentation Landing Page](https://community.bluescape.com/t/api-documentation-landing-page/2174)

<div class="topic-metadata">

**Author:** [@kkoechley](https://community.bluescape.com/u/kkoechley)\
**Replies:** 0\
**Last updated:** [July 20, 2022, 4:57pm UTC](https://community.bluescape.com/t/api-documentation-landing-page/2174 "2022-07-20T16:57:09Z")

</div>

Looking for API Resources? Here is a collection of all of the API content available on Bluescape Community: Bluescape API Overview Bluescape API Guides Landing Page What is new in v3? Introduction to GraphQL GraphQL vs…

---

## [V3 API Application Authorization](https://community.bluescape.com/t/v3-api-application-authorization/3695)

<div class="topic-metadata">

**Author:** [@kkoechley](https://community.bluescape.com/u/kkoechley)\
**Replies:** 0\
**Last updated:** [June 2, 2023, 5:21pm UTC](https://community.bluescape.com/t/v3-api-application-authorization/3695 "2023-06-02T17:21:14Z")

</div>

Applications that want to query the Bluescape API must be authorized to do so by an active Bluescape user. Applications obtain this authorization using OAuth2, which enables users to share access to their account witho…

---

## [System Design Interviews](https://community.bluescape.com/t/system-design-interviews/6090)

<div class="topic-metadata">

**Author:** [@ngunukula](https://community.bluescape.com/u/ngunukula)\
**Replies:** 0\
**Last updated:** [February 17, 2025, 7:48pm UTC](https://community.bluescape.com/t/system-design-interviews/6090 "2025-02-17T19:48:52Z")

</div>

System Design Interviews

---

## [Webhooks Developer Guide](https://community.bluescape.com/t/webhooks-developer-guide/5883)

<div class="topic-metadata">

**Author:** [@NealSr](https://community.bluescape.com/u/NealSr)\
**Replies:** 0\
**Last updated:** [October 29, 2024, 4:49am UTC](https://community.bluescape.com/t/webhooks-developer-guide/5883 "2024-10-29T04:49:19Z")

</div>

Webhooks Developer Guide As of Q3 2024, Developers using Bluescape’s API can now utilize webhooks for more efficient workflow automation. Webhooks allow you to pre-assign a webhook endpoint to call when a specified even…

---

## [Basic API Requests](https://community.bluescape.com/t/basic-api-requests/2022)

<div class="topic-metadata">

**Author:** [@Tom\_Garrett](https://community.bluescape.com/u/Tom_Garrett)\
**Replies:** 2\
**Last updated:** [August 5, 2024, 3:31pm UTC](https://community.bluescape.com/t/basic-api-requests/2022 "2024-08-05T15:31:49Z")

</div>

This guide assumes you have obtained an access token from an authorized user. You can obtain an access token by completing the OAuth flow (see the Application Authorization guide). This page contains the details for RES…

---

## [Create high quality screenshot of a workspace](https://community.bluescape.com/t/create-high-quality-screenshot-of-a-workspace/5801)

<div class="topic-metadata">

**Author:** [@spa\_it\_department](https://community.bluescape.com/u/spa_it_department)\
**Replies:** 4\
**Last updated:** [July 30, 2024, 9:02am UTC](https://community.bluescape.com/t/create-high-quality-screenshot-of-a-workspace/5801 "2024-07-30T09:02:20Z")

</div>

The interface option to create an export of a workspace (recently updated) outputs images in a very low quality on my panels. Is there a way to create a high quality screenshot? I’ve been thinking on “creative” solutio…

---

## [Download all my content with metadata from a workspace](https://community.bluescape.com/t/download-all-my-content-with-metadata-from-a-workspace/5783)

<div class="topic-metadata">

**Author:** [@spa\_it\_department](https://community.bluescape.com/u/spa_it_department)\
**Replies:** 5\
**Last updated:** [July 22, 2024, 6:14pm UTC](https://community.bluescape.com/t/download-all-my-content-with-metadata-from-a-workspace/5783 "2024-07-22T18:14:13Z")

</div>

Hello, As instructed by support im opening a ticket regarding our intent to download all files and metadata possible from Bluescape. Our project is going to take some time to rise up again and I need to archive this, w…

---

## [Listing Public Workspaces via REST](https://community.bluescape.com/t/listing-public-workspaces-via-rest/5756)

<div class="topic-metadata">

**Author:** [@Will\_Wilson](https://community.bluescape.com/u/Will_Wilson)\
**Replies:** 5\
**Last updated:** [June 26, 2024, 7:18pm UTC](https://community.bluescape.com/t/listing-public-workspaces-via-rest/5756 "2024-06-26T19:18:30Z")

</div>

Hi, Is there a way to list all the public workspaces for an organisation via the REST API? Or, alternately, to list all the workspaces the current user has access to either by ownership, invitiation, or because they ar…

---

## [Oauth.fetch\_token call fails](https://community.bluescape.com/t/oauth-fetch-token-call-fails/5743)

<div class="topic-metadata">

**Author:** [@cody.bentley](https://community.bluescape.com/u/cody.bentley)\
**Replies:** 10\
**Last updated:** [June 14, 2024, 12:45am UTC](https://community.bluescape.com/t/oauth-fetch-token-call-fails/5743 "2024-06-14T00:45:34Z")

</div>

Below is the test authorization code the customer is using, It fails at the oauth.fetch\_token call: import requests from requests\_oauthlib import OAuth2Session from oauthlib.oauth2 import BackendApplicationClient Repl…

---

## [Element Toolbar Power-Ups](https://community.bluescape.com/t/element-toolbar-power-ups/5180)

<div class="topic-metadata">

**Author:** [@kkoechley](https://community.bluescape.com/u/kkoechley)\
**Replies:** 0\
**Last updated:** [November 2, 2023, 7:25pm UTC](https://community.bluescape.com/t/element-toolbar-power-ups/5180 "2023-11-02T19:25:23Z")

</div>

What are Power-Ups? Power-Ups are custom buttons that can be added to an element toolbar to send traits subscription events with an optional payload to a server to handle custom actions. Currently, Power-Ups can only …

---

## [Bluescape Plugin for Rocket.Chat](https://community.bluescape.com/t/bluescape-plugin-for-rocket-chat/5700)

<div class="topic-metadata">

**Author:** [@stefanieo](https://community.bluescape.com/u/stefanieo)\
**Replies:** 0\
**Last updated:** [April 25, 2024, 3:18pm UTC](https://community.bluescape.com/t/bluescape-plugin-for-rocket-chat/5700 "2024-04-25T15:18:20Z")

</div>

Overview The Bluescape plugin for Rocket.Chat allows you to quickly launch Bluescape workspaces directly from Rocket.Chat. It uses a simple slash command /bluescape workspace which will create a new workspace and add a…

---

## [March 2024 API Release Notes](https://community.bluescape.com/t/march-2024-api-release-notes/5596)

<div class="topic-metadata">

**Author:** [@kkoechley](https://community.bluescape.com/u/kkoechley)\
**Replies:** 0\
**Last updated:** [March 8, 2024, 12:28am UTC](https://community.bluescape.com/t/march-2024-api-release-notes/5596 "2024-03-08T00:28:06Z")

</div>

Support Note Release 24.03.1 March 2024 Release Notes New API Changes V2 OAuth endpoints have discontinued. You can use V3 OAuth or you can Migrate your existing V2 OAuth flow to V3 v3 Known Issues RES…

---

## [Workspace background](https://community.bluescape.com/t/workspace-background/5576)

<div class="topic-metadata">

**Author:** [@Amerehei](https://community.bluescape.com/u/Amerehei)\
**Replies:** 3\
**Last updated:** [February 21, 2024, 7:19pm UTC](https://community.bluescape.com/t/workspace-background/5576 "2024-02-21T19:19:57Z")

</div>

I would like to create an empty workspace using GraphQL API. Previously we used copyFrom to clone a template workspace. As our application becomes more complex, we have to dynamically initialize workspaces and I need t…

---

## [Icon customization](https://community.bluescape.com/t/icon-customization/5579)

<div class="topic-metadata">

**Author:** [@Amerehei](https://community.bluescape.com/u/Amerehei)\
**Replies:** 1\
**Last updated:** [February 16, 2024, 9:55pm UTC](https://community.bluescape.com/t/icon-customization/5579 "2024-02-16T21:55:34Z")

</div>

Is there anyway in BS to add some custom SVG icons to the media library? The CreateIconInput accepts assetPath, how to set it as a custom icon?

---

## [How to clone an element?](https://community.bluescape.com/t/how-to-clone-an-element/5574)

<div class="topic-metadata">

**Author:** [@Amerehei](https://community.bluescape.com/u/Amerehei)\
**Replies:** 2\
**Last updated:** [February 13, 2024, 8:26pm UTC](https://community.bluescape.com/t/how-to-clone-an-element/5574 "2024-02-13T20:26:24Z")

</div>

In BS workspace, we can copy and past any elements including documents. It seems when I copy and past a document, BS simply clones it and there is no need to download and re-upload the file. How can I do the same with G…

---

## [Is there an API available to invite users or guest to a workspace? Also can we create a workspace through REST API?](https://community.bluescape.com/t/is-there-an-api-available-to-invite-users-or-guest-to-a-workspace-also-can-we-create-a-workspace-through-rest-api/5514)

<div class="topic-metadata">

**Author:** [@Shamir](https://community.bluescape.com/u/Shamir)\
**Replies:** 4\
**Last updated:** [February 7, 2024, 8:02am UTC](https://community.bluescape.com/t/is-there-an-api-available-to-invite-users-or-guest-to-a-workspace-also-can-we-create-a-workspace-through-rest-api/5514 "2024-02-07T08:02:12Z")

</div>

Is there an API available to invite users or guest to a workspace?

---

## [Detect subscription successfully started](https://community.bluescape.com/t/detect-subscription-successfully-started/5444)

<div class="topic-metadata">

**Author:** [@Amerehei](https://community.bluescape.com/u/Amerehei)\
**Replies:** 1\
**Last updated:** [January 5, 2024, 5:02pm UTC](https://community.bluescape.com/t/detect-subscription-successfully-started/5444 "2024-01-05T17:02:01Z")

</div>

Please read Detect subscription successfully started · enisdenjo/graphql-ws · Discussion #528 · GitHub first In our application it’s not safe to let user to see the page before subscribing to GraphQL events. I would lik…

---

## [Feature Request: Viewport API](https://community.bluescape.com/t/feature-request-viewport-api/5440)

<div class="topic-metadata">

**Author:** [@Amerehei](https://community.bluescape.com/u/Amerehei)\
**Replies:** 3\
**Last updated:** [January 5, 2024, 1:22am UTC](https://community.bluescape.com/t/feature-request-viewport-api/5440 "2024-01-05T01:22:24Z")

</div>

We build our application on top of Bluescape platform and use embedded links to integrate BS workspace in our app using iframes There are some use cases that we need to control workspace viewport. We need to move worksp…

---

## [December 2023 API Release Notes](https://community.bluescape.com/t/december-2023-api-release-notes/5409)

<div class="topic-metadata">

**Author:** [@kkoechley](https://community.bluescape.com/u/kkoechley)\
**Replies:** 0\
**Last updated:** [December 21, 2023, 8:07am UTC](https://community.bluescape.com/t/december-2023-api-release-notes/5409 "2023-12-21T08:07:58Z")

</div>

Support Note Release 23.12.1 December 2023 Release Notes New API Changes Added API support for line label to add text to line element Added PlaceTemplateInput mutation to add template to a workspace v3 …

---

## [How to utilize HistoryCommand.clientId](https://community.bluescape.com/t/how-to-utilize-historycommand-clientid/5389)

<div class="topic-metadata">

**Author:** [@Amerehei](https://community.bluescape.com/u/Amerehei)\
**Replies:** 13\
**Last updated:** [December 21, 2023, 3:06am UTC](https://community.bluescape.com/t/how-to-utilize-historycommand-clientid/5389 "2023-12-21T03:06:13Z")

</div>

When I subscribe to commands and listen to the events, and when I react to events and run mutation, I get command event of the mutation as well I am worry about infinite loop and also some other complexities. I found th…

---

## [Document dimension](https://community.bluescape.com/t/document-dimension/5406)

<div class="topic-metadata">

**Author:** [@Amerehei](https://community.bluescape.com/u/Amerehei)\
**Replies:** 3\
**Last updated:** [December 20, 2023, 9:13pm UTC](https://community.bluescape.com/t/document-dimension/5406 "2023-12-20T21:13:54Z")

</div>

I have a question about width, height, scale, scaleX, scaleY , it’s not obvious for me how exactly BS works, I have faced an unexpected behaviour and I would like to figure out what is the problem When we use createDocu…

---

## [Bluescape User Provisioning Integration using Okta SCIM](https://community.bluescape.com/t/bluescape-user-provisioning-integration-using-okta-scim/4526)

<div class="topic-metadata">

**Author:** [@Scott\_Robinson](https://community.bluescape.com/u/Scott_Robinson)\
**Replies:** 0\
**Last updated:** [September 22, 2023, 11:50pm UTC](https://community.bluescape.com/t/bluescape-user-provisioning-integration-using-okta-scim/4526 "2023-09-22T23:50:02Z")

</div>

Okta’s System for Cross-domain Identity Management (SCIM) provisioning can automatically onboard new users and groups into Bluescape. This topic explains how to set up a SCIM integration with Bluescape. Supported Feat…

---

## [Prevent Bluescape to send email](https://community.bluescape.com/t/prevent-bluescape-to-send-email/5379)

<div class="topic-metadata">

**Author:** [@Amerehei](https://community.bluescape.com/u/Amerehei)\
**Replies:** 1\
**Last updated:** [December 6, 2023, 6:31pm UTC](https://community.bluescape.com/t/prevent-bluescape-to-send-email/5379 "2023-12-06T18:31:32Z")

</div>

Is it possible to disable BS emails? For example when we add a user to a workspace by a Bot we don’t like Bluescape to send email to our users

---

## [Embedded iframe in Safari](https://community.bluescape.com/t/embedded-iframe-in-safari/5272)

<div class="topic-metadata">

**Author:** [@Amerehei](https://community.bluescape.com/u/Amerehei)\
**Replies:** 5\
**Last updated:** [November 29, 2023, 6:46pm UTC](https://community.bluescape.com/t/embedded-iframe-in-safari/5272 "2023-11-29T18:46:39Z")

</div>

I have followed Embedding Bluescape to embed Bluescape workspace using an iframe In Chrome it works well. In Safari, the behaviour is strange. I can see the loading logo of Bluescape then the page become white (If it’s…

---

## [Graphql subscription is not reliable](https://community.bluescape.com/t/graphql-subscription-is-not-reliable/4821)

<div class="topic-metadata">

**Author:** [@Amerehei](https://community.bluescape.com/u/Amerehei)\
**Replies:** 21\
**Last updated:** [November 14, 2023, 5:04pm UTC](https://community.bluescape.com/t/graphql-subscription-is-not-reliable/4821 "2023-11-14T17:04:00Z")

</div>

While I working with Bluescape Graphql subscription I figured out that sometimes the events comes blazing fast and sometimes it takes seconds to get the events. Some other times no matter how long I wait for the event, I…

---

## [November 2023 API Release Notes](https://community.bluescape.com/t/november-2023-api-release-notes/5259)

<div class="topic-metadata">

**Author:** [@kkoechley](https://community.bluescape.com/u/kkoechley)\
**Replies:** 0\
**Last updated:** [November 10, 2023, 12:39am UTC](https://community.bluescape.com/t/november-2023-api-release-notes/5259 "2023-11-10T00:39:48Z")

</div>

Support Note Release 23.11.1 November 2023 Release Notes New API Changes Added API beta support for 3D Objects element query/mutation Fix for graphQL gateway to improve overall API performance v3 Known …

---

## [Getting Started with Bluescape AI](https://community.bluescape.com/t/getting-started-with-bluescape-ai/5168)

<div class="topic-metadata">

**Author:** [@Shayan\_Memarzadeh](https://community.bluescape.com/u/Shayan_Memarzadeh)\
**Replies:** 0\
**Last updated:** [November 1, 2023, 5:41pm UTC](https://community.bluescape.com/t/getting-started-with-bluescape-ai/5168 "2023-11-01T17:41:56Z")

</div>

What is Bluescape AI? Bluescape AI is a platform that can be used to seamlessly consolidate complex, multi-step workflows and diverse applications into a unified, secure, and collaborative hub for generative AI innovatio…

---

## [Error handling in Bluescape](https://community.bluescape.com/t/error-handling-in-bluescape/5141)

<div class="topic-metadata">

**Author:** [@Amerehei](https://community.bluescape.com/u/Amerehei)\
**Replies:** 5\
**Last updated:** [November 7, 2023, 8:59pm UTC](https://community.bluescape.com/t/error-handling-in-bluescape/5141 "2023-11-07T20:59:28Z")

</div>

I would like to know what is the proper way to handle error of GraphQL. I have sent my request via ApolloClient in TS with an invalid access token to rise an error The HTTP status code is 200 OK and the response is { …

[Next page](https://community.bluescape.com/c/developer/14.md?page=1)
