A Python API for Valispace
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
.gitignore Post and Get function with type argument (#3) Dec 28, 2017


Valispace Python API

The Valispace python API lets you access and update objects in your Valispace deployment.

Getting Started

To make use of the Valispace API you must have a valid login to any Valispace deployment. If you don't have an account, you can get a demo account at demo.valispace.com. You can also find further documentation in docs.valispace.com.


Install the Valispace python API with pip:

pip install valispace

Import the API

Import valispace API module in a python script:

import valispace

And initialize with:

valispace = valispace.API()

At this step you will need to enter your Valispace url (e.g. https://demo.valispace.com), username and password for authentication, or use the one line function:

valispace = valispace.API(url='https://demo.valispace.com', username='your_user_name', password='******')

Then use the Valispace API like this:


A dict of Valis:

valis = valispace.get_vali_list()

All Vali ids and names:

all_vali_names = valispace.get_vali_names()

A Vali with all properties:

Argument Example
id valispace.get_vali(id=1)
unique_name valispace.get_vali_by_name(vali_name='Blade', project_name='Fan')

A matrix:

matrix = valispace.get_matrix(id=57)

or a condensed version with only Vali ids and values:

matrix = valispace.get_matrix_str(id=57)

A Component with all properties:

Argument Example
id valispace.get_component(id=1)
unique_name valispace.get_component_by_name(unique_name='Fan.Blade', project_name='Fan')

A Project with all properties:

Argument Example
id valispace.get_project(id=1)
name valispace.get_project_by_name(name='Fan')


List of Valis with the specified arguments:

Argument Example
workspace_id valispace.get_vali_list(workspace_id=1)
workspace_name valispace.get_vali_list(workspace_name='Default Workspace')
project_id valispace.get_vali_list(project_id=1)
project_name valispace.get_vali_list(project_name='Saturn_V')
parent_id valispace.get_vali_list(parent_id=1)
parent_name valispace.get_vali_list(parent_name='Fan')
tag_id valispace.get_vali_list(tag_id=10)
tag_name valispace.get_vali_list(tag_id='example_tag')
vali_marked_as_impacted valispace.get_vali_list(vali_marked_as_impacted='10')

List of Components with the specified arguments:

Argument Example
workspace_id valispace.get_component_list(workspace_id=1)
workspace_name valispace.get_component_list(workspace_name='Default Workspace')
project_id valispace.get_component_list(project_id=1)
project_name valispace.get_component_list(project_name='Fan')
parent_id valispace.get_component_list(parent_id=1)
parent_name valispace.get_component_list(parent_name='Fan')
tag_id valispace.get_component_list(tag_id=10)
tag_name valispace.get_component_list(tag_name='example_tag')

List of Projects with the specified arguments:

Argument Example
workspace_id valispace.get_project_list(workspace_id=1)
workspace_name valispace.get_project_list(workspace_name='Default Workspace')


A Vali formula:

valispace.update_vali(id=50, formula=str(value + 1))

A matrix:

valispace.update_matrix_formulas(id=57, matrix_formula=[[2.1], [0.0], [0.0]])

Creating a dataset:

vali_id = 1

data = [
    [1, 2],
    [3, 4],
    [5, 6],

valispace.create_dataset_and_set_values(vali_id, data)


valispace.post_data(type='vali', data=json_object)

The input data should be a single JSON object. Check the examples:

import valispace
valispace = valispace.API()

# -- Insert new Component --
valispace.post_data(type='component', data="""{
        "name": "component_name",
        "description": "Insert description here",
        "parent": null,
        "project": 25,
        "tags": [30, 31, 32]

# -- Insert new Vali --
valispace.post_data(type='vali', data="""{
        "parent": 438,
        "shortname": "mass",
        "description": "",
        "unit": "kg",
        "formula": "5",
        "minimum": null,
        "maximum": null,
        "margin_minus": "0",
        "margin_plus": "0",
        "uses_default_formula": false,
        "reference": "",
        "type": null

# -- Insert new Textvali --
valispace.post_data(type='textvali', data="""{
        "shortname": "Message",
        "text": "Message text",
        "parent": 438

# -- Insert new Tag --
valispace.post_data(type='tag', data="""{
        "name": "white-tag",
        "color": "#FFFFFF"


  • The "name" fields should never be repeated, this will result in a error in the REST API.
  • The "valis" are automatically updated when new valis with this componenet id are inserted


You can make any custom requests not covered by a specific method using request.

Argument Example
method 'GET', 'POST', 'DELETE'
url 'vali/1
data (optional) {"name": "example"}
    v = valispace.API('http://demo.valispace.com/', 'user', 'pass')
    projects = v.request('GET', 'project/')

As a shortcut if the REST method is GET you can use the get(url, data) function, or if it's a POST request use post(url, data).


  • Valispace

See also the list of contributors who participated in this project.


This project is licensed under the MIT License - see the LICENSE file for details.