Skip to content

Workspace

An AskAnna workspace is the place where you can collaborate on your data science projects. A workspace can be used by an organization, a team or even an individual person. Within a workspace you can find your projects. Also you can manage the people active in the workspace or other workspace admin related tasks.

Workspace

In a workspace you can find all active projects that are linked to the workspace. Projects are listed as cards showing the project name and a description of the project. When you click on a card, the project page opens. If you click on on a project card, you find additional options for the project.

Besides viewing all workspace projects, you can do more. In the gray bar you can:

  • see the name of the workspace
  • create a project
  • : shows that no search or filter options are active. Click on it to open/hide the search, filter and sort options.
  • : shows that a search or filter is active. Click on it to open/hide the search, filter and sort options.
  • : get more workspace options

On top of the screen you can find the AskAnna menu bar. When you click on the AskAnna logo, you will go back to the workspace "home" page.

If you click on workspaces or projects a menu will open. In this menu you can see all workspaces/projects you have access too. Additionally you can explore public workspaces and projects. Click on a workspace or project to open it.

On the right side you see two options. The first is a status option. In the current version you can find here the status of uploading files to AskAnna. The second option is another menu with a link to edit your profile, sign out and a reference to the documentation.

Workspace members

In the gray workspace bar click on and click on People. On the people page, you can see members active in the workspace. With workspace members you can collaborate on your projects.

People page

Roles

Within AskAnna we have three workspace roles:

  1. Workspace admin
  2. Workspace member
  3. Workspace viewer

On the page permissions and roles, you can find more information about what each role can do.

Invite people

When you click on invite more people, you will get a form where you can enter the email addresses of the people you want to invite. Also, you can select the role the invited person(s) should get. By default you invite people with the role Workspace member.

Invite people

When you are done entering email addresses, you can send the invites. They will receive an email with instructions on how to join and a unique link to join your workspace. They can use an existing account, or create a new account to join your workspace.

If you entered the email addresses of existing members, you cannot invite them a second time. You will see an error message. You can click on the error button to remove them. Also, if you entered an invalid email address, you could use the related button to remove them.

Filter & sort

It's possible to sort the list or the filter on account type or status.

Filter and sort People

Workspace visibility

The workspace visibility can be set to Private or Public. In Edit workspace info and settings you can find how to change this setting.

Private

By default workspace visibility is set to Private. When the workspace visibility is set to private, this means that only workspace members can open the workspace and projects within this workspace.

Public

You can also set the workspace visiblity to Public. This means that the workspace name and description becomes visible for everyone, also people without an account in AskAnna.

Additional, if the workspace visibility is set to Public, you can also make projects publicly visible. By doing this you can open your project and share it with the world.

Create a workspace

You can create an AskAnna workspace via the web interface and API. For every method, the workspace information in the table below is relevant when creating a workspace:

Attribute Required Description
Name Yes The name of the workspace
Description No A description of the workspace
Visibility No By default the visibility is PRIVATE, it could also be set to PUBLIC

Web interface

You can create a workspace via the menu WORKSPACES or by going to the explore workspaces page and click on + CREATE WORKSPACE. You can fill in a workspace name which will directly create the workspace or you can choose for MORE OPTIONS where you can also fill in the workspace description and visiblity.

Create workspace

Command line (CLI)

With the AskAnna CLI you can create a new workspace info with your command line. In your terminal run:

askanna workspace create

askanna workspace create --name "WORKSPACE NAME"

For all options, check the help: askanna workspace create --help

API

An authenticated user can POST a request for creating a new workspace via:

POST https://beta-api.askanna.eu/v1/workspace/

The JSON body should contain at least the workspace name:

{
    "name": "Workspace name",
    "description": "Workspace description (optional)",
    "visibility": "PRIVATE",  # (or "PUBLIC")
}

If creating a workspace via the post was successful, AskAnna will respond with an HTTP-code 201 and will give back the workspace information.

Edit workspace info and settings

Via the web interface or AskAnna CLI, you can edit the information and settings of the workspace. Although you can provide a description of the workspace, we don't display this information at the moment.

Web interface

On the workspace home you can click on . In this menu select Edit workspace and you can update the workspace info and settings.

Edit workspace

Markdown support

The text editor support Markdown instructions. These instructions will automatically transferred into formatted text.

Command line (CLI)

With the AskAnna CLI you can change the workspace info with your command line. In your terminal run:

askanna workspace change

Optionally, you can also directly provide the info you want to change:

askanna workspace change --id "WORKSPACE SUUID" --name "New name"

API

An authenticated user can PATCH a workspace via:

PATCH https://beta-api.askanna.eu/v1/workspace/{workspace_suuid}/

The JSON body should contain the fields you want to update:

{
    "name": "Workspace name",
    "description": "Workspace description (optional)",
    "visibility": "PRIVATE",  # (or "PUBLIC")
}

If creating a workspace via the patch was successful, AskAnna will respond with an HTTP-code 200 and will give back the new workspace information.

Remove a workspace

When you remove a workspace, this it what happens:

  • all data related to the AskAnna workspace will be removed
  • if other workspaces in AskAnna or external systems use projects, jobs, files or other parts of the AskAnna workspace, they are not able to use it anymore

Recovery period of 30 days

When you remove a workspace, you will not have access to the workspace anymore. After 30 days, the system will entirely delete the workspace from the backend. Within 30 days, you can contact us if you want to undo the removal.

If the workspace and related files should be removed as soon as possible, you can contact us.

Web interface

In the web interface you can remove a workspace via the workspace home page or on the workspace list. Click on at the right side of the page or card. Then click on Remove workspace.

Command line (CLI)

With the AskAnna CLI you can remove a workspace on the command line. In your terminal run:

askanna workspace remove --id "WORKSPACE SUUID"

API

An authenticated user can DELETE a workspace via:

DELETE https://beta-api.askanna.eu/v1/workspace/{workspace_suuid}/

If deleting a workspace was successful, AskAnna will respond with an HTTP-code 204.