Skip to content

Latest commit

 

History

History
executable file
·
96 lines (63 loc) · 3.88 KB

WorkspaceApi.md

File metadata and controls

executable file
·
96 lines (63 loc) · 3.88 KB
Raw

LookerApi31Reference.WorkspaceApi

All URIs are relative to /api/3.1

Method HTTP request Description
allWorkspaces GET /workspaces Get All Workspaces
workspace GET /workspaces/{workspace_id} Get Workspace

allWorkspaces

[Workspace] allWorkspaces()

Get All Workspaces

Get All Workspaces Returns all workspaces available to the calling user.

Example

var LookerApi31Reference = require('looker-node-api');

var apiInstance = new LookerApi31Reference.WorkspaceApi();

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
apiInstance.allWorkspaces(callback);

Parameters

This endpoint does not need any parameter.

Return type

[Workspace]

Authorization

No authorization required

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

workspace

Workspace workspace(workspaceId)

Get Workspace

Get A Workspace Returns information about a workspace such as the git status and selected branches of all projects available to the caller's user account. A workspace defines which versions of project files will be used to evaluate expressions and operations that use model definitions - operations such as running queries or rendering dashboards. Each project has its own git repository, and each project in a workspace may be configured to reference particular branch or revision within their respective repositories. There are two predefined workspaces available: "production" and "dev". The production workspace is shared across all Looker users. Models in the production workspace are read-only. Changing files in production is accomplished by modifying files in a git branch and using Pull Requests to merge the changes from the dev branch into the production branch, and then telling Looker to sync with production. The dev workspace is local to each Looker user. Changes made to project/model files in the dev workspace only affect that user, and only when the dev workspace is selected as the active workspace for the API session. (See set_session_workspace()). The dev workspace is NOT unique to an API session. Two applications accessing the Looker API using the same user account will see the same files in the dev workspace. To avoid collisions between API clients it's best to have each client login with API3 credentials for a different user account. Changes made to files in a dev workspace are persistent across API sessions. It's a good idea to commit any changes you've made to the git repository, but not strictly required. Your modified files reside in a special user-specific directory on the Looker server and will still be there when you login in again later and use update_session(workspace_id: "dev") to select the dev workspace for the new API session.

Example

var LookerApi31Reference = require('looker-node-api');

var apiInstance = new LookerApi31Reference.WorkspaceApi();

var workspaceId = "workspaceId_example"; // String | Id of the workspace


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
apiInstance.workspace(workspaceId, callback);

Parameters

Name Type Description Notes
workspaceId String Id of the workspace

Return type

Workspace

Authorization

No authorization required

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json