Civis API Python Client

The Civis API Python client is a Python package that helps analysts and developers interact with the Civis Platform. The package includes a set of tools around common workflows as well as a convenient interface to make requests directly to the Civis API.

Installation

The recommended install method is pip:

pip install civis

Alternatively, you may clone the code from github and build from source:

git clone https://github.com/civisanalytics/civis-python.git
cd civis-python
python setup.py install

The client has a soft dependency on pandas to support features such as data type parsing. If you are using the io namespace to read or write data from Civis, it is highly recommended that you install pandas and set use_pandas=True in functions that accept that parameter. To install pandas:

pip install pandas

Machine learning features in the ml namespace have a soft dependency on scikit-learn, joblib, and pandas. Install scikit-learn and joblib to export your trained models from the Civis Platform or to provide your own custom models. Use pandas to download model predictions from the Civis Platform. Install these dependencies with

pip install scikit-learn
pip install joblib
pip install pandas

Python version support

Python 2.7, 3.4, 3.5, and 3.6

Authentication

In order to make requests to the Civis API, you will need an API key that is unique to you. Instructions for creating a new key are found here: https://civis.zendesk.com/hc/en-us/articles/216341583-Generating-an-API-Key. By default, the Python client will look for your key in the environment variable CIVIS_API_KEY. To add the API key to your environment, copy the key you generated to your clipboard and follow the instructions below for your operating system.

Mac

Open .bash_profile in TextEdit:

cd ~/
touch .bash_profile
open -e .bash_profile

Then add the following line, replacing api_key_here with your key:

export CIVIS_API_KEY="api_key_here"

Linux

Open .bash_profile in your favorite editor (nano is used here):

cd ~/
nano .bash_profile

Then add the following line, replacing api_key_here with your key:

export CIVIS_API_KEY="api_key_here"

User Guide

For a more detailed walkthrough, see the User Guide.

Client API Reference

User Guide

Getting Started

After installing the Civis API Python client and setting up your API key, you can now import the package civis:

>>> import civis

There are two entrypoints for working with the Civis API. The first is the civis namespace, which contains tools for typical workflows in a user friendly manner. For example, you may want to perform some transformation on your data in Python that might be tricky to code in SQL. This code downloads data from Civis, calculates the correlation between all the columns and then uploads the data back into Civis:

>>> df = civis.io.read_civis(table="my_schema.my_table",
...                          database="database",
...                          use_pandas=True)
>>> correlation_matrix = df.corr()
>>> correlation_matrix["corr_var"] = correlation_matrix.index
>>> fut = civis.io.dataframe_to_civis(df=correlation_matrix,
...                                   database="database",
...                                   table="my_schema.my_correlations")
>>> fut.result()

Civis Futures

In the code above, dataframe_to_civis() returns a special CivisFuture object. Making a request to the Civis API usually results in a long running job. To account for this, various functions in the civis namespace return a CivisFuture to allow you to process multiple long running jobs simultaneously. For instance, you may want to start many jobs in parallel and wait for them all to finish rather than wait for each job to finish before starting the next one.

The CivisFuture follows the concurrent.futures.Future API fairly closely. For example, calling result() on fut above forces the program to wait for the job started with dataframe_to_civis() to finish and returns the result.

Working Directly with the Client

Although many common workflows are included in the Civis API Python client, projects often require direct calls to the Civis API. For convenience, the Civis API Python client implements an APIClient object to make these API calls with Python syntax rather than a manually crafted HTTP request. To make a call, first instantiate an APIClient object:

>>> client = civis.APIClient()

Note

Creating an instance of APIClient makes an HTTP request to determine the functions to attach to the object. You must have an API key and internet connection to create an APIClient object. By default, the functions attached to the object come from a base set of Civis API endpoints. Based on your user profile, you may have access to a set of developmental endpoints. To access these, instantiate the client with client = civis.APIClient(resources='all').

With the client object instantiated, you can now make API requests like listing your user information:

>>> client.users.list_me()
{'email': 'user@email.com',
 'feature_flags': {'left_nav_basic': True,
                   'results': True,
                   'scripts_notify': True,
                   'table_person_matching': True},
 'id': 1,
 'initials': 'UN',
 'name': 'User Name',
 'username': 'uname'}

Suppose we did not have the civis.io namespace. This is how we might export a CSV file from Civis. As you will see, this can be quite involved and the civis namespace entrypoint should be preferred whenever possible.

First, we get the ID for our database then we get the default credential for the current user.

>>> db_id = client.get_database_id('cluster-name')
>>> cred_id = client.default_credential

In order to export a table, we need to write some SQL that will generate the data to export. Then we create the export job and run it.

>>> generate_table = "select * from schema.tablename"
>>> export_job = client.scripts.post_sql(name="our export job",
                                         remote_host_id=db_id,
                                         credential_id=cred_id,
                                         sql=generate_table)
>>> export_run = client.scripts.post_sql_runs(export_job.id)

We can then poll and wait for the export to be completed.

>>> import time
>>> export_state = client.scripts.get_sql_runs(export_job.id,
...                                            export_run.id)
>>> while export_state.state in ['queued', 'running']:
...    time.sleep(60)
...    export_state = client.scripts.get_sql_runs(export_job.id,
...                                               export_run.id)

Now, we can get the URL of the exported csv. First, we grab the result of our export job.

>>> export_result = client.scripts.get_sql_runs(export_job.id,
...                                             export_run.id)

In the future, a script may export multiple jobs, so the output of this is a list.

The path returned will have a gzipped csv file, which we could load, for example, with pandas.

>>> url = export_result.output[0].path

Data Import and Export

The civis.io namespace provides several functions for moving data in and out of Civis.

Tables

Often, your data will be in structured format like a table in a relational database, a CSV or a dataframe. The following functions handle moving structured data to and from Civis. When using these functions, it is recommended to have pandas installed and to pass use_pandas=True in the appropriate functions. If pandas is not installed, data returned from Civis will all be treated as strings.

civis_to_csv(filename, sql, database[, ...]) Export data from Civis to a local CSV file.
csv_to_civis(filename, database, table[, ...]) Upload the contents of a local CSV file to Civis.
dataframe_to_civis(df, database, table[, ...]) Upload a pandas DataFrame into a Civis table.
read_civis(table, database[, columns, ...]) Read data from a Civis table.
read_civis_sql(sql, database[, use_pandas, ...]) Read data from Civis using a custom SQL string.

Files

These functions will pass flat files to and from Civis. This is useful if you have data stored in binary or JSON format. Any type of file can be stored in platform via the files endpoint.

civis_to_file(file_id, buf[, api_key, client]) Download a file from Civis.
file_to_civis(buf, name[, api_key, client]) Upload a file to Civis.

Databases

These functions move data from one database to another and expose an interface to run SQL in the database. Use query_civis() when you need to execute SQL that does not return data (for example, a GRANT or DROP TABLE statement).

transfer_table(source_db, dest_db, ...[, ...]) Transfer a table from one location to another.
query_civis(sql, database[, api_key, ...]) Execute a SQL statement as a Civis query.

Machine Learning

CivisML uses the Civis Platform to train machine learning models and parallelize their predictions over large datasets. It contains best-practice models for general-purpose classification and regression modeling as well as model quality evaluations and visualizations. All CivisML models use scikit-learn for interoperability with other platforms and to allow you to leverage resources in the open-source software community when creating machine learning models.

Define Your Model

Start the modeling process by defining your model. Do this by creating an instance of the ModelPipeline class. Each ModelPipeline corresponds to a scikit-learn Pipeline which will run in Civis Platform. A Pipeline allows you to combine multiple modeling steps (such as missing value imputation and feature selection) into a single model. The Pipeline is treated as a unit – for example, cross-validation happens over all steps together.

You can define your model in two ways, either by selecting a pre-defined algorithm or by providing your own scikit-learn Pipeline or BaseEstimator object. Note that whichever option you chose, CivisML will pre-process your data to one-hot-encode categorical features (the non-numerical columns) to binary indicator columns before sending the features to the Pipeline.

Pre-Defined Models

You can use the following pre-defined models with CivisML. All models start by imputing missing values with the mean of non-null values in a column. The “sparse_*” models include a LASSO regression step (using the glmnet package) to do feature selection before passing data to the final model. In some models, CivisML uses default parameters different from those in scikit-learn, as indicated in the “Altered Defaults” column. All models also have random_state=42.

Name Model Type Algorithm Altered Defaults
sparse_logistic classification LogisticRegression C=499999950, tol=1e-08
gradient_boosting_classifier classification GradientBoostingClassifier n_estimators=500, max_depth=2
random_forest_classifier classification RandomForestClassifier n_estimators=500
extra_trees_classifier classification ExtraTreesClassifier n_estimators=500
sparse_linear_regressor regression LinearRegression  
sparse_ridge_regressor regression Ridge  
gradient_boosting_regressor regression GradientBoostingRegressor n_estimators=500, max_depth=2
random_forest_regressor regression RandomForestRegressor n_estimators=500
extra_trees_regressor regression ExtraTreesRegressor n_estimators=500
Custom Models

You can create your own Pipeline instead of using one of the pre-defined ones. Create the object and pass it as the model parameter of the ModelPipeline. Your model must be built from libraries which CivisML recognizes. You can use code from

When you’re assembling your own model, remember that you’ll have to make certain that either you add a missing value imputation step or that your data doesn’t have any missing values. If you’re making a classification model, the model must have a predict_proba method. If the class you’re using doesn’t have a predict_proba method, you can add one by wrapping it in a CalibratedClassifierCV.

Asynchronous Execution

All calls to a ModelPipeline object are non-blocking, i.e. they immediately provide a result without waiting for the job in the Civis Platform to complete. Calls to civis.ml.ModelPipeline.train() and civis.ml.ModelPipeline.predict() return a ModelFuture object, which is a subclass of Future from the Python standard library. This behavior lets you train multiple models at once, or generate predictions from models, while still doing other work while waiting for your jobs to complete.

The ModelFuture can find and retrieve outputs from your CivisML jobs, such as trained Pipeline objects or out-of-sample predictions. The ModelFuture only downloads outputs when you request them.

Model Persistence

Civis Platform permanently stores all models, indexed by the job ID and the run ID (also called a “build”) of the training job. If you wish to use an existing model, call civis.ml.ModelPipeline.from_existing() with the job ID of the training job. You can find the job ID with the train_job_id attribute of a ModelFuture, or by looking at the URL of your model on the Civis Platform models page. If the training job has multiple runs, you may also provide a run ID to select a run other than the most recent. You can list all model runs of a training job by calling civis.APIClient().jobs.get(train_job_id)['runs']. You may also store the ModelPipeline itself with the pickle module.

Examples

Future objects have the method add_done_callback(). This is called as soon as the run completes. It takes a single argument, the Future for the completed job. You can use this method to chain jobs together:

from concurrent import futures
from civis.ml import ModelPipeline
import pandas as pd
df = pd.read_csv('data.csv')
training, predictions = [], []
model = ModelPipeline('sparse_logistic', dependent_variable='type')
training.append(model.train(df))
training[-1].add_done_callback(lambda fut: predictions.append(model.predict(df)))
futures.wait(training)  # Blocks until all training jobs complete
futures.wait(predictions)  # Blocks until all prediction jobs complete

You can create and train multiple models at once to find the best approach for solving a problem. For example:

from civis.ml import ModelPipeline
algorithms = ['gradient_boosting_classifier', 'sparse_logistic', 'random_forest_classifier']
pkey = 'person_id'
depvar = 'likes_cats'
models = [ModelPipeline(alg, primary_key=pkey, dependent_variable=depvar) for alg in algorithms]
train = [model.train(table_name='schema.name', database_name='My DB') for model in models]
aucs = [tr.metrics['roc_auc'] for tr in train]  # Code blocks here

Optional dependencies

You do not need any external libraries installed to use CivisML, but the following pip-installable dependencies enhance the capabilities of the ModelPipeline:

  • pandas
  • scikit-learn
  • joblib
  • glmnet
  • pubnub

Install pandas if you wish to download tables of predictions. You can also model on DataFrame objects in your interpreter.

If you wish to use custom models or download trained models, you’ll need scikit-learn installed.

We use the joblib library to move scikit-learn models back and forth from Platform. Install it if you wish to use custom models or download trained models.

The “sparse_logistic”, “sparse_linear_regressor”, and “sparse_ridge_regressor” models all use the public Civis Analytics glmnet library. Install it if you wish to download a model created from one of these pre-defined models.

If you install pubnub, the Civis Platform API client can use the notifications endpoint instead of polling for job completion. This gives faster results and uses fewer API calls.

Object reference

class civis.ml.ModelPipeline(model, dependent_variable, primary_key=None, parameters=None, cross_validation_parameters=None, model_name=None, calibration=None, excluded_columns=None, client=None, cpu_requested=None, memory_requested=None, disk_requested=None, verbose=False)[source]

Interface for scikit-learn modeling in the Civis Platform

Each ModelPipeline corresponds to a scikit-learn Pipeline which will run in Civis Platform.

Parameters:

model : string or Estimator

Either the name of a pre-defined model (e.g. “sparse_logistic” or “gradient_boosting_classifier”) or else a pre-existing Estimator object.

dependent_variable : string or List[str]

The dependent variable of the training dataset. For a multi-target problem, this should be a list of column names of dependent variables.

primary_key : string, optional

The unique ID (primary key) of the training dataset. This will be used to index the out-of-sample scores.

parameters : dict, optional

Specify parameters for the final stage estimator in a predefined model, e.g. {'C': 2} for a “sparse_logistic” model.

cross_validation_parameters : dict, optional

Cross validation parameter grid for learner parameters, e.g. {{'n_estimators': [100, 200, 500], 'learning_rate': [0.01, 0.1], 'max_depth': [2, 3]}}.

model_name : string, optional

The prefix of the Platform modeling jobs. It will have ” Train” or ” Predict” added to become the Script title.

calibration : {None, “sigmoid”, “isotonic”}

If not None, calibrate output probabilities with the selected method. Valid only with classification models.

excluded_columns : array, optional

A list of columns which will be considered ineligible to be independent variables.

client : APIClient, optional

If not provided, an APIClient object will be created from the CIVIS_API_KEY.

cpu_requested : int, optional

Number of CPU shares requested in the Civis Platform for training jobs. 1024 shares = 1 CPU.

memory_requested : int, optional

Memory requested from Civis Platform for training jobs, in MiB

disk_requested : float, optional

Disk space requested on Civis Platform for training jobs, in GB

verbose : bool, optional

If True, supply debug outputs in Platform logs and make prediction child jobs visible.

See also

civis.ml.ModelFuture

Examples

>>> from civis.ml import ModelPipeline
>>> model = ModelPipeline('gradient_boosting_classifier', 'depvar',
...                       primary_key='voterbase_id')
>>> train = model.train(table_name='schema.survey_data',
...                     fit_params={'sample_weight': 'survey_weight'},
...                     database_name='My Redshift Cluster',
...                     oos_scores='scratch.survey_depvar_oos_scores')
>>> train
<ModelFuture at 0x11be7ae10 state=queued>
>>> train.running()
True
>>> train.done()
False
>>> df = train.table  # Read OOS scores from its Civis File. Blocking.
>>> meta = train.metadata  # Metadata from training run
>>> train.metrics['roc_auc']
0.88425
>>> pred = model.predict(table_name='schema.demographics_table ',
...                      database_name='My Redshift Cluster',
...                      output_table='schema.predicted_survey_response',
...                      if_exists='drop',
...                      n_jobs=50)
>>> df_pred = pred.table  # Blocks until finished
# Modify the parameters of the base estimator in a default model:
>>> model = ModelPipeline('sparse_logistic', 'depvar',
...                       primary_key='voterbase_id',
...                       parameters={'C': 2})
# Grid search over hyperparameters in the base estimator:
>>> model = ModelPipeline('sparse_logistic', 'depvar',
...                       primary_key='voterbase_id',
...                       cross_validation_parameters={'C': [0.1, 1, 10]})

Attributes

estimator (Pipeline) The trained scikit-learn Pipeline
train_result_ (ModelFuture) ModelFuture encapsulating this model’s training run
state (str) Status of the training job (non-blocking)

Methods

train() Train the model on data in Civis Platform; outputs ModelFuture
predict() Make predictions on new data; outputs ModelFuture
from_existing() Class method; use to create a ModelPipeline from an existing model training run
classmethod from_existing(train_job_id, train_run_id='latest', client=None)[source]

Create a ModelPipeline object from existing model IDs

Parameters:

train_job_id : int

The ID of the CivisML job in the Civis Platform

train_run_id : int or string, optional

Location of the model run, either

  • an explicit run ID,
  • “latest” : The most recent run
  • “active” : The run designated by the training job’s “active build” parameter

client : APIClient, optional

If not provided, an APIClient object will be created from the CIVIS_API_KEY.
Returns:

ModelPipeline

A ModelPipeline which refers to a previously-trained model

Examples

>>> from civis.ml import ModelPipeline
>>> model = ModelPipeline.from_existing(job_id)
>>> model.train_result_.metrics['roc_auc']
0.843
predict(df=None, csv_path=None, table_name=None, database_name=None, manifest=None, file_id=None, sql_where=None, sql_limit=None, primary_key=Sentinel(), output_table=None, output_db=None, if_exists='fail', n_jobs=None, polling_interval=None)[source]

Make predictions on a trained model

Provide input through one of a DataFrame (df), a local CSV (csv_path), a Civis Table (table_name and database_name), a Civis File containing a CSV (file_id), or a Civis File containing a manifest file (manifest).

A “manifest file” is JSON which specifies the location of many shards of the data to be used for prediction. A manifest file is the output of a Civis export job with force_multifile=True set, e.g. from civis.io.civis_to_multifile_csv(). Large Civis Tables (provided using table_name) will automatically be exported to manifest files.

Prediction outputs will always be stored as gzipped CSVs in one or more Civis Files. You can find a list of File ID numbers for output files at the “output_file_ids” key in the metadata returned by the prediction job. Provide an output_table (and optionally an output_db, if it’s different from database_name) to copy these predictions into a Civis Table.

Parameters:

df : pd.DataFrame, optional

A DataFrame of data for prediction. The DataFrame will be uploaded to a Civis file so that CivisML can access it. Note that the index of the DataFrame will be ignored – use df.reset_index() if you want your index column to be included with the data passed to CivisML.

csv_path : str, optional

The location of a CSV of data on the local disk. It will be uploaded to a Civis file.

table_name : str, optional

The qualified name of the table containing your data

database_name : str, optional

Name of the database holding the data, e.g., ‘My Redshift Cluster’.

manifest : int, optional

ID for a manifest file stored as a Civis file. (Note: if the manifest is not a Civis Platform-specific manifest, like the one returned from civis.io.civis_to_multfile_csv(), this must be used in conjunction with table_name and database_name due to the need for column discovery via Redshift.)

file_id : int, optional

If the data are a CSV stored in a Civis file, provide the integer file ID.

sql_where : str, optional

A SQL WHERE clause used to scope the rows to be predicted

sql_limit : int, optional

SQL LIMIT clause to restrict the size of the prediction set

primary_key : str, optional

Primary key of the prediction table. Defaults to the primary key of the training data. Use None to indicate that the prediction data don’t have a primary key column.

output_table: str, optional

The table in which to put the predictions.

output_db : str, optional

Database of the output table. Defaults to the database of the input table.

if_exists : {‘fail’, ‘append’, ‘drop’, ‘truncate’}

Action to take if the prediction table already exists.

n_jobs : int, optional

Number of concurrent Platform jobs to use for multi-file / large table prediction.

polling_interval : float, optional

Check for job completion every this number of seconds. Do not set if using the notifications endpoint.
Returns:

ModelFuture
train(df=None, csv_path=None, table_name=None, database_name=None, file_id=None, sql_where=None, sql_limit=None, oos_scores=None, oos_scores_db=None, if_exists='fail', fit_params=None, polling_interval=None)[source]

Start a Civis Platform job to train your model

Provide input through one of a DataFrame (df), a local CSV (csv_path), a Civis Table (table_name and database_name), or a Civis File containing a CSV (file_id).

Model outputs will always contain out-of-sample scores (accessible through ModelFuture.table on this function’s output), and you may chose to store these out-of-sample scores in a Civis Table with the oos_scores, oos_scores_db, and if_exists parameters.

Parameters:

df : pd.DataFrame, optional

A DataFrame of training data. The DataFrame will be uploaded to a Civis file so that CivisML can access it. Note that the index of the DataFrame will be ignored – use df.reset_index() if you want your index column to be included with the data passed to CivisML.

csv_path : str, optional

The location of a CSV of data on the local disk. It will be uploaded to a Civis file.

table_name : str, optional

The qualified name of the table containing the training set from which to build the model.

database_name : str, optional

Name of the database holding the training set table used to build the model. E.g., ‘My Cluster Name’.

file_id : int, optional

If the training data are stored in a Civis file, provide the integer file ID.

sql_where : str, optional

A SQL WHERE clause used to scope the rows of the training set (used for table input only)

sql_limit : int, optional

SQL LIMIT clause for querying the training set (used for table input only)

oos_scores : str, optional

If provided, store out-of-sample predictions on training set data to this Redshift “schema.tablename”.

oos_scores_db : str, optional

If not provided, store OOS predictions in the same database which holds the training data.

if_exists : {‘fail’, ‘append’, ‘drop’, ‘truncate’}

Action to take if the out-of-sample prediction table already exists.

fit_params: Dict[str, str]

Mapping from parameter names in the model’s fit method to the column names which hold the data, e.g. {'sample_weight': 'survey_weight_column'}.

polling_interval : float, optional

Check for job completion every this number of seconds. Do not set if using the notifications endpoint.
Returns:

ModelFuture
class civis.ml.ModelFuture(job_id, run_id, train_job_id=None, train_run_id=None, polling_interval=None, client=None, poll_on_creation=True)[source]

Encapsulates asynchronous execution of a CivisML job

This object knows where to find modeling outputs from CivisML jobs. All data attributes are lazily retrieved and block on job completion. This object can be pickled.

Parameters:

job_id : int

ID of the modeling job

run_id : int

ID of the modeling run

train_job_id : int, optional

If not provided, this object is assumed to encapsulate a training job, and train_job_id will equal job_id.

train_run_id : int, optional

If not provided, this object is assumed to encapsulate a training run, and train_run_id will equal run_id.

polling_interval : int or float, optional

The number of seconds between API requests to check whether a result is ready. The default intelligently switches between a short interval if pubnub is not available and a long interval for pubnub backup if that library is installed.

client : civis.APIClient, optional

If not provided, an civis.APIClient object will be created from the CIVIS_API_KEY.

poll_on_creation : bool, optional

If True (the default), it will poll upon calling result() the first time. If False, it will wait the number of seconds specified in polling_interval from object creation before polling.

See also

civis.futures.CivisFuture, concurrent.futures.Future

Attributes

metadata (dict, blocking) The metadata associated with this modeling job
metrics (dict, blocking) Validation metrics from this job’s training
validation_metadata (dict, blocking) Metadata from this modeling job’s validation run
train_metadata (dict, blocking) Metadata from this modeling job’s training run (will be identical to metadata if this is a training run)
estimator (sklearn.pipeline.Pipeline, blocking) The fitted scikit-learn Pipeline resulting from this model run
table (pandas.DataFrame, blocking) The table output from this modeling job: out-of-sample predictions on the training set for a training job, or a table of predictions for a prediction job. If the prediction job was split into multiple files (this happens automatically for large tables), this attribute will provide only predictions for the first file.
state (str) The current state of the Civis Platform run
job_id (int)
run_id (int)
train_job_id (int) Container ID for the training job – identical to job_id if this is a training job.
train_run_id (int) As train_job_id but for runs
is_training (bool) True if this ModelFuture corresponds to a train-validate job.

Methods

cancel() Cancels the corresponding Platform job before completion
succeeded() (Non-blocking) Is the job a success?
failed() (Non-blocking) Did the job fail?
cancelled() (Non-blocking) Was the job cancelled?
running() (Non-blocking) Is the job still running?
done() (Non-blocking) Is the job finished?
result() (Blocking) Return the final status of the Civis Platform job.
add_done_callback(fn)

Attaches a callable that will be called when the future finishes.

Args:
fn: A callable that will be called with this future as its only
argument when the future completes or is cancelled. The callable will always be called by a thread in the same process in which it was added. If the future has already completed or been cancelled then the callable will be called immediately. These callables are called in the order that they were added.
cancel()[source]

Submit a request to cancel the container/script/run.

Note

If this object represents a prediction run, cancel will only cancel the parent job. Child jobs will remain active.

Returns:

bool

Whether or not the run is in a cancelled state.
cancelled()

Return True if the future was cancelled.

done()

Return True of the future was cancelled or finished executing.

exception(timeout=None)

Return the exception raised by the call that the future represents.

Args:
timeout: The number of seconds to wait for the exception if the
future isn’t done. If None, then there is no limit on the wait time.
Returns:
The exception raised by the call that the future represents or None if the call completed without raising.
Raises:

CancelledError: If the future was cancelled. TimeoutError: If the future didn’t finish executing before the given

timeout.
failed()

Return True if the Civis job failed.

result(timeout=None)

Return the result of the call that the future represents.

Args:
timeout: The number of seconds to wait for the result if the future
isn’t done. If None, then there is no limit on the wait time.
Returns:
The result of the call that the future represents.
Raises:

CancelledError: If the future was cancelled. TimeoutError: If the future didn’t finish executing before the given

timeout.

Exception: If the call raised then that exception will be raised.

running()

Return True if the future is currently executing.

set_exception(exception)

Sets the result of the future as being the given exception.

Should only be used by Executor implementations and unit tests.

set_result(result)

Sets the return value of work associated with the future.

Should only be used by Executor implementations and unit tests.

set_running_or_notify_cancel()

Mark the future as running or process any cancel notifications.

Should only be used by Executor implementations and unit tests.

If the future has been cancelled (cancel() was called and returned True) then any threads waiting on the future completing (though calls to as_completed() or wait()) are notified and False is returned.

If the future was not cancelled then it is put in the running state (future calls to running() will return True) and True is returned.

This method should be called by Executor implementations before executing the work associated with this future. If this method returns False then the work should not be executed.

Returns:
False if the Future was cancelled, True otherwise.
Raises:
RuntimeError: if this method was already called or if set_result()
or set_exception() was called.
succeeded()

Return True if the job completed in Civis with no error.

API Client

APIClient is a class for handling requests to the Civis API. An instantiated APIClient contains a set of resources (listed below) where each resource is an object with methods. By convention, an instantiated APIClient object is named client and API requests are made with the following syntax:

client = civis.APIClient()
response = client.resource.method(params)

The methods on APIClient are created dynamically at runtime by parsing an collections.OrderedDict representation of the Civis API specification. By default, this specification is downloaded from the /endpoints endpoint the first time APIClient is instantiated (and cached in memory for the remainder of the program’s run). In some circumstances, it may be useful to use a local cache of the API specification rather than downloading the spec. This can be done by passing the specification to the client through the parameter local_api_spec as either the collections.OrderedDict or a filename where the specification has been saved.

api_key = os.environ['CIVIS_API_KEY']
spec = civis.resources.get_api_spec(api_key)

# From OrderedDict
client = civis.APIClient(local_api_spec=spec)

# From file
with open('local_api_spec.json', 'w') as f:
    json.dump(spec, f)
client = civis.APIClient(local_api_spec='local_api_spec.json')
class civis.APIClient(api_key=None, return_type='snake', retry_total=6, api_version='1.0', resources='base', local_api_spec=None)[source]

The Civis API client.

Parameters:

api_key : str, optional

Your API key obtained from the Civis Platform. If not given, the client will use the CIVIS_API_KEY environment variable.

return_type : str, optional

The following types are implemented:

retry_total : int, optional

A number indicating the maximum number of retries for 429, 502, 503, or 504 errors.

api_version : string, optional

The version of endpoints to call. May instantiate multiple client objects with different versions. Currently only “1.0” is supported.

resources : string, optional

When set to “base”, only the default endpoints will be exposed in the client object. Set to “all” to include all endpoints available for a given user, including those that may be in development and subject to breaking changes at a later date.

local_api_spec : collections.OrderedDict or string, optional

The methods on this class are dynamically built from the Civis API specification, which can be retrieved from the /endpoints endpoint. When local_api_spec is None, the default, this specification is downloaded the first time APIClient is instantiated. Alternatively, a local cache of the specification may be passed as either an OrderedDict or a filename which points to a json file.

Attributes

credentials An instance of the Credentials endpoint
databases An instance of the Databases endpoint
files An instance of the Files endpoint
imports An instance of the Imports endpoint
jobs An instance of the Jobs endpoint
models An instance of the Models endpoint
predictions An instance of the Predictions endpoint
projects An instance of the Projects endpoint
queries An instance of the Queries endpoint
reports An instance of the Reports endpoint
scripts An instance of the Scripts endpoint
tables An instance of the Tables endpoint
users An instance of the Users endpoint
default_credential

The current user’s default credential.

get_aws_credential_id(cred_name, owner=None)

Find an AWS credential ID.

Parameters:

cred_name : str or int

If an integer ID is given, this passes through directly. If a str is given, return the ID corresponding to the AWS credential with that name.

owner : str, optional

Return the credential with this owner. If not provided, search for credentials under your username to disambiguate multiple credentials with the same name. Note that this function cannot return credentials which are not associated with an owner.
Returns:

aws_credential_id : int

The ID number of the AWS credentials.
Raises:

ValueError

If the AWS credential can’t be found.

Examples

>>> import civis
>>> client = civis.APIClient()
>>> client.get_aws_credential_id('jsmith')
1234

>>> client.get_aws_credential_id(1111)
1111

>>> client.get_aws_credential_id('shared-cred',
...                              owner='research-group')
99
get_database_credential_id(username, database_name)

Return the credential ID for a given username in a given database.

Parameters:

username : str or int

If an integer ID is given, this passes through directly. If a str is given, return the ID corresponding to the database credential with that username.

database_name : str or int

Return the ID of the database credential with username username for this database name or ID.
Returns:

database_credential_id : int

The ID of the database credentials.
Raises:

ValueError

If the credential can’t be found.

Examples

>>> import civis
>>> client = civis.APIClient()
>>> client.get_database_credential_id('jsmith', 'redshift-general')
1234

>>> client.get_database_credential_id(1111, 'redshift-general')
1111
get_database_id(database)

Return the database ID for a given database name.

Parameters:

database : str or int

If an integer ID is given, passes through. If a str is given the database ID corresponding to that database name is returned.
Returns:

database_id : int

The ID of the database.
Raises:

ValueError

If the database can’t be found.
get_table_id(table, database)

Return the table ID for a given database and table name.

Parameters:

table : str

The name of the table in format schema.table.

database : str or int

The name or ID of the database.
Returns:

table_id : int

The ID of the table. Only returns exact match to specified table.
Raises:

ValueError

If an exact table match can’t be found.
username

The current user’s username.

API Response Types

class civis.response.Response(json_data, snake_case=True, headers=None)[source]

Custom Civis response object.

Notes

The main features of this class are that it maps camelCase to snake_case at the top level of the json object and attaches keys as attributes. Nested object keys are not changed.

Attributes

json_data (dict | None) This is json_data as it is originally returned to the user without the key names being changed. See Notes. None is used if the original response returned a 204 No Content response.
headers (dict) This is the header for the API call without changing the key names.
calls_remaining (int) Number of API calls remaining before rate limit is reached.
rate_limit (int) Total number of calls per API rate limit period.
class civis.response.PaginatedResponse(path, initial_params, endpoint)[source]

A response object that supports iteration.

Parameters:

path : str

Make GET requests to this path.

initial_params : dict

Query params that should be passed along with each request. Note that if initial_params contains the keys page_num or limit, they will be ignored. The given dict is not modified.

endpoint : civis.base.Endpoint

An endpoint used to make API requests.

Notes

This response is returned automatically by endpoints which support pagination when the iterator kwarg is specified.

Examples

>>> client = civis.APIClient()
>>> queries = client.queries.list(iterator=True)
>>> for query in queries:
...    print(query['id'])
class civis.futures.CivisFuture(poller, poller_args, polling_interval=None, api_key=None, client=None, poll_on_creation=True)[source]

A class for tracking future results.

This class will attempt to subscribe to a Pubnub channel to listen for job completion events. If you don’t have access to Pubnub channels, then it will fallback to polling.

This is a subclass of concurrent.futures.Future from the Python standard library. See: https://docs.python.org/3/library/concurrent.futures.html

Parameters:

poller : func

A function which returns an object that has a state attribute.

poller_args : tuple

The arguments with which to call the poller function.

polling_interval : int or float, optional

The number of seconds between API requests to check whether a result is ready.

api_key : DEPRECATED str, optional

Your Civis API key. If not given, the CIVIS_API_KEY environment variable will be used.

client : civis.APIClient, optional

poll_on_creation : bool, optional

If True (the default), it will poll upon calling result() the first time. If False, it will wait the number of seconds specified in polling_interval from object creation before polling.

Examples

This example is provided as a function at query_civis().

>>> client = civis.APIClient()
>>> database_id = client.get_database_id("my_database")
>>> cred_id = client.default_credential
>>> sql = "SELECT 1"
>>> preview_rows = 10
>>> response = client.queries.post(database_id, sql, preview_rows,
>>>                                credential=cred_id)
>>> job_id = response.id
>>>
>>> poller = client.queries.get
>>> poller_args = (job_id, ) # (job_id, run_id) if poller requires run_id
>>> polling_interval = 10
>>> future = CivisFuture(poller, poller_args, polling_interval)

API Resources

Credentials
class Credentials(session, return_type='civis')

Methods

get(id) Get a credential
list(**kwargs) List credentials
post(password, type, username, **kwargs) Create or update a credential
post_authenticate(remote_host_type, ...) Authenticate against a remote host
post_temporary(id, **kwargs) Generate a temporary credential for accessing S3
put(id, password, type, username, **kwargs) Update an existing credential
get(id)

Get a credential

Parameters:

id : integer

The ID of the credential.
Returns:

description : string

A long description of the credential.

id : integer

The ID of the credential.

created_at : string/time

The creation time for this credential.

remote_host_name : string

The name of the remote host associated with this credential.

type : string

The credential’s type.

updated_at : string/time

The last modification time for this credential.

owner : string

The name of the user who this credential belongs to.

remote_host_id : integer

The ID of the remote host associated with this credential.

username : string

The username for the credential.

name : string

The name identifying the credential
list(**kwargs)

List credentials

Parameters:

type : string, optional

The type (or types) of credentials to return. One or more of: Amazon Web Services S3, BSD::API, CASS/NCOA PAF, Catalist::API, Catalist::SFTP, Certificate, Civis Platform, Custom, Database, Google, Github, JobTraits::Ftp, Salesforce User, Salesforce Client, Silverpop Application, Silverpop Refresh Token, Silverpop User, TableauUser, VAN::MyVoterFile, VAN::MyCampaign, and VAN::BothModes. Specify multiple values as a comma- separated list (e.g., “A,B”).

default : boolean, optional

If true, will return a list with a single credential which is the current user’s default credential.

limit : integer, optional

Number of results to return. Defaults to its maximum of 1000.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to updated_at. Must be one of: updated_at, created_at, name.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

description : string

A long description of the credential.

id : integer

The ID of the credential.

created_at : string/time

The creation time for this credential.

remote_host_name : string

The name of the remote host associated with this credential.

type : string

The credential’s type.

updated_at : string/time

The last modification time for this credential.

owner : string

The name of the user who this credential belongs to.

remote_host_id : integer

The ID of the remote host associated with this credential.

username : string

The username for the credential.

name : string

The name identifying the credential
post(password, type, username, **kwargs)

Create or update a credential

Parameters:

password : string

The password for the credential.

type : string

username : string

The username for the credential.

description : string, optional

A long description of the credential.

remote_host : dict, optional:

- url : string
    The URL to your host.
- type : string
    The type of remote host. One of: RemoteHostTypes::BSD,
    RemoteHostTypes::Ftp, RemoteHostTypes::Github,
    RemoteHostTypes::GoogleDoc, RemoteHostTypes::JDBC,
    RemoteHostTypes::Redshift, RemoteHostTypes::Salesforce, and
    RemoteHostTypes::Van
- name : string
    The human readable name for the remote host.

remote_host_id : integer, optional

The ID of the remote host associated with the credential.

name : string, optional

The name identifying the credential.
Returns:

description : string

A long description of the credential.

id : integer

The ID of the credential.

created_at : string/time

The creation time for this credential.

remote_host_name : string

The name of the remote host associated with this credential.

type : string

The credential’s type.

updated_at : string/time

The last modification time for this credential.

owner : string

The name of the user who this credential belongs to.

remote_host_id : integer

The ID of the remote host associated with this credential.

username : string

The username for the credential.

name : string

The name identifying the credential
post_authenticate(remote_host_type, password, username, url)

Authenticate against a remote host

Parameters:

remote_host_type : string

The type of remote host. One of: RemoteHostTypes::BSD, RemoteHostTypes::Ftp, RemoteHostTypes::Github, RemoteHostTypes::GoogleDoc, RemoteHostTypes::JDBC, RemoteHostTypes::Redshift, RemoteHostTypes::Salesforce, and RemoteHostTypes::Van

password : string

The password for the credential.

username : string

The username for the credential.

url : string

The URL to your host.
Returns:

description : string

A long description of the credential.

id : integer

The ID of the credential.

created_at : string/time

The creation time for this credential.

remote_host_name : string

The name of the remote host associated with this credential.

type : string

The credential’s type.

updated_at : string/time

The last modification time for this credential.

owner : string

The name of the user who this credential belongs to.

remote_host_id : integer

The ID of the remote host associated with this credential.

username : string

The username for the credential.

name : string

The name identifying the credential
post_temporary(id, **kwargs)

Generate a temporary credential for accessing S3

Parameters:

id : integer

The ID of the credential.

duration : integer, optional

The number of seconds the temporary credential should be valid. Defaults to 15 minutes. Must not be less than 15 minutes or greater than 36 hours.
Returns:

access_key : string

The identifier of the credential.

session_token : string

The session token identifier.

secret_access_key : string

The secret part of the credential.
put(id, password, type, username, **kwargs)

Update an existing credential

Parameters:

id : integer

The ID of the credential.

password : string

The password for the credential.

type : string

username : string

The username for the credential.

description : string, optional

A long description of the credential.

remote_host : dict, optional:

- url : string
    The URL to your host.
- type : string
    The type of remote host. One of: RemoteHostTypes::BSD,
    RemoteHostTypes::Ftp, RemoteHostTypes::Github,
    RemoteHostTypes::GoogleDoc, RemoteHostTypes::JDBC,
    RemoteHostTypes::Redshift, RemoteHostTypes::Salesforce, and
    RemoteHostTypes::Van
- name : string
    The human readable name for the remote host.

remote_host_id : integer, optional

The ID of the remote host associated with the credential.

name : string, optional

The name identifying the credential.
Returns:

description : string

A long description of the credential.

id : integer

The ID of the credential.

created_at : string/time

The creation time for this credential.

remote_host_name : string

The name of the remote host associated with this credential.

type : string

The credential’s type.

updated_at : string/time

The last modification time for this credential.

owner : string

The name of the user who this credential belongs to.

remote_host_id : integer

The ID of the remote host associated with this credential.

username : string

The username for the credential.

name : string

The name identifying the credential
Databases
class Databases(session, return_type='civis')

Methods

delete_whitelist_ips(id, whitelisted_ip_id) Remove a whitelisted IP address
get_whitelist_ips(id, whitelisted_ip_id) View details about a whitelisted IP
list() List databases
list_schemas(id) List schemas in this database
list_whitelist_ips(id) List whitelisted IPs for the specified database
post_whitelist_ips(id, subnet_mask) Whitelist an IP address
delete_whitelist_ips(id, whitelisted_ip_id)

Remove a whitelisted IP address

Parameters:

id : integer

The ID of the database this rule is applied to.

whitelisted_ip_id : integer

The ID of this whitelisted IP address.
Returns:

None

Response code 204: success
get_whitelist_ips(id, whitelisted_ip_id)

View details about a whitelisted IP

Parameters:

id : integer

The ID of the database this rule is applied to.

whitelisted_ip_id : integer

The ID of this whitelisted IP address.
Returns:

id : integer

The ID of this whitelisted IP address.

subnet_mask : string

The subnet mask that is allowed by this rule.

is_active : boolean

True if the rule is applied, false if it has been revoked.

updated_at : string/time

The time this rule was last updated.

security_group_id : string

The ID of the security group this rule is applied to.

authorized_by : string

The user who authorized this rule.

remote_host_id : integer

The ID of the database this rule is applied to.

created_at : string/time

The time this rule was created.
list()

List databases

Returns:

id : integer

The ID for the database.

name : string

The name of the database.
list_schemas(id)

List schemas in this database

Parameters:

id : integer

The ID of the database.
Returns:

schema : string

The name of a schema.
list_whitelist_ips(id)

List whitelisted IPs for the specified database

Parameters:

id : integer

The ID for the database.
Returns:

id : integer

The ID of this whitelisted IP address.

subnet_mask : string

The subnet mask that is allowed by this rule.

updated_at : string/time

The time this rule was last updated.

security_group_id : string

The ID of the security group this rule is applied to.

remote_host_id : integer

The ID of the database this rule is applied to.

created_at : string/time

The time this rule was created.
post_whitelist_ips(id, subnet_mask)

Whitelist an IP address

Parameters:

id : integer

The ID of the database this rule is applied to.

subnet_mask : string

The subnet mask that is allowed by this rule.
Returns:

id : integer

The ID of this whitelisted IP address.

subnet_mask : string

The subnet mask that is allowed by this rule.

is_active : boolean

True if the rule is applied, false if it has been revoked.

updated_at : string/time

The time this rule was last updated.

security_group_id : string

The ID of the security group this rule is applied to.

authorized_by : string

The user who authorized this rule.

remote_host_id : integer

The ID of the database this rule is applied to.

created_at : string/time

The time this rule was created.
Files
class Files(session, return_type='civis')

Methods

delete_projects(id, project_id) Remove a Data::S3File from a project
delete_shares_groups(id, group_id) Revoke the permissions a group has on this object
delete_shares_users(id, user_id) Revoke the permissions a user has on this object
get(id) Get details about a file
list_projects(id) List the projects a Data::S3File belongs to
list_shares(id) List users and groups permissioned on this object
post(name, **kwargs) Initiate an upload of a file into the platform
put_projects(id, project_id) Add a Data::S3File to a project
put_shares_groups(id, group_ids, ...) Set the permissions groups has on this object
put_shares_users(id, permission_level, user_ids) Set the permissions users have on this object
delete_projects(id, project_id)

Remove a Data::S3File from a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
delete_shares_groups(id, group_id)

Revoke the permissions a group has on this object

Parameters:

id : integer

ID of the resource to be revoked

group_id : integer

ID of the group
Returns:

None

Response code 204: success
delete_shares_users(id, user_id)

Revoke the permissions a user has on this object

Parameters:

id : integer

ID of the resource to be revoked

user_id : integer

ID of the user
Returns:

None

Response code 204: success
get(id)

Get details about a file

Parameters:

id : integer

The ID of the file object.
Returns:

id : integer

The ID of the file object.

file_url : string

The URL that may be used to download the file.

download_url : string

A JSON string containing information about the URL of the file.

expires_at : string/date-time

The date and time the file will expire. If not specified, the file will expire in 30 days. To keep a file indefinitely, specify null.

file_size : integer

The file size.

created_at : string/date-time

The date and time the file was created.

name : string

The file name.
list_projects(id)

List the projects a Data::S3File belongs to

Parameters:

id : integer

The ID of the resource.
Returns:

description : string

A description of the project

id : integer

The ID for this project.

auto_share : boolean

archived : string

The archival status of the requested object(s).

updated_at : string/time

name : string

The name of this project.

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.
list_shares(id)

List users and groups permissioned on this object

Parameters:

id : integer

The ID of the object.
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
post(name, **kwargs)

Initiate an upload of a file into the platform

Parameters:

name : string

The file name.

expires_at : string/date-time, optional

The date and time the file will expire. If not specified, the file will expire in 30 days. To keep a file indefinitely, specify null.
Returns:

upload_url : string

The URL that may be used to upload a file. To use the upload URL, initiate a POST request to the given URL with the file you wish to import as the “file” form field.

upload_fields : dict

A hash containing the form fields to be included with the POST request.

id : integer

The ID of the file object.

expires_at : string/date-time

The date and time the file will expire. If not specified, the file will expire in 30 days. To keep a file indefinitely, specify null.

file_size : integer

The file size.

created_at : string/date-time

The date and time the file was created.

name : string

The file name.
put_projects(id, project_id)

Add a Data::S3File to a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
put_shares_groups(id, group_ids, permission_level)

Set the permissions groups has on this object

Parameters:

id : integer

ID of the resource to be shared

group_ids : list

An array of one or more group IDs

permission_level : string

Options are: “read”, “write”, or “manage”
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_shares_users(id, permission_level, user_ids)

Set the permissions users have on this object

Parameters:

id : integer

ID of the resource to be shared

permission_level : string

Options are: “read”, “write”, or “manage”

user_ids : list

An array of one or more user IDs
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
Imports
class Imports(session, return_type='civis')

Methods

delete_files_runs(id, run_id) Cancel a run
delete_projects(id, project_id) Remove a JobTypes::Import from a project
delete_shares_groups(id, group_id) Revoke the permissions a group has on this object
delete_shares_users(id, user_id) Revoke the permissions a user has on this object
delete_syncs(id, sync_id) Delete a sync
get(id) Get details about an import
get_batches(id) Get details about a batch import
get_files_runs(id, run_id) Check status of a run
list(**kwargs) List imports
list_batches(**kwargs) List batch imports
list_files_runs(id, **kwargs) List runs for the given import
list_projects(id) List the projects a JobTypes::Import belongs to
list_runs(id) Get the run history of this import
list_shares(id) List users and groups permissioned on this object
post(sync_type, is_outbound, name, **kwargs) Create a new import configuration
post_batches(credential_id, table, schema, ...) Upload multiple files to Redshift
post_cancel(id) Cancel a run
post_files(schema, credential_id, ...) Initate an import of a tabular file into the platform
post_files_runs(id) Start a run
post_runs(id) Run an import
post_syncs(id, source, destination, **kwargs) Create a sync
put(id, sync_type, is_outbound, name, **kwargs) Update an import
put_archive(id, status) Update the archive status of this object
put_projects(id, project_id) Add a JobTypes::Import to a project
put_shares_groups(id, group_ids, ...) Set the permissions groups has on this object
put_shares_users(id, permission_level, user_ids) Set the permissions users have on this object
put_syncs(id, sync_id, source, destination, ...) Update a sync
delete_files_runs(id, run_id)

Cancel a run

Parameters:

id : integer

The ID of the import.

run_id : integer

The ID of the run.
Returns:

None

Response code 202: success
delete_projects(id, project_id)

Remove a JobTypes::Import from a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
delete_shares_groups(id, group_id)

Revoke the permissions a group has on this object

Parameters:

id : integer

ID of the resource to be revoked

group_id : integer

ID of the group
Returns:

None

Response code 204: success
delete_shares_users(id, user_id)

Revoke the permissions a user has on this object

Parameters:

id : integer

ID of the resource to be revoked

user_id : integer

ID of the user
Returns:

None

Response code 204: success
delete_syncs(id, sync_id)

Delete a sync

Parameters:

id : integer

The ID of the import to fetch.

sync_id : integer

The ID of the sync to fetch.
Returns:

None

Response code 204: success
get(id)

Get details about an import

Parameters:

id : integer

The ID for the import.
Returns:

state : string

time_zone : string

The time zone of this import.

sync_type : string

The type of sync to perform; one of Dbsync, AutoImport, SilverpopDataImport, SilverpopContactImport, GdocImport, GdocExport, and Salesforce.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

destination : dict:

- additional_credentials : list
    Array that holds additional credentials used for specific imports. For
    salesforce imports, the first and only element is the client credential
    id.
- remote_host_id : integer
- credential_id : integer
- name : string

syncs : list:

List of syncs.
- advanced_options : dict::
    - partition_table_partition_column_min_name : string
    - column_delimiter : string
    - wipe_destination_table : boolean
    - invalid_char_replacement : string
    - partition_table_name : string
    - partition_column_name : string
    - sortkey1 : string
    - mysql_catalog_matches_schema : boolean
    - sql_query : string
    - truncate_long_lines : boolean
    - partition_table_partition_column_max_name : string
    - first_row_is_header : boolean
    - row_chunk_size : integer
    - export_action : string
    - soql_query : string
    - distkey : string
    - verify_table_row_counts : boolean
    - max_errors : integer
    - identity_column : string
    - sortkey2 : string
    - contact_lists : string
    - existing_table_rows : string
    - partition_schema_name : string
    - last_modified_column : string
- id : integer
- destination : dict::
    - path : string
        The schema.tablename to sync to.
- source : dict::
    - path : string
        The path of the dataset to sync from; for a database source,
        schema.tablename.
    - id : integer
        The ID of the table or file, if available.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

user : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

id : integer

The ID for the import.

created_at : string/date-time

next_run_at : string/time

The time of the next scheduled run.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

parent_id : integer

Parent id to trigger this import from

archived : string

The archival status of the requested object(s).

is_outbound : boolean

source : dict:

- additional_credentials : list
    Array that holds additional credentials used for specific imports. For
    salesforce imports, the first and only element is the client credential
    id.
- remote_host_id : integer
- credential_id : integer
- name : string

name : string

The name of the import.

updated_at : string/date-time

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
get_batches(id)

Get details about a batch import

Parameters:

id : integer

The ID for the import.
Returns:

state : string

The state of the run; one of “queued”, “running”, “succeeded”, “failed”, or “cancelled”.

id : integer

The ID for the import.

table : string

The destination table name, without the schema prefix. This table must already exist in Redshift.

finished_at : string/time

The time the last run completed.

schema : string

The destination schema name. This schema must already exist in Redshift.

remote_host_id : integer

The ID of the destination database host.

started_at : string/time

The time the last run started at.

error : string

The error returned by the run, if any.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID
get_files_runs(id, run_id)

Check status of a run

Parameters:

id : integer

The ID of the import.

run_id : integer

The ID of the run.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

error : string

The error, if any, returned by the run.

started_at : string/time

The time the last run started at.

import_id : integer

The ID of the import.

is_cancel_requested : boolean

True if run cancel requested, else false.
list(**kwargs)

List imports

Parameters:

type : string, optional

If specified, return imports of these types. It accepts a comma-separated list, possible values are ‘AutoImport’, ‘DbSync’, ‘Salesforce’, ‘GdocImport’.

author : string, optional

If specified, return imports from this author. It accepts a comma-separated list of author ids.

destination : string, optional

If specified, returns imports with one of these destinations. It accepts a comma-separated list of remote host ids.

status : string, optional

If specified, returns imports with one of these statuses. It accepts a comma-separated list, possible values are ‘running’, ‘failed’, ‘succeeded’, ‘idle’, ‘scheduled’.

archived : string, optional

The archival status of the requested object(s).

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 50.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to updated_at. Must be one of: updated_at, name, created_at, last_run.updated_at.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

state : string

time_zone : string

The time zone of this import.

sync_type : string

The type of sync to perform; one of Dbsync, AutoImport, SilverpopDataImport, SilverpopContactImport, GdocImport, GdocExport, and Salesforce.

destination : dict:

- additional_credentials : list
    Array that holds additional credentials used for specific imports. For
    salesforce imports, the first and only element is the client credential
    id.
- remote_host_id : integer
- credential_id : integer
- name : string

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

user : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

id : integer

The ID for the import.

created_at : string/date-time

archived : string

The archival status of the requested object(s).

is_outbound : boolean

updated_at : string/date-time

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

source : dict:

- additional_credentials : list
    Array that holds additional credentials used for specific imports. For
    salesforce imports, the first and only element is the client credential
    id.
- remote_host_id : integer
- credential_id : integer
- name : string

name : string

The name of the import.
list_batches(**kwargs)

List batch imports

Parameters:

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 50.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to updated_at. Must be one of: updated_at, created_at.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

state : string

The state of the run; one of “queued”, “running”, “succeeded”, “failed”, or “cancelled”.

id : integer

The ID for the import.

table : string

The destination table name, without the schema prefix. This table must already exist in Redshift.

finished_at : string/time

The time the last run completed.

schema : string

The destination schema name. This schema must already exist in Redshift.

remote_host_id : integer

The ID of the destination database host.

started_at : string/time

The time the last run started at.

error : string

The error returned by the run, if any.
list_files_runs(id, **kwargs)

List runs for the given import

Parameters:

id : integer

The ID of the import.

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 100.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to id. Must be one of: id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

error : string

The error, if any, returned by the run.

started_at : string/time

The time the last run started at.

import_id : integer

The ID of the import.

is_cancel_requested : boolean

True if run cancel requested, else false.
list_projects(id)

List the projects a JobTypes::Import belongs to

Parameters:

id : integer

The ID of the resource.
Returns:

description : string

A description of the project

id : integer

The ID for this project.

auto_share : boolean

archived : string

The archival status of the requested object(s).

updated_at : string/time

name : string

The name of this project.

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.
list_runs(id)

Get the run history of this import

Parameters:

id : integer
Returns:

state : string

id : integer

finished_at : string/time

The time that the run completed.

started_at : string/time

The time that the run started.

error : string

The error message for this run, if present.

created_at : string/time

The time that the run was queued.
list_shares(id)

List users and groups permissioned on this object

Parameters:

id : integer

The ID of the object.
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
post(sync_type, is_outbound, name, **kwargs)

Create a new import configuration

Parameters:

sync_type : string

The type of sync to perform; one of Dbsync, AutoImport, SilverpopDataImport, SilverpopContactImport, GdocImport, GdocExport, and Salesforce.

is_outbound : boolean

name : string

The name of the import.

hidden : boolean, optional

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

time_zone : string, optional

The time zone of this import.

destination : dict, optional:

- additional_credentials : list
    Array that holds additional credentials used for specific imports. For
    salesforce imports, the first and only element is the client credential
    id.
- remote_host_id : integer
- credential_id : integer

parent_id : integer, optional

Parent id to trigger this import from

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

source : dict, optional:

- additional_credentials : list
    Array that holds additional credentials used for specific imports. For
    salesforce imports, the first and only element is the client credential
    id.
- remote_host_id : integer
- credential_id : integer

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.

next_run_at : string/time, optional

The time of the next scheduled run.
Returns:

state : string

time_zone : string

The time zone of this import.

sync_type : string

The type of sync to perform; one of Dbsync, AutoImport, SilverpopDataImport, SilverpopContactImport, GdocImport, GdocExport, and Salesforce.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

destination : dict:

- additional_credentials : list
    Array that holds additional credentials used for specific imports. For
    salesforce imports, the first and only element is the client credential
    id.
- remote_host_id : integer
- credential_id : integer
- name : string

syncs : list:

List of syncs.
- advanced_options : dict::
    - partition_table_partition_column_min_name : string
    - column_delimiter : string
    - wipe_destination_table : boolean
    - invalid_char_replacement : string
    - partition_table_name : string
    - partition_column_name : string
    - sortkey1 : string
    - mysql_catalog_matches_schema : boolean
    - sql_query : string
    - truncate_long_lines : boolean
    - partition_table_partition_column_max_name : string
    - first_row_is_header : boolean
    - row_chunk_size : integer
    - export_action : string
    - soql_query : string
    - distkey : string
    - verify_table_row_counts : boolean
    - max_errors : integer
    - identity_column : string
    - sortkey2 : string
    - contact_lists : string
    - existing_table_rows : string
    - partition_schema_name : string
    - last_modified_column : string
- id : integer
- destination : dict::
    - path : string
        The schema.tablename to sync to.
- source : dict::
    - path : string
        The path of the dataset to sync from; for a database source,
        schema.tablename.
    - id : integer
        The ID of the table or file, if available.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

user : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

id : integer

The ID for the import.

created_at : string/date-time

next_run_at : string/time

The time of the next scheduled run.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

parent_id : integer

Parent id to trigger this import from

archived : string

The archival status of the requested object(s).

is_outbound : boolean

source : dict:

- additional_credentials : list
    Array that holds additional credentials used for specific imports. For
    salesforce imports, the first and only element is the client credential
    id.
- remote_host_id : integer
- credential_id : integer
- name : string

name : string

The name of the import.

updated_at : string/date-time

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
post_batches(credential_id, table, schema, remote_host_id, file_ids, **kwargs)

Upload multiple files to Redshift

Parameters:

credential_id : integer

The ID of the credentials to be used when performing the database import.

table : string

The destination table name, without the schema prefix. This table must already exist in Redshift.

schema : string

The destination schema name. This schema must already exist in Redshift.

remote_host_id : integer

The ID of the destination database host.

file_ids : list

The file IDs for the import.

column_delimiter : string, optional

The column delimiter for the file. Valid arguments are “comma”, “tab”, and “pipe”. If unspecified, defaults to “comma”.

hidden : boolean, optional

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

compression : string, optional

The type of compression. Valid arguments are “gzip”, “zip”, and “none”. If unspecified, defaults to “gzip”.

first_row_is_header : boolean, optional

A boolean value indicating whether or not the first row is a header row. If unspecified, defaults to false.
Returns:

state : string

The state of the run; one of “queued”, “running”, “succeeded”, “failed”, or “cancelled”.

id : integer

The ID for the import.

table : string

The destination table name, without the schema prefix. This table must already exist in Redshift.

finished_at : string/time

The time the last run completed.

schema : string

The destination schema name. This schema must already exist in Redshift.

remote_host_id : integer

The ID of the destination database host.

started_at : string/time

The time the last run started at.

error : string

The error returned by the run, if any.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID
post_cancel(id)

Cancel a run

Parameters:

id : integer

The ID of the job.
Returns:

state : string

The state of the run, one of ‘queued’, ‘running’ or ‘cancelled’.

id : integer

The ID of the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
post_files(schema, credential_id, remote_host_id, name, **kwargs)

Initate an import of a tabular file into the platform

Parameters:

schema : string

The schema of the destination table.

credential_id : integer

The id of the credentials to be used when performing the database import.

remote_host_id : integer

The id of the destination database host.

name : string

The name of the destination table.

column_delimiter : string, optional

The column delimiter of the file. If column_delimiter is null or omitted, it will be auto-detected. Valid arguments are “comma”, “tab”, and “pipe”.

sortkey2 : string, optional

The second column in a compound sortkey for the table.

sortkey1 : string, optional

The column to use as the sort key for the table.

hidden : boolean, optional

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

max_errors : integer, optional

The maximum number of rows with errors to remove from the import before failing.

distkey : string, optional

The column to use as the distkey for the table.

existing_table_rows : string, optional

The behaviour if a table with the requested name already exists. One of “fail”, “truncate”, “append”, or “drop”.Defaults to “fail”.

multipart : boolean, optional

If true, the upload URI will require a multipart/form-data POST request. Defaults to false.

first_row_is_header : boolean, optional

A boolean value indicating whether or not the first row is a header row. If first_row_is_header is null or omitted, it will be auto-detected.
Returns:

run_uri : string

The URI to POST to once the file upload is complete. After uploading the file using the URI given in the uploadUri attribute of the reponse, POST to this URI to initiate the import of your uploaded file into the platform.

upload_fields : dict

If multipart was set to true, these fields should be included in the multipart upload.

id : integer

The id of the import.

upload_uri : string

The URI which may be used to upload a tabular file for import. You must use this URI to upload the file you wish imported and then inform the Civis API when your upload is complete using the URI given by the runUri field of this reponse.
post_files_runs(id)

Start a run

Parameters:

id : integer

The ID of the import.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

error : string

The error, if any, returned by the run.

started_at : string/time

The time the last run started at.

import_id : integer

The ID of the import.

is_cancel_requested : boolean

True if run cancel requested, else false.
post_runs(id)

Run an import

Parameters:

id : integer

The ID of the import to run.
Returns:

run_id : integer

The ID of the new run triggered.
post_syncs(id, source, destination, **kwargs)

Create a sync

Parameters:

id : integer

source : dict:

- path : string
    The path of the dataset to sync from; for a database source,
    schema.tablename.

destination : dict:

- path : string
    The schema.tablename to sync to.

advanced_options : dict, optional:

- partition_table_partition_column_min_name : string
- column_delimiter : string
- wipe_destination_table : boolean
- invalid_char_replacement : string
- partition_table_name : string
- partition_column_name : string
- sortkey1 : string
- mysql_catalog_matches_schema : boolean
- sql_query : string
- truncate_long_lines : boolean
- partition_table_partition_column_max_name : string
- first_row_is_header : boolean
- row_chunk_size : integer
- export_action : string
- soql_query : string
- distkey : string
- verify_table_row_counts : boolean
- max_errors : integer
- identity_column : string
- sortkey2 : string
- contact_lists : string
- existing_table_rows : string
- partition_schema_name : string
- last_modified_column : string
Returns:

advanced_options : dict:

- partition_table_partition_column_min_name : string
- column_delimiter : string
- wipe_destination_table : boolean
- invalid_char_replacement : string
- partition_table_name : string
- partition_column_name : string
- sortkey1 : string
- mysql_catalog_matches_schema : boolean
- sql_query : string
- truncate_long_lines : boolean
- partition_table_partition_column_max_name : string
- first_row_is_header : boolean
- row_chunk_size : integer
- export_action : string
- soql_query : string
- distkey : string
- verify_table_row_counts : boolean
- max_errors : integer
- identity_column : string
- sortkey2 : string
- contact_lists : string
- existing_table_rows : string
- partition_schema_name : string
- last_modified_column : string

id : integer

destination : dict:

- path : string
    The schema.tablename to sync to.

source : dict:

- path : string
    The path of the dataset to sync from; for a database source,
    schema.tablename.
- id : integer
    The ID of the table or file, if available.
put(id, sync_type, is_outbound, name, **kwargs)

Update an import

Parameters:

id : integer

The ID for the import.

sync_type : string

The type of sync to perform; one of Dbsync, AutoImport, SilverpopDataImport, SilverpopContactImport, GdocImport, GdocExport, and Salesforce.

is_outbound : boolean

name : string

The name of the import.

time_zone : string, optional

The time zone of this import.

destination : dict, optional:

- additional_credentials : list
    Array that holds additional credentials used for specific imports. For
    salesforce imports, the first and only element is the client credential
    id.
- remote_host_id : integer
- credential_id : integer

parent_id : integer, optional

Parent id to trigger this import from

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

source : dict, optional:

- additional_credentials : list
    Array that holds additional credentials used for specific imports. For
    salesforce imports, the first and only element is the client credential
    id.
- remote_host_id : integer
- credential_id : integer

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.

next_run_at : string/time, optional

The time of the next scheduled run.
Returns:

state : string

time_zone : string

The time zone of this import.

sync_type : string

The type of sync to perform; one of Dbsync, AutoImport, SilverpopDataImport, SilverpopContactImport, GdocImport, GdocExport, and Salesforce.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

destination : dict:

- additional_credentials : list
    Array that holds additional credentials used for specific imports. For
    salesforce imports, the first and only element is the client credential
    id.
- remote_host_id : integer
- credential_id : integer
- name : string

syncs : list:

List of syncs.
- advanced_options : dict::
    - partition_table_partition_column_min_name : string
    - column_delimiter : string
    - wipe_destination_table : boolean
    - invalid_char_replacement : string
    - partition_table_name : string
    - partition_column_name : string
    - sortkey1 : string
    - mysql_catalog_matches_schema : boolean
    - sql_query : string
    - truncate_long_lines : boolean
    - partition_table_partition_column_max_name : string
    - first_row_is_header : boolean
    - row_chunk_size : integer
    - export_action : string
    - soql_query : string
    - distkey : string
    - verify_table_row_counts : boolean
    - max_errors : integer
    - identity_column : string
    - sortkey2 : string
    - contact_lists : string
    - existing_table_rows : string
    - partition_schema_name : string
    - last_modified_column : string
- id : integer
- destination : dict::
    - path : string
        The schema.tablename to sync to.
- source : dict::
    - path : string
        The path of the dataset to sync from; for a database source,
        schema.tablename.
    - id : integer
        The ID of the table or file, if available.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

user : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

id : integer

The ID for the import.

created_at : string/date-time

next_run_at : string/time

The time of the next scheduled run.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

parent_id : integer

Parent id to trigger this import from

archived : string

The archival status of the requested object(s).

is_outbound : boolean

source : dict:

- additional_credentials : list
    Array that holds additional credentials used for specific imports. For
    salesforce imports, the first and only element is the client credential
    id.
- remote_host_id : integer
- credential_id : integer
- name : string

name : string

The name of the import.

updated_at : string/date-time

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
put_archive(id, status)

Update the archive status of this object

Parameters:

id : integer

The ID of the object.

status : boolean

The desired archived status of the object.
Returns:

state : string

time_zone : string

The time zone of this import.

sync_type : string

The type of sync to perform; one of Dbsync, AutoImport, SilverpopDataImport, SilverpopContactImport, GdocImport, GdocExport, and Salesforce.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

destination : dict:

- additional_credentials : list
    Array that holds additional credentials used for specific imports. For
    salesforce imports, the first and only element is the client credential
    id.
- remote_host_id : integer
- credential_id : integer
- name : string

syncs : list:

List of syncs.
- advanced_options : dict::
    - partition_table_partition_column_min_name : string
    - column_delimiter : string
    - wipe_destination_table : boolean
    - invalid_char_replacement : string
    - partition_table_name : string
    - partition_column_name : string
    - sortkey1 : string
    - mysql_catalog_matches_schema : boolean
    - sql_query : string
    - truncate_long_lines : boolean
    - partition_table_partition_column_max_name : string
    - first_row_is_header : boolean
    - row_chunk_size : integer
    - export_action : string
    - soql_query : string
    - distkey : string
    - verify_table_row_counts : boolean
    - max_errors : integer
    - identity_column : string
    - sortkey2 : string
    - contact_lists : string
    - existing_table_rows : string
    - partition_schema_name : string
    - last_modified_column : string
- id : integer
- destination : dict::
    - path : string
        The schema.tablename to sync to.
- source : dict::
    - path : string
        The path of the dataset to sync from; for a database source,
        schema.tablename.
    - id : integer
        The ID of the table or file, if available.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

user : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

id : integer

The ID for the import.

created_at : string/date-time

next_run_at : string/time

The time of the next scheduled run.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

parent_id : integer

Parent id to trigger this import from

archived : string

The archival status of the requested object(s).

is_outbound : boolean

source : dict:

- additional_credentials : list
    Array that holds additional credentials used for specific imports. For
    salesforce imports, the first and only element is the client credential
    id.
- remote_host_id : integer
- credential_id : integer
- name : string

name : string

The name of the import.

updated_at : string/date-time

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
put_projects(id, project_id)

Add a JobTypes::Import to a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
put_shares_groups(id, group_ids, permission_level)

Set the permissions groups has on this object

Parameters:

id : integer

ID of the resource to be shared

group_ids : list

An array of one or more group IDs

permission_level : string

Options are: “read”, “write”, or “manage”
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_shares_users(id, permission_level, user_ids)

Set the permissions users have on this object

Parameters:

id : integer

ID of the resource to be shared

permission_level : string

Options are: “read”, “write”, or “manage”

user_ids : list

An array of one or more user IDs
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_syncs(id, sync_id, source, destination, **kwargs)

Update a sync

Parameters:

id : integer

The ID of the import to fetch.

sync_id : integer

The ID of the sync to fetch.

source : dict:

- path : string
    The path of the dataset to sync from; for a database source,
    schema.tablename.

destination : dict:

- path : string
    The schema.tablename to sync to.

advanced_options : dict, optional:

- partition_table_partition_column_min_name : string
- column_delimiter : string
- wipe_destination_table : boolean
- invalid_char_replacement : string
- partition_table_name : string
- partition_column_name : string
- sortkey1 : string
- mysql_catalog_matches_schema : boolean
- sql_query : string
- truncate_long_lines : boolean
- partition_table_partition_column_max_name : string
- first_row_is_header : boolean
- row_chunk_size : integer
- export_action : string
- soql_query : string
- distkey : string
- verify_table_row_counts : boolean
- max_errors : integer
- identity_column : string
- sortkey2 : string
- contact_lists : string
- existing_table_rows : string
- partition_schema_name : string
- last_modified_column : string
Returns:

advanced_options : dict:

- partition_table_partition_column_min_name : string
- column_delimiter : string
- wipe_destination_table : boolean
- invalid_char_replacement : string
- partition_table_name : string
- partition_column_name : string
- sortkey1 : string
- mysql_catalog_matches_schema : boolean
- sql_query : string
- truncate_long_lines : boolean
- partition_table_partition_column_max_name : string
- first_row_is_header : boolean
- row_chunk_size : integer
- export_action : string
- soql_query : string
- distkey : string
- verify_table_row_counts : boolean
- max_errors : integer
- identity_column : string
- sortkey2 : string
- contact_lists : string
- existing_table_rows : string
- partition_schema_name : string
- last_modified_column : string

id : integer

destination : dict:

- path : string
    The schema.tablename to sync to.

source : dict:

- path : string
    The path of the dataset to sync from; for a database source,
    schema.tablename.
- id : integer
    The ID of the table or file, if available.
Jobs
class Jobs(session, return_type='civis')

Methods

delete_projects(id, project_id) Remove a Job from a project
delete_shares_groups(id, group_id) Revoke the permissions a group has on this object
delete_shares_users(id, user_id) Revoke the permissions a user has on this object
get(id) Show basic job info
get_runs(id, run_id) Check status of a job
list(**kwargs) List jobs
list_children(id) Show nested tree of children that this job triggers
list_parents(id) Show chain of parents as a list that this job triggers from
list_projects(id) List the projects a Job belongs to
list_shares(id) List users and groups permissioned on this object
post_runs(id) Run a job
post_trigger_email(id) Generate and retrieve trigger email address
put_projects(id, project_id) Add a Job to a project
put_shares_groups(id, group_ids, ...) Set the permissions groups has on this object
put_shares_users(id, permission_level, user_ids) Set the permissions users have on this object
delete_projects(id, project_id)

Remove a Job from a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
delete_shares_groups(id, group_id)

Revoke the permissions a group has on this object

Parameters:

id : integer

ID of the resource to be revoked

group_id : integer

ID of the group
Returns:

None

Response code 204: success
delete_shares_users(id, user_id)

Revoke the permissions a user has on this object

Parameters:

id : integer

ID of the resource to be revoked

user_id : integer

ID of the user
Returns:

None

Response code 204: success
get(id)

Show basic job info

Parameters:

id : integer

The ID for this job.
Returns:

state : string

Whether the job is idle, queued, running, cancelled, or failed.

runs : list:

Information about the most recent runs of the job.
- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

id : integer

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

type : string

updated_at : string/date-time

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

archived : string

The archival status of the requested object(s).

created_at : string/date-time

name : string
get_runs(id, run_id)

Check status of a job

Parameters:

id : integer

The ID of the Job.

run_id : integer

The ID of the Run.
Returns:

state : string

id : integer

finished_at : string/time

The time that the run completed.

started_at : string/time

The time that the run started.

error : string

The error message for this run, if present.

created_at : string/time

The time that the run was queued.
list(**kwargs)

List jobs

Parameters:

limit : integer, optional

The maximum number of jobs to return.

state : string, optional

The job’s state. One or more of queued, running, succeeded, failed, and cancelled. Specify multiple values as a comma-separated list (e.g., “A,B”).

type : string, optional

The job’s type. Specify multiple values as a comma-separated list (e.g., “A,B”).

q : string, optional

Query string to search on the id, name, and job type

permission : string, optional

A permissions string, one of “read”, “write”, or “manage”. Lists only jobs for which the current user has that permission.

archived : string, optional

The archival status of the requested object(s).
Returns:

state : string

Whether the job is idle, queued, running, cancelled, or failed.

id : integer

type : string

updated_at : string/date-time

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

archived : string

The archival status of the requested object(s).

created_at : string/date-time

name : string
list_children(id)

Show nested tree of children that this job triggers

Parameters:

id : integer

The ID for this job.
Returns:

state : string

runs : list:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

id : integer

children : list

type : string

updated_at : string/date-time

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

created_at : string/date-time

name : string
list_parents(id)

Show chain of parents as a list that this job triggers from

Parameters:

id : integer

The ID for this job.
Returns:

state : string

Whether the job is idle, queued, running, cancelled, or failed.

runs : list:

Information about the most recent runs of the job.
- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

id : integer

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

type : string

updated_at : string/date-time

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

archived : string

The archival status of the requested object(s).

created_at : string/date-time

name : string
list_projects(id)

List the projects a Job belongs to

Parameters:

id : integer

The ID of the resource.
Returns:

description : string

A description of the project

id : integer

The ID for this project.

auto_share : boolean

archived : string

The archival status of the requested object(s).

updated_at : string/time

name : string

The name of this project.

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.
list_shares(id)

List users and groups permissioned on this object

Parameters:

id : integer

The ID of the object.
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
post_runs(id)

Run a job

Parameters:

id : integer

The ID for this job.
Returns:

state : string

id : integer

finished_at : string/time

The time that the run completed.

started_at : string/time

The time that the run started.

error : string

The error message for this run, if present.

created_at : string/time

The time that the run was queued.
post_trigger_email(id)

Generate and retrieve trigger email address

Parameters:

id : integer

The ID for this job.
Returns:

trigger_email : string

Email address which may be used to trigger this job to run.
put_projects(id, project_id)

Add a Job to a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
put_shares_groups(id, group_ids, permission_level)

Set the permissions groups has on this object

Parameters:

id : integer

ID of the resource to be shared

group_ids : list

An array of one or more group IDs

permission_level : string

Options are: “read”, “write”, or “manage”
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_shares_users(id, permission_level, user_ids)

Set the permissions users have on this object

Parameters:

id : integer

ID of the resource to be shared

permission_level : string

Options are: “read”, “write”, or “manage”

user_ids : list

An array of one or more user IDs
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
Models
class Models(session, return_type='civis')

Methods

delete_builds(id, build_id) Cancel a build
delete_projects(id, project_id) Remove a models from a project
delete_shares_groups(id, group_id) Revoke the permissions a group has on this object
delete_shares_users(id, user_id) Revoke the permissions a user has on this object
get(id) Retrieve model configuration
get_builds(id, build_id) Check status of a build
list(**kwargs) List models
list_builds(id, **kwargs) List builds for the given model
list_projects(id) List the projects a models belongs to
list_schedules(id) Show the model build schedule
list_shares(id) List users and groups permissioned on this object
list_types() List all available model types
patch(id, **kwargs) Update model configuration
post(**kwargs) Create new configuration for a model
post_builds(id) Start a build
put_archive(id, status) Update the archive status of this object
put_predictions(id, table_name, primary_key, ...) Add a table on which to apply the predictive model
put_projects(id, project_id) Add a models to a project
put_schedules(id, schedule) Schedule the model build
put_shares_groups(id, group_ids, ...) Set the permissions groups has on this object
put_shares_users(id, permission_level, user_ids) Set the permissions users have on this object
delete_builds(id, build_id)

Cancel a build

Parameters:

id : integer

The ID of the model.

build_id : integer

The ID of the build.
Returns:

None

Response code 202: success
delete_projects(id, project_id)

Remove a models from a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
delete_shares_groups(id, group_id)

Revoke the permissions a group has on this object

Parameters:

id : integer

ID of the resource to be revoked

group_id : integer

ID of the group
Returns:

None

Response code 204: success
delete_shares_users(id, user_id)

Revoke the permissions a user has on this object

Parameters:

id : integer

ID of the resource to be revoked

user_id : integer

ID of the user
Returns:

None

Response code 204: success
get(id)

Retrieve model configuration

Parameters:

id : integer

The ID of the model.
Returns:

id : integer

The ID of the model.

number_of_folds : integer

Number of folds for cross validation. Default value is 5.

last_output_location : string

The output JSON for the last build.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

dependent_variable_order : list

The order of dependent variables, especially useful for Ordinal Modeling.

created_at : string/date-time

The time the model was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

credential_id : integer

The ID of the credential used to read the target table. Defaults to the user’s default credential.

description : string

A description of the model.

primary_key : string

The unique ID (primary key) of the training dataset.

builds : list:

A list of trained models available for making predictions.
- description : string
    A description of the model build.
- id : integer
    The ID of the model build.
- roc_auc : number/float
    A key metric for binary, multinomial, and ordinal models. Nil for other
    model types.
- r_squared_error : number/float
    A key metric for continuous models. Nil for other model types.
- root_mean_squared_error : number/float
    A key metric for continuous models. Nil for other model types.
- created_at : string
    The time the model build was created.
- name : string
    The name of the model build.

parent_id : integer

The ID of the parent job that will trigger this model.

updated_at : string/date-time

The time the model was updated.

current_build_state : string

The status of the current model build. One of “succeeded”, “failed”, “queued”, or “running,”or “idle”, if no build has been attempted.

cross_validation_parameters : dict

Cross validation parameter grid for tree methods, e.g. {“n_estimators”: [100, 200, 500], “learning_rate”: [0.01, 0.1], “max_depth”: [2, 3]}.

predictions : list:

The tables upon which the model will be applied.
- state : string
    The status of the prediction. One of: "succeeded", "failed", "queued",
    or "running,"or "idle", if no build has been attempted.
- output_table : string
    The qualified name of the table to be created which will contain the
    model's predictions.
- id : integer
    The ID of the model to which to apply the prediction.
- limiting_sql : string
    A SQL WHERE clause used to scope the rows to be predicted.
- table_name : string
    The qualified name of the table on which to apply the predictive model.
- schedule : dict::
    - scheduled_minutes : list
        Minutes of the day it is scheduled on
    - scheduled_runs_per_hour : integer
        Alternative to scheduled minutes, number of times to run per hour
    - scheduled : boolean
        If the object is scheduled
    - scheduled_hours : list
        Hours of the day it is scheduled on
    - scheduled_days : list
        Day based on numeric value starting at 0 for Sunday
- primary_key : list
    The primary key or composite keys of the table being predicted.

time_zone : string

The time zone of this model.

model_type_id : integer

The ID of the model’s type.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

interaction_terms : boolean

Whether to search for interaction terms.

current_build_exception : string

Exception message, if applicable, of the current model build.

excluded_columns : list

A list of columns which will be considered ineligible to be independent variables.

active_build_id : integer

The ID of the current active build, the build used to score predictions.

archived : string

The archival status of the requested object(s).

user : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

limiting_sql : string

A custom SQL WHERE clause used to filter the rows used to build the model. (e.g., “id > 105”).

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

model_name : string

The name of the model.

table_name : string

The qualified name of the table containing the training set from which to build the model.

box_cox_transformation : boolean

Whether to transform data so that it assumes a normal distribution. Valid only with continuous models.

database_id : integer

The ID of the database holding the training set table used to build the model.

dependent_variable : string

The dependent variable of the training dataset.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
get_builds(id, build_id)

Check status of a build

Parameters:

id : integer

The ID of the model.

build_id : integer

The ID of the build.
Returns:

state : string

The state of the model build.one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the model build.

roc_auc : number/float

A key metric for binary, multinomial, and ordinal models. Nil for other model types.

root_mean_squared_error : number/float

A key metric for continuous models. Nil for other model types.

created_at : string

The time the model build was created.

description : string

A description of the model build.

error : string

The error, if any, returned by the build.

r_squared_error : number/float

A key metric for continuous models. Nil for other model types.

output : string

A string representing the JSON output for the specified build. Only present when smaller than 10KB in size.

name : string

The name of the model build.

output_location : string

A URL representing the location of the full JSON output for the specified build.The URL link will be valid for 5 minutes.

transformation_metadata : string

A string representing the full JSON output of the metadata for transformation of column names
list(**kwargs)

List models

Parameters:

model_name : string, optional

If specified, will be used to filter the models returned. Substring matching is supported. (e.g., “modelName=model” will return both “model1” and “my model”).

training_table_name : string, optional

If specified, will be used to filter the models returned by the training dataset table name. Substring matching is supported. (e.g., “trainingTableName=table” will return both “table1” and “my_table”).

dependent_variable : string, optional

If specified, will be used to filter the models returned by the dependent variable column name. Substring matching is supported. (e.g., “dependentVariable=predictor” will return both “predictor” and “my predictor”).

author : string, optional

If specified, return models from this author. It accepts a comma-separated list of author ids.

status : string, optional

If specified, returns models with one of these statuses. It accepts a comma-separated list, possible values are ‘running’, ‘failed’, ‘succeeded’, ‘idle’, ‘scheduled’.

archived : string, optional

The archival status of the requested object(s).

limit : integer, optional

Number of results to return. Defaults to its maximum of 50.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to updated_at. Must be one of: updated_at, model_name, created_at, name, last_run.updated_at.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

id : integer

The ID of the model.

number_of_folds : integer

Number of folds for cross validation. Default value is 5.

last_output_location : string

The output JSON for the last build.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

dependent_variable_order : list

The order of dependent variables, especially useful for Ordinal Modeling.

created_at : string/date-time

The time the model was created.

credential_id : integer

The ID of the credential used to read the target table. Defaults to the user’s default credential.

description : string

A description of the model.

primary_key : string

The unique ID (primary key) of the training dataset.

builds : list:

A list of trained models available for making predictions.
- description : string
    A description of the model build.
- id : integer
    The ID of the model build.
- roc_auc : number/float
    A key metric for binary, multinomial, and ordinal models. Nil for other
    model types.
- r_squared_error : number/float
    A key metric for continuous models. Nil for other model types.
- root_mean_squared_error : number/float
    A key metric for continuous models. Nil for other model types.
- created_at : string
    The time the model build was created.
- name : string
    The name of the model build.

parent_id : integer

The ID of the parent job that will trigger this model.

updated_at : string/date-time

The time the model was updated.

current_build_state : string

The status of the current model build. One of “succeeded”, “failed”, “queued”, or “running,”or “idle”, if no build has been attempted.

cross_validation_parameters : dict

Cross validation parameter grid for tree methods, e.g. {“n_estimators”: [100, 200, 500], “learning_rate”: [0.01, 0.1], “max_depth”: [2, 3]}.

predictions : list:

The tables upon which the model will be applied.
- state : string
    The status of the prediction. One of: "succeeded", "failed", "queued",
    or "running,"or "idle", if no build has been attempted.
- output_table : string
    The qualified name of the table to be created which will contain the
    model's predictions.
- id : integer
    The ID of the model to which to apply the prediction.
- limiting_sql : string
    A SQL WHERE clause used to scope the rows to be predicted.
- table_name : string
    The qualified name of the table on which to apply the predictive model.
- primary_key : list
    The primary key or composite keys of the table being predicted.

time_zone : string

The time zone of this model.

model_type_id : integer

The ID of the model’s type.

interaction_terms : boolean

Whether to search for interaction terms.

current_build_exception : string

Exception message, if applicable, of the current model build.

excluded_columns : list

A list of columns which will be considered ineligible to be independent variables.

archived : string

The archival status of the requested object(s).

user : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

limiting_sql : string

A custom SQL WHERE clause used to filter the rows used to build the model. (e.g., “id > 105”).

model_name : string

The name of the model.

table_name : string

The qualified name of the table containing the training set from which to build the model.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

database_id : integer

The ID of the database holding the training set table used to build the model.

dependent_variable : string

The dependent variable of the training dataset.

box_cox_transformation : boolean

Whether to transform data so that it assumes a normal distribution. Valid only with continuous models.
list_builds(id, **kwargs)

List builds for the given model

Parameters:

id : integer

The ID of the model.

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 100.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to id. Must be one of: id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

state : string

The state of the model build.one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the model build.

roc_auc : number/float

A key metric for binary, multinomial, and ordinal models. Nil for other model types.

root_mean_squared_error : number/float

A key metric for continuous models. Nil for other model types.

created_at : string

The time the model build was created.

description : string

A description of the model build.

error : string

The error, if any, returned by the build.

r_squared_error : number/float

A key metric for continuous models. Nil for other model types.

output : string

A string representing the JSON output for the specified build. Only present when smaller than 10KB in size.

name : string

The name of the model build.

output_location : string

A URL representing the location of the full JSON output for the specified build.The URL link will be valid for 5 minutes.

transformation_metadata : string

A string representing the full JSON output of the metadata for transformation of column names
list_projects(id)

List the projects a models belongs to

Parameters:

id : integer

The ID of the resource.
Returns:

description : string

A description of the project

id : integer

The ID for this project.

auto_share : boolean

archived : string

The archival status of the requested object(s).

updated_at : string/time

name : string

The name of this project.

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.
list_schedules(id)

Show the model build schedule

Parameters:

id : integer

The ID of the model associated with this schedule.
Returns:

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

id : integer

The ID of the model associated with this schedule.
list_shares(id)

List users and groups permissioned on this object

Parameters:

id : integer

The ID of the object.
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
list_types()

List all available model types

Returns:

fint_allowed : boolean

Whether this model type supports searching for interaction terms.

id : integer

The ID of the model type.

algorithm : string

The name of the algorithm used to train the model.

dv_type : string

The type of dependent variable predicted by the model.
patch(id, **kwargs)

Update model configuration

Parameters:

id : integer

The ID of the model.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

model_type_id : integer, optional

The ID of the model’s type.

number_of_folds : integer, optional

Number of folds for cross validation. Default value is 5.

interaction_terms : boolean, optional

Whether to search for interaction terms.

model_name : string, optional

The name of the model.

parent_id : integer, optional

The ID of the parent job that will trigger this model.

excluded_columns : list, optional

A list of columns which will be considered ineligible to be independent variables.

active_build_id : integer, optional

The ID of the current active build, the build used to score predictions.

limiting_sql : string, optional

A custom SQL WHERE clause used to filter the rows used to build the model. (e.g., “id > 105”).

description : string, optional

A description of the model.

primary_key : string, optional

The unique ID (primary key) of the training dataset.

credential_id : integer, optional

The ID of the credential used to read the target table. Defaults to the user’s default credential.

time_zone : string, optional

The time zone of this model.

dependent_variable_order : list, optional

The order of dependent variables, especially useful for Ordinal Modeling.

table_name : string, optional

The qualified name of the table containing the training set from which to build the model.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.

cross_validation_parameters : dict, optional

Cross validation parameter grid for tree methods, e.g. {“n_estimators”: [100, 200, 500], “learning_rate”: [0.01, 0.1], “max_depth”: [2, 3]}.

database_id : integer, optional

The ID of the database holding the training set table used to build the model.

dependent_variable : string, optional

The dependent variable of the training dataset.

box_cox_transformation : boolean, optional

Whether to transform data so that it assumes a normal distribution. Valid only with continuous models.
Returns:

None

Response code 204: success
post(**kwargs)

Create new configuration for a model

Parameters:

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

model_type_id : integer, optional

The ID of the model’s type.

number_of_folds : integer, optional

Number of folds for cross validation. Default value is 5.

interaction_terms : boolean, optional

Whether to search for interaction terms.

model_name : string, optional

The name of the model.

parent_id : integer, optional

The ID of the parent job that will trigger this model.

excluded_columns : list, optional

A list of columns which will be considered ineligible to be independent variables.

active_build_id : integer, optional

The ID of the current active build, the build used to score predictions.

limiting_sql : string, optional

A custom SQL WHERE clause used to filter the rows used to build the model. (e.g., “id > 105”).

hidden : boolean, optional

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

description : string, optional

A description of the model.

primary_key : string, optional

The unique ID (primary key) of the training dataset.

credential_id : integer, optional

The ID of the credential used to read the target table. Defaults to the user’s default credential.

time_zone : string, optional

The time zone of this model.

dependent_variable_order : list, optional

The order of dependent variables, especially useful for Ordinal Modeling.

table_name : string, optional

The qualified name of the table containing the training set from which to build the model.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.

cross_validation_parameters : dict, optional

Cross validation parameter grid for tree methods, e.g. {“n_estimators”: [100, 200, 500], “learning_rate”: [0.01, 0.1], “max_depth”: [2, 3]}.

database_id : integer, optional

The ID of the database holding the training set table used to build the model.

dependent_variable : string, optional

The dependent variable of the training dataset.

box_cox_transformation : boolean, optional

Whether to transform data so that it assumes a normal distribution. Valid only with continuous models.
Returns:

id : integer

The ID of the model.

number_of_folds : integer

Number of folds for cross validation. Default value is 5.

last_output_location : string

The output JSON for the last build.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

dependent_variable_order : list

The order of dependent variables, especially useful for Ordinal Modeling.

created_at : string/date-time

The time the model was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

credential_id : integer

The ID of the credential used to read the target table. Defaults to the user’s default credential.

description : string

A description of the model.

primary_key : string

The unique ID (primary key) of the training dataset.

builds : list:

A list of trained models available for making predictions.
- description : string
    A description of the model build.
- id : integer
    The ID of the model build.
- roc_auc : number/float
    A key metric for binary, multinomial, and ordinal models. Nil for other
    model types.
- r_squared_error : number/float
    A key metric for continuous models. Nil for other model types.
- root_mean_squared_error : number/float
    A key metric for continuous models. Nil for other model types.
- created_at : string
    The time the model build was created.
- name : string
    The name of the model build.

parent_id : integer

The ID of the parent job that will trigger this model.

updated_at : string/date-time

The time the model was updated.

current_build_state : string

The status of the current model build. One of “succeeded”, “failed”, “queued”, or “running,”or “idle”, if no build has been attempted.

cross_validation_parameters : dict

Cross validation parameter grid for tree methods, e.g. {“n_estimators”: [100, 200, 500], “learning_rate”: [0.01, 0.1], “max_depth”: [2, 3]}.

predictions : list:

The tables upon which the model will be applied.
- state : string
    The status of the prediction. One of: "succeeded", "failed", "queued",
    or "running,"or "idle", if no build has been attempted.
- output_table : string
    The qualified name of the table to be created which will contain the
    model's predictions.
- id : integer
    The ID of the model to which to apply the prediction.
- limiting_sql : string
    A SQL WHERE clause used to scope the rows to be predicted.
- table_name : string
    The qualified name of the table on which to apply the predictive model.
- schedule : dict::
    - scheduled_minutes : list
        Minutes of the day it is scheduled on
    - scheduled_runs_per_hour : integer
        Alternative to scheduled minutes, number of times to run per hour
    - scheduled : boolean
        If the object is scheduled
    - scheduled_hours : list
        Hours of the day it is scheduled on
    - scheduled_days : list
        Day based on numeric value starting at 0 for Sunday
- primary_key : list
    The primary key or composite keys of the table being predicted.

time_zone : string

The time zone of this model.

model_type_id : integer

The ID of the model’s type.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

interaction_terms : boolean

Whether to search for interaction terms.

current_build_exception : string

Exception message, if applicable, of the current model build.

excluded_columns : list

A list of columns which will be considered ineligible to be independent variables.

active_build_id : integer

The ID of the current active build, the build used to score predictions.

archived : string

The archival status of the requested object(s).

user : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

limiting_sql : string

A custom SQL WHERE clause used to filter the rows used to build the model. (e.g., “id > 105”).

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

model_name : string

The name of the model.

table_name : string

The qualified name of the table containing the training set from which to build the model.

box_cox_transformation : boolean

Whether to transform data so that it assumes a normal distribution. Valid only with continuous models.

database_id : integer

The ID of the database holding the training set table used to build the model.

dependent_variable : string

The dependent variable of the training dataset.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
post_builds(id)

Start a build

Parameters:

id : integer

The ID of the model.
Returns:

state : string

The state of the model build.one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the model build.

roc_auc : number/float

A key metric for binary, multinomial, and ordinal models. Nil for other model types.

root_mean_squared_error : number/float

A key metric for continuous models. Nil for other model types.

created_at : string

The time the model build was created.

description : string

A description of the model build.

error : string

The error, if any, returned by the build.

r_squared_error : number/float

A key metric for continuous models. Nil for other model types.

output : string

A string representing the JSON output for the specified build. Only present when smaller than 10KB in size.

name : string

The name of the model build.

output_location : string

A URL representing the location of the full JSON output for the specified build.The URL link will be valid for 5 minutes.

transformation_metadata : string

A string representing the full JSON output of the metadata for transformation of column names
put_archive(id, status)

Update the archive status of this object

Parameters:

id : integer

The ID of the object.

status : boolean

The desired archived status of the object.
Returns:

id : integer

The ID of the model.

number_of_folds : integer

Number of folds for cross validation. Default value is 5.

last_output_location : string

The output JSON for the last build.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

dependent_variable_order : list

The order of dependent variables, especially useful for Ordinal Modeling.

created_at : string/date-time

The time the model was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

credential_id : integer

The ID of the credential used to read the target table. Defaults to the user’s default credential.

description : string

A description of the model.

primary_key : string

The unique ID (primary key) of the training dataset.

builds : list:

A list of trained models available for making predictions.
- description : string
    A description of the model build.
- id : integer
    The ID of the model build.
- roc_auc : number/float
    A key metric for binary, multinomial, and ordinal models. Nil for other
    model types.
- r_squared_error : number/float
    A key metric for continuous models. Nil for other model types.
- root_mean_squared_error : number/float
    A key metric for continuous models. Nil for other model types.
- created_at : string
    The time the model build was created.
- name : string
    The name of the model build.

parent_id : integer

The ID of the parent job that will trigger this model.

updated_at : string/date-time

The time the model was updated.

current_build_state : string

The status of the current model build. One of “succeeded”, “failed”, “queued”, or “running,”or “idle”, if no build has been attempted.

cross_validation_parameters : dict

Cross validation parameter grid for tree methods, e.g. {“n_estimators”: [100, 200, 500], “learning_rate”: [0.01, 0.1], “max_depth”: [2, 3]}.

predictions : list:

The tables upon which the model will be applied.
- state : string
    The status of the prediction. One of: "succeeded", "failed", "queued",
    or "running,"or "idle", if no build has been attempted.
- output_table : string
    The qualified name of the table to be created which will contain the
    model's predictions.
- id : integer
    The ID of the model to which to apply the prediction.
- limiting_sql : string
    A SQL WHERE clause used to scope the rows to be predicted.
- table_name : string
    The qualified name of the table on which to apply the predictive model.
- schedule : dict::
    - scheduled_minutes : list
        Minutes of the day it is scheduled on
    - scheduled_runs_per_hour : integer
        Alternative to scheduled minutes, number of times to run per hour
    - scheduled : boolean
        If the object is scheduled
    - scheduled_hours : list
        Hours of the day it is scheduled on
    - scheduled_days : list
        Day based on numeric value starting at 0 for Sunday
- primary_key : list
    The primary key or composite keys of the table being predicted.

time_zone : string

The time zone of this model.

model_type_id : integer

The ID of the model’s type.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

interaction_terms : boolean

Whether to search for interaction terms.

current_build_exception : string

Exception message, if applicable, of the current model build.

excluded_columns : list

A list of columns which will be considered ineligible to be independent variables.

active_build_id : integer

The ID of the current active build, the build used to score predictions.

archived : string

The archival status of the requested object(s).

user : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

limiting_sql : string

A custom SQL WHERE clause used to filter the rows used to build the model. (e.g., “id > 105”).

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

model_name : string

The name of the model.

table_name : string

The qualified name of the table containing the training set from which to build the model.

box_cox_transformation : boolean

Whether to transform data so that it assumes a normal distribution. Valid only with continuous models.

database_id : integer

The ID of the database holding the training set table used to build the model.

dependent_variable : string

The dependent variable of the training dataset.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
put_predictions(id, table_name, primary_key, **kwargs)

Add a table on which to apply the predictive model

Parameters:

id : integer

The ID of the model to which to apply the prediction.

table_name : string

The qualified name of the table on which to apply the predictive model.

primary_key : list

The primary key or composite keys of the table being predicted.

output_table : string, optional

The qualified name of the table to be created which will contain the model’s predictions.

limiting_sql : string, optional

A SQL WHERE clause used to scope the rows to be predicted.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday
Returns:

state : string

The status of the prediction. One of: “succeeded”, “failed”, “queued”, or “running,”or “idle”, if no build has been attempted.

output_table : string

The qualified name of the table to be created which will contain the model’s predictions.

id : integer

The ID of the model to which to apply the prediction.

limiting_sql : string

A SQL WHERE clause used to scope the rows to be predicted.

table_name : string

The qualified name of the table on which to apply the predictive model.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

primary_key : list

The primary key or composite keys of the table being predicted.
put_projects(id, project_id)

Add a models to a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
put_schedules(id, schedule)

Schedule the model build

Parameters:

id : integer

The ID of the model associated with this schedule.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday
Returns:

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

id : integer

The ID of the model associated with this schedule.
put_shares_groups(id, group_ids, permission_level)

Set the permissions groups has on this object

Parameters:

id : integer

ID of the resource to be shared

group_ids : list

An array of one or more group IDs

permission_level : string

Options are: “read”, “write”, or “manage”
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_shares_users(id, permission_level, user_ids)

Set the permissions users have on this object

Parameters:

id : integer

ID of the resource to be shared

permission_level : string

Options are: “read”, “write”, or “manage”

user_ids : list

An array of one or more user IDs
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
Predictions
class Predictions(session, return_type='civis')

Methods

delete_runs(id, run_id) Cancel a run
get(id) Show the specified prediction
get_runs(id, run_id) Check status of a run
list(**kwargs) List predictions
list_runs(id, **kwargs) List runs for the given prediction
list_schedules(id) Show the prediction schedule
patch(id, **kwargs) Update a prediction
post_runs(id) Start a run
put_schedules(id, **kwargs) Schedule the prediction
delete_runs(id, run_id)

Cancel a run

Parameters:

id : integer

The ID of the prediction.

run_id : integer

The ID of the run.
Returns:

None

Response code 202: success
get(id)

Show the specified prediction

Parameters:

id : integer

The ID of the prediction.
Returns:

output_table_name : string

The name of the output table for this prediction.

state : string

The state of the last run of this prediction.

id : integer

The ID of the prediction.

model_id : integer

The ID of the model used for this prediction.

scored_table_name : string

The name of the source table for this prediction.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

started_at : string/date-time

The start time of the last run of this prediction.

scored_table_id : integer

The ID of the source table for this prediction.

primary_key : list

The primary key or composite keys of the table being predicted.

error : string

The error, if any, of the last run of this prediction.

limiting_sql : string

A SQL WHERE clause used to scope the rows to be predicted.

scored_tables : list:

An array of created prediction tables.
- schema : string
    The schema of table with created predictions.
- id : integer
    The ID of the table with created predictions.
- score_stats : list::
    An array of metrics on the created predictions.
    - avg_score : number/float
        The average score.
    - score_name : string
        The name of the score.
    - max_score : number/float
        The maximum score.
    - min_score : number/float
        The minimum score.
    - histogram : list
        The histogram of the distribution of scores.
- created_at : string/date-time
    The time when the table with created predictions was created.
- name : string
    The name of table with created predictions.

finished_at : string/date-time

The end time of the last run of this prediction.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.
get_runs(id, run_id)

Check status of a run

Parameters:

id : integer

The ID of the prediction.

run_id : integer

The ID of the run.
Returns:

state : string

The state of the prediction run.

id : integer

The ID of the prediction run.

exception : string

The exception, if any, returned by the prediction run.

prediction_id : integer

The ID of the prediction.

score_stats : list:

An array of metrics on the created predictions.
- avg_score : number/float
    The average score.
- score_name : string
    The name of the score.
- max_score : number/float
    The maximum score.
- min_score : number/float
    The minimum score.
- histogram : list
    The histogram of the distribution of scores.

created_at : string/date-time

The time when the table with created predictions was created.

name : string

The name of table created by this predictions run.
list(**kwargs)

List predictions

Parameters:

model_id : integer, optional

If specified, only return predictions associated with this model ID.
Returns:

output_table_name : string

The name of the output table for this prediction.

state : string

The state of the last run of this prediction.

id : integer

The ID of the prediction.

model_id : integer

The ID of the model used for this prediction.

finished_at : string/date-time

The end time of the last run of this prediction.

scored_table_name : string

The name of the source table for this prediction.

error : string

The error, if any, of the last run of this prediction.

started_at : string/date-time

The start time of the last run of this prediction.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

scored_table_id : integer

The ID of the source table for this prediction.
list_runs(id, **kwargs)

List runs for the given prediction

Parameters:

id : integer

The ID of the prediction.

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 100.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to id. Must be one of: id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

state : string

The state of the prediction run.

id : integer

The ID of the prediction run.

exception : string

The exception, if any, returned by the prediction run.

prediction_id : integer

The ID of the prediction.

score_stats : list:

An array of metrics on the created predictions.
- avg_score : number/float
    The average score.
- score_name : string
    The name of the score.
- max_score : number/float
    The maximum score.
- min_score : number/float
    The minimum score.
- histogram : list
    The histogram of the distribution of scores.

created_at : string/date-time

The time when the table with created predictions was created.

name : string

The name of table created by this predictions run.
list_schedules(id)

Show the prediction schedule

Parameters:

id : integer

ID of the prediction associated with this schedule.
Returns:

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

id : integer

ID of the prediction associated with this schedule.

score_on_model_build : boolean

Whether the prediction will run after a rebuild of the associated model.
patch(id, **kwargs)

Update a prediction

Parameters:

id : integer

The ID of the prediction.

output_table_name : string, optional

The name of the output table for this prediction.

primary_key : list, optional

The primary key or composite keys of the table being predicted.

limiting_sql : string, optional

A SQL WHERE clause used to scope the rows to be predicted.
Returns:

output_table_name : string

The name of the output table for this prediction.

state : string

The state of the last run of this prediction.

id : integer

The ID of the prediction.

model_id : integer

The ID of the model used for this prediction.

scored_table_name : string

The name of the source table for this prediction.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

started_at : string/date-time

The start time of the last run of this prediction.

scored_table_id : integer

The ID of the source table for this prediction.

primary_key : list

The primary key or composite keys of the table being predicted.

error : string

The error, if any, of the last run of this prediction.

limiting_sql : string

A SQL WHERE clause used to scope the rows to be predicted.

scored_tables : list:

An array of created prediction tables.
- schema : string
    The schema of table with created predictions.
- id : integer
    The ID of the table with created predictions.
- score_stats : list::
    An array of metrics on the created predictions.
    - avg_score : number/float
        The average score.
    - score_name : string
        The name of the score.
    - max_score : number/float
        The maximum score.
    - min_score : number/float
        The minimum score.
    - histogram : list
        The histogram of the distribution of scores.
- created_at : string/date-time
    The time when the table with created predictions was created.
- name : string
    The name of table with created predictions.

finished_at : string/date-time

The end time of the last run of this prediction.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.
post_runs(id)

Start a run

Parameters:

id : integer

The ID of the prediction.
Returns:

state : string

The state of the prediction run.

id : integer

The ID of the prediction run.

exception : string

The exception, if any, returned by the prediction run.

prediction_id : integer

The ID of the prediction.

score_stats : list:

An array of metrics on the created predictions.
- avg_score : number/float
    The average score.
- score_name : string
    The name of the score.
- max_score : number/float
    The maximum score.
- min_score : number/float
    The minimum score.
- histogram : list
    The histogram of the distribution of scores.

created_at : string/date-time

The time when the table with created predictions was created.

name : string

The name of table created by this predictions run.
put_schedules(id, **kwargs)

Schedule the prediction

Parameters:

id : integer

ID of the prediction associated with this schedule.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

score_on_model_build : boolean, optional

Whether the prediction will run after a rebuild of the associated model.
Returns:

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

id : integer

ID of the prediction associated with this schedule.

score_on_model_build : boolean

Whether the prediction will run after a rebuild of the associated model.
Projects
class Projects(session, return_type='civis')

Methods

delete_shares_groups(id, group_id) Revoke the permissions a group has on this object
delete_shares_users(id, user_id) Revoke the permissions a user has on this object
get(project_id) Get a detailed view of a project and the objects in it
list(**kwargs) List projects
list_shares(id) List users and groups permissioned on this object
post(description, name, **kwargs) Create a project
put(project_id, **kwargs) Update a project
put_archive(id, status) Update the archive status of this object
put_shares_groups(id, group_ids, ...) Set the permissions groups has on this object
put_shares_users(id, permission_level, user_ids) Set the permissions users have on this object
delete_shares_groups(id, group_id)

Revoke the permissions a group has on this object

Parameters:

id : integer

ID of the resource to be revoked

group_id : integer

ID of the group
Returns:

None

Response code 204: success
delete_shares_users(id, user_id)

Revoke the permissions a user has on this object

Parameters:

id : integer

ID of the resource to be revoked

user_id : integer

ID of the user
Returns:

None

Response code 204: success
get(project_id)

Get a detailed view of a project and the objects in it

Parameters:

project_id : integer
Returns:

scripts : list:

- state : string
- id : integer
    The object ID.
- finished_at : string/time
- type : string
- updated_at : string/time
- created_at : string/time
- name : string

id : integer

The ID for this project.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

auto_share : boolean

reports : list:

- state : string
- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

imports : list:

- state : string
- id : integer
    The object ID.
- finished_at : string/time
- type : string
- updated_at : string/time
- created_at : string/time
- name : string

models : list:

- state : string
- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

app_instances : list:

- slug : string
- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

files : list:

- file_name : string
- id : integer
    The object ID.
- file_size : integer
- updated_at : string/time
- created_at : string/time

description : string

A description of the project

archived : string

The archival status of the requested object(s).

all_objects : list:

- icon : string
- fco_type : string
- sub_type : string
- archived : string
    The archival status of the requested object(s).
- project_id : integer
- object_id : integer
- object_type : string
- author : string
- name : string

tables : list:

- column_count : integer
- schema : string
- updated_at : string/time
- row_count : integer
- created_at : string/time
- name : string

note : string

updated_at : string/time

name : string

The name of this project.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

script_templates : list:

- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

surveys : list:

- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
list(**kwargs)

List projects

Parameters:

author : string, optional

If specified, return projects owned by this author. It accepts a comma- separated list of author ids.

permission : string, optional

A permissions string, one of “read”, “write”, or “manage”. Lists only projects for which the current user has that permission.

archived : string, optional

The archival status of the requested object(s).

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 1000.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to updated_at. Must be one of: updated_at, name, created_at.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

description : string

A description of the project

id : integer

The ID for this project.

auto_share : boolean

archived : string

The archival status of the requested object(s).

updated_at : string/time

name : string

The name of this project.

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.
list_shares(id)

List users and groups permissioned on this object

Parameters:

id : integer

The ID of the object.
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
post(description, name, **kwargs)

Create a project

Parameters:

description : string

A description of the project

name : string

The name of this project.

hidden : boolean, optional

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

note : string, optional

Notes for the project
Returns:

scripts : list:

- state : string
- id : integer
    The object ID.
- finished_at : string/time
- type : string
- updated_at : string/time
- created_at : string/time
- name : string

id : integer

The ID for this project.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

auto_share : boolean

reports : list:

- state : string
- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

imports : list:

- state : string
- id : integer
    The object ID.
- finished_at : string/time
- type : string
- updated_at : string/time
- created_at : string/time
- name : string

models : list:

- state : string
- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

app_instances : list:

- slug : string
- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

files : list:

- file_name : string
- id : integer
    The object ID.
- file_size : integer
- updated_at : string/time
- created_at : string/time

description : string

A description of the project

archived : string

The archival status of the requested object(s).

all_objects : list:

- icon : string
- fco_type : string
- sub_type : string
- archived : string
    The archival status of the requested object(s).
- project_id : integer
- object_id : integer
- object_type : string
- author : string
- name : string

tables : list:

- column_count : integer
- schema : string
- updated_at : string/time
- row_count : integer
- created_at : string/time
- name : string

note : string

updated_at : string/time

name : string

The name of this project.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

script_templates : list:

- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

surveys : list:

- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
put(project_id, **kwargs)

Update a project

Parameters:

project_id : integer

description : string, optional

A description of the project

note : string, optional

Notes for the project

name : string, optional

The name of this project.
Returns:

scripts : list:

- state : string
- id : integer
    The object ID.
- finished_at : string/time
- type : string
- updated_at : string/time
- created_at : string/time
- name : string

id : integer

The ID for this project.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

auto_share : boolean

reports : list:

- state : string
- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

imports : list:

- state : string
- id : integer
    The object ID.
- finished_at : string/time
- type : string
- updated_at : string/time
- created_at : string/time
- name : string

models : list:

- state : string
- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

app_instances : list:

- slug : string
- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

files : list:

- file_name : string
- id : integer
    The object ID.
- file_size : integer
- updated_at : string/time
- created_at : string/time

description : string

A description of the project

archived : string

The archival status of the requested object(s).

all_objects : list:

- icon : string
- fco_type : string
- sub_type : string
- archived : string
    The archival status of the requested object(s).
- project_id : integer
- object_id : integer
- object_type : string
- author : string
- name : string

tables : list:

- column_count : integer
- schema : string
- updated_at : string/time
- row_count : integer
- created_at : string/time
- name : string

note : string

updated_at : string/time

name : string

The name of this project.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

script_templates : list:

- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

surveys : list:

- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
put_archive(id, status)

Update the archive status of this object

Parameters:

id : integer

The ID of the object.

status : boolean

The desired archived status of the object.
Returns:

scripts : list:

- state : string
- id : integer
    The object ID.
- finished_at : string/time
- type : string
- updated_at : string/time
- created_at : string/time
- name : string

id : integer

The ID for this project.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

auto_share : boolean

reports : list:

- state : string
- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

imports : list:

- state : string
- id : integer
    The object ID.
- finished_at : string/time
- type : string
- updated_at : string/time
- created_at : string/time
- name : string

models : list:

- state : string
- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

app_instances : list:

- slug : string
- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

files : list:

- file_name : string
- id : integer
    The object ID.
- file_size : integer
- updated_at : string/time
- created_at : string/time

description : string

A description of the project

archived : string

The archival status of the requested object(s).

all_objects : list:

- icon : string
- fco_type : string
- sub_type : string
- archived : string
    The archival status of the requested object(s).
- project_id : integer
- object_id : integer
- object_type : string
- author : string
- name : string

tables : list:

- column_count : integer
- schema : string
- updated_at : string/time
- row_count : integer
- created_at : string/time
- name : string

note : string

updated_at : string/time

name : string

The name of this project.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

script_templates : list:

- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
- name : string

surveys : list:

- id : integer
    The object ID.
- updated_at : string/time
- created_at : string/time
put_shares_groups(id, group_ids, permission_level)

Set the permissions groups has on this object

Parameters:

id : integer

ID of the resource to be shared

group_ids : list

An array of one or more group IDs

permission_level : string

Options are: “read”, “write”, or “manage”
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_shares_users(id, permission_level, user_ids)

Set the permissions users have on this object

Parameters:

id : integer

ID of the resource to be shared

permission_level : string

Options are: “read”, “write”, or “manage”

user_ids : list

An array of one or more user IDs
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
Queries
class Queries(session, return_type='civis')

Methods

delete_runs(id, run_id) Cancel a run
get(id) Get details about a query
get_runs(id, run_id) Check status of a run
list(**kwargs) List all queries
list_runs(id, **kwargs) List runs for the given query
post(database, sql, preview_rows, **kwargs) Execute a query
post_runs(id) Start a run
put_scripts(id, script_id) Update the query’s associated script
delete_runs(id, run_id)

Cancel a run

Parameters:

id : integer

The ID of the query.

run_id : integer

The ID of the run.
Returns:

None

Response code 202: success
get(id)

Get details about a query

Parameters:

id : integer

The query ID.
Returns:

state : string

The state of the last run.

result_rows : list

A preview of rows returned by the query.

id : integer

The query ID.

report_id : integer

The ID of the report associated with this query.

last_run_id : integer

The ID of the last run.

started_at : string/date-time

The start time of the last run.

created_at : string/time

sql : string

The SQL to execute.

result_columns : list

A preview of columns returned by the query.

credential : integer

The credential ID.

script_id : integer

The ID of the script associated with this query.

finished_at : string/date-time

The end time of the last run.

exception : string

Exception returned from the query, null if the query was a success.

updated_at : string/time

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

name : string

The name of the query.

database : integer

The database ID.
get_runs(id, run_id)

Check status of a run

Parameters:

id : integer

The ID of the query.

run_id : integer

The ID of the run.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

query_id : integer

The ID of the query.

is_cancel_requested : boolean

True if run cancel requested, else false.
list(**kwargs)

List all queries

Parameters:

database_id : integer, optional

The database ID.

author_id : integer, optional

The author of the query.

created_before : string, optional

An upper bound for the creation date of the query.

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 50.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to created_at. Must be one of: created_at.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

state : string

The state of the last run.

result_rows : list

A preview of rows returned by the query.

id : integer

The query ID.

last_run_id : integer

The ID of the last run.

started_at : string/date-time

The start time of the last run.

preview_rows : integer

The number of rows to save from the query’s result (maximum: 100).

created_at : string/time

sql : string

The SQL to execute.

result_columns : list

A preview of columns returned by the query.

credential : integer

The credential ID.

script_id : integer

The ID of the script associated with this query.

finished_at : string/date-time

The end time of the last run.

exception : string

Exception returned from the query, null if the query was a success.

updated_at : string/time

report_id : integer

The ID of the report associated with this query.

database : integer

The database ID.
list_runs(id, **kwargs)

List runs for the given query

Parameters:

id : integer

The ID of the query.

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 100.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to id. Must be one of: id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

query_id : integer

The ID of the query.

is_cancel_requested : boolean

True if run cancel requested, else false.
post(database, sql, preview_rows, **kwargs)

Execute a query

Parameters:

database : integer

The database ID.

sql : string

The SQL to execute.

preview_rows : integer

The number of rows to save from the query’s result (maximum: 100).

column_delimiter : string, optional

The delimiter to use. One of comma or tab, or pipe [default: comma].

credential : integer, optional

The credential ID.

include_header : boolean, optional

Whether the CSV output should include a header row [default: true].

interactive : boolean, optional

Deprecated and not used.

filename_prefix : string, optional

The output filename prefix.

unquoted : boolean, optional

If true, will not quote fields.

compression : string, optional

The type of compression. One of gzip or zip, or none [default: gzip].

hidden : boolean, optional

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID
Returns:

result_rows : list

A preview of rows returned by the query.

id : integer

The query ID.

filename_prefix : string

The output filename prefix.

last_run_id : integer

The ID of the last run.

column_delimiter : string

The delimiter to use. One of comma or tab, or pipe [default: comma].

created_at : string/time

preview_rows : integer

The number of rows to save from the query’s result (maximum: 100).

result_columns : list

A preview of columns returned by the query.

compression : string

The type of compression. One of gzip or zip, or none [default: gzip].

script_id : integer

The ID of the script associated with this query.

finished_at : string/date-time

The end time of the last run.

updated_at : string/time

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

database : integer

The database ID.

state : string

The state of the last run.

report_id : integer

The ID of the report associated with this query.

unquoted : boolean

If true, will not quote fields.

started_at : string/date-time

The start time of the last run.

credential : integer

The credential ID.

sql : string

The SQL to execute.

include_header : boolean

Whether the CSV output should include a header row [default: true].

interactive : boolean

Deprecated and not used.

exception : string

Exception returned from the query, null if the query was a success.
post_runs(id)

Start a run

Parameters:

id : integer

The ID of the query.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

query_id : integer

The ID of the query.

is_cancel_requested : boolean

True if run cancel requested, else false.
put_scripts(id, script_id)

Update the query’s associated script

Parameters:

id : integer

The query ID.

script_id : integer

The ID of the script associated with this query.
Returns:

state : string

The state of the last run.

result_rows : list

A preview of rows returned by the query.

id : integer

The query ID.

report_id : integer

The ID of the report associated with this query.

last_run_id : integer

The ID of the last run.

started_at : string/date-time

The start time of the last run.

created_at : string/time

sql : string

The SQL to execute.

result_columns : list

A preview of columns returned by the query.

credential : integer

The credential ID.

script_id : integer

The ID of the script associated with this query.

finished_at : string/date-time

The end time of the last run.

exception : string

Exception returned from the query, null if the query was a success.

updated_at : string/time

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

name : string

The name of the query.

database : integer

The database ID.
Reports
class Reports(session, return_type='civis')

Methods

delete_grants(id) Revoke permisstion for this report to perform Civis platform API operations on
delete_projects(id, project_id) Remove a Report from a project
delete_shares_groups(id, group_id) Revoke the permissions a group has on this object
delete_shares_users(id, user_id) Revoke the permissions a user has on this object
get(id) Show a single report
list(**kwargs) List the reports visible to the current user
list_projects(id) List the projects a Report belongs to
list_shares(id) List users and groups permissioned on this object
list_snapshots(id) Get details about the report’s snapshot automation settings
patch(id, **kwargs) Update a report
patch_snapshots(id, **kwargs) Update the report’s snapshot automation settings
post(**kwargs) Create a report
post_grants(id) Grant this report the ability to perform Civis platform API operations on your
post_snapshots(id, **kwargs) Generate and optionally email a snapshot of the specified report
put_archive(id, status) Update the archive status of this object
put_projects(id, project_id) Add a Report to a project
put_shares_groups(id, group_ids, ...) Set the permissions groups has on this object
put_shares_users(id, permission_level, user_ids) Set the permissions users have on this object
delete_grants(id)

Revoke permisstion for this report to perform Civis platform API operations on your behalf

Parameters:

id : integer

The ID of this report.
Returns:

None

Response code 204: success
delete_projects(id, project_id)

Remove a Report from a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
delete_shares_groups(id, group_id)

Revoke the permissions a group has on this object

Parameters:

id : integer

ID of the resource to be revoked

group_id : integer

ID of the group
Returns:

None

Response code 204: success
delete_shares_users(id, user_id)

Revoke the permissions a user has on this object

Parameters:

id : integer

ID of the resource to be revoked

user_id : integer

ID of the user
Returns:

None

Response code 204: success
get(id)

Show a single report

Parameters:

id : integer

The ID of this report.
Returns:

viz_updated_at : string/time

The time that the report’s visualization was last updated.

id : integer

The ID of this report.

job_path : string

The link to details of the job that backs this report.

auth_data_url : string

user : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

app_state : dict

Any application state blob for this report.

finished_at : string/time

The time that the report’s last run finished.

projects : list:

A list of projects containing the report.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

updated_at : string/time

archived : string

The archival status of the requested object(s).

name : string

The name of the report.

state : string

The status of the report’s last run.

api_key_id : integer

The ID of the API key. Can be used for auditing API use by this report.

script : dict:

- id : integer
    The ID for the script.
- sql : string
    The raw SQL query for the script.
- name : string
    The name of the script.

valid_output_file : boolean

Whether the job (a script or a query) that backs the report currently has a valid output file.

template_id : integer

The ID of the template used for this report.

api_key : string

A Civis API key that can be used by this report.

auth_code_url : string

auth_thumbnail_url : string

URL for a thumbnail of the report.

config : string

Any configuration metadata for this report.

tableau_id : integer

provide_api_key : boolean

Whether the report requests an API Key from the report viewer.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.
list(**kwargs)

List the reports visible to the current user

Parameters:

type : string, optional

If specified, return report of these types. It accepts a comma-separated list, possible values are ‘tableau’, ‘other’.

author : string, optional

If specified, return reports from this author. It accepts a comma-separated list of author ids.

template_id : integer, optional

If specified, return reports using the provided Template.

archived : string, optional

The archival status of the requested object(s).

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 50.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to updated_at. Must be one of: updated_at, name, created_at.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

state : string

The status of the report’s last run.

viz_updated_at : string/time

The time that the report’s visualization was last updated.

id : integer

The ID of this report.

job_path : string

The link to details of the job that backs this report.

template_id : integer

The ID of the template used for this report.

user : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

script : dict:

- id : integer
    The ID for the script.
- sql : string
    The raw SQL query for the script.
- name : string
    The name of the script.

created_at : string/time

archived : string

The archival status of the requested object(s).

auth_thumbnail_url : string

URL for a thumbnail of the report.

finished_at : string/time

The time that the report’s last run finished.

projects : list:

A list of projects containing the report.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

updated_at : string/time

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

tableau_id : integer

name : string

The name of the report.
list_projects(id)

List the projects a Report belongs to

Parameters:

id : integer

The ID of the resource.
Returns:

description : string

A description of the project

id : integer

The ID for this project.

auto_share : boolean

archived : string

The archival status of the requested object(s).

updated_at : string/time

name : string

The name of this project.

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.
list_shares(id)

List users and groups permissioned on this object

Parameters:

id : integer

The ID of the object.
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
list_snapshots(id)

Get details about the report’s snapshot automation settings

Parameters:

id : integer

The ID of this report.
Returns:

state : string

The status of the job’s last run.

email_subject : string

Subject for Email.

id : integer

The ID of this report.

parent_id : integer

The ID of the parent job that will trigger this snapshot.

finished_at : string/time

The time that the job’s last run finished.

width : integer

The width of the cropped snapshot image in screen pixels. The default value is 1440 pixels. Minimum value is 600 pixels.

height : integer

The height of the cropped snapshot image in screen pixels. The default value is 900 pixels. Minimum value is 600 pixels.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

recipient_email_addresses : string

Email addresses to send report to, comma separated.

email_template : string

Custom email template.

send_email_on_completion : boolean

Whether the job will send emails on completion.
patch(id, **kwargs)

Update a report

Parameters:

id : integer

The ID of the report to modify.

app_state : dict, optional

The application state blob for this report.

script_id : integer, optional

The ID of the job (a script or a query) used to create this report.

code_body : string, optional

The code for the report visualization.

config : string, optional

template_id : integer, optional

The ID of the template used for this report. If null is passed, no template will back this report. Changes to the backing template will reset the report appState.

provide_api_key : boolean, optional

Allow the report to provide an API key to front-end code.

name : string, optional

The name of the report.
Returns:

viz_updated_at : string/time

The time that the report’s visualization was last updated.

id : integer

The ID of this report.

job_path : string

The link to details of the job that backs this report.

auth_data_url : string

user : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

app_state : dict

Any application state blob for this report.

finished_at : string/time

The time that the report’s last run finished.

projects : list:

A list of projects containing the report.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

updated_at : string/time

archived : string

The archival status of the requested object(s).

name : string

The name of the report.

state : string

The status of the report’s last run.

api_key_id : integer

The ID of the API key. Can be used for auditing API use by this report.

script : dict:

- id : integer
    The ID for the script.
- sql : string
    The raw SQL query for the script.
- name : string
    The name of the script.

valid_output_file : boolean

Whether the job (a script or a query) that backs the report currently has a valid output file.

template_id : integer

The ID of the template used for this report.

api_key : string

A Civis API key that can be used by this report.

auth_code_url : string

auth_thumbnail_url : string

URL for a thumbnail of the report.

config : string

Any configuration metadata for this report.

tableau_id : integer

provide_api_key : boolean

Whether the report requests an API Key from the report viewer.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.
patch_snapshots(id, **kwargs)

Update the report’s snapshot automation settings

Parameters:

id : integer

The ID of this report.

state : string, optional

The status of the job’s last run.

email_subject : string, optional

Subject for Email.

parent_id : integer, optional

The ID of the parent job that will trigger this snapshot.

finished_at : string/time, optional

The time that the job’s last run finished.

width : integer, optional

The width of the cropped snapshot image in screen pixels. The default value is 1440 pixels. Minimum value is 600 pixels.

height : integer, optional

The height of the cropped snapshot image in screen pixels. The default value is 900 pixels. Minimum value is 600 pixels.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

send_email_on_completion : boolean, optional

Whether the job will send emails on completion.

email_template : string, optional

Custom email template.

recipient_email_addresses : string, optional

Email addresses to send report to, comma separated.
Returns:

state : string

The status of the job’s last run.

email_subject : string

Subject for Email.

id : integer

The ID of this report.

parent_id : integer

The ID of the parent job that will trigger this snapshot.

finished_at : string/time

The time that the job’s last run finished.

width : integer

The width of the cropped snapshot image in screen pixels. The default value is 1440 pixels. Minimum value is 600 pixels.

height : integer

The height of the cropped snapshot image in screen pixels. The default value is 900 pixels. Minimum value is 600 pixels.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

recipient_email_addresses : string

Email addresses to send report to, comma separated.

email_template : string

Custom email template.

send_email_on_completion : boolean

Whether the job will send emails on completion.
post(**kwargs)

Create a report

Parameters:

app_state : dict, optional

Any application state blob for this report.

script_id : integer, optional

The ID of the job (a script or a query) used to create this report.

code_body : string, optional

The code for the report visualization.

template_id : integer, optional

The ID of the template used for this report.

provide_api_key : boolean, optional

Allow the report to provide an API key to front-end code.

hidden : boolean, optional

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

name : string, optional

The name of the report.
Returns:

viz_updated_at : string/time

The time that the report’s visualization was last updated.

id : integer

The ID of this report.

job_path : string

The link to details of the job that backs this report.

auth_data_url : string

user : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

app_state : dict

Any application state blob for this report.

finished_at : string/time

The time that the report’s last run finished.

projects : list:

A list of projects containing the report.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

updated_at : string/time

archived : string

The archival status of the requested object(s).

name : string

The name of the report.

state : string

The status of the report’s last run.

api_key_id : integer

The ID of the API key. Can be used for auditing API use by this report.

script : dict:

- id : integer
    The ID for the script.
- sql : string
    The raw SQL query for the script.
- name : string
    The name of the script.

valid_output_file : boolean

Whether the job (a script or a query) that backs the report currently has a valid output file.

template_id : integer

The ID of the template used for this report.

api_key : string

A Civis API key that can be used by this report.

auth_code_url : string

auth_thumbnail_url : string

URL for a thumbnail of the report.

config : string

Any configuration metadata for this report.

tableau_id : integer

provide_api_key : boolean

Whether the report requests an API Key from the report viewer.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.
post_grants(id)

Grant this report the ability to perform Civis platform API operations on your behalf

Parameters:

id : integer

The ID of this report.
Returns:

viz_updated_at : string/time

The time that the report’s visualization was last updated.

id : integer

The ID of this report.

job_path : string

The link to details of the job that backs this report.

auth_data_url : string

user : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

app_state : dict

Any application state blob for this report.

finished_at : string/time

The time that the report’s last run finished.

projects : list:

A list of projects containing the report.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

updated_at : string/time

archived : string

The archival status of the requested object(s).

name : string

The name of the report.

state : string

The status of the report’s last run.

api_key_id : integer

The ID of the API key. Can be used for auditing API use by this report.

script : dict:

- id : integer
    The ID for the script.
- sql : string
    The raw SQL query for the script.
- name : string
    The name of the script.

valid_output_file : boolean

Whether the job (a script or a query) that backs the report currently has a valid output file.

template_id : integer

The ID of the template used for this report.

api_key : string

A Civis API key that can be used by this report.

auth_code_url : string

auth_thumbnail_url : string

URL for a thumbnail of the report.

config : string

Any configuration metadata for this report.

tableau_id : integer

provide_api_key : boolean

Whether the report requests an API Key from the report viewer.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.
post_snapshots(id, **kwargs)

Generate and optionally email a snapshot of the specified report

Parameters:

id : integer

The ID of this report.

state : string, optional

The status of the job’s last run.

email_subject : string, optional

Subject for Email.

parent_id : integer, optional

The ID of the parent job that will trigger this snapshot.

finished_at : string/time, optional

The time that the job’s last run finished.

width : integer, optional

The width of the cropped snapshot image in screen pixels. The default value is 1440 pixels. Minimum value is 600 pixels.

height : integer, optional

The height of the cropped snapshot image in screen pixels. The default value is 900 pixels. Minimum value is 600 pixels.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

send_email_on_completion : boolean, optional

Whether the job will send emails on completion.

email_template : string, optional

Custom email template.

recipient_email_addresses : string, optional

Email addresses to send report to, comma separated.
Returns:

state : string

The status of the job’s last run.

email_subject : string

Subject for Email.

id : integer

The ID of this report.

parent_id : integer

The ID of the parent job that will trigger this snapshot.

finished_at : string/time

The time that the job’s last run finished.

width : integer

The width of the cropped snapshot image in screen pixels. The default value is 1440 pixels. Minimum value is 600 pixels.

height : integer

The height of the cropped snapshot image in screen pixels. The default value is 900 pixels. Minimum value is 600 pixels.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

recipient_email_addresses : string

Email addresses to send report to, comma separated.

email_template : string

Custom email template.

send_email_on_completion : boolean

Whether the job will send emails on completion.
put_archive(id, status)

Update the archive status of this object

Parameters:

id : integer

The ID of the object.

status : boolean

The desired archived status of the object.
Returns:

viz_updated_at : string/time

The time that the report’s visualization was last updated.

id : integer

The ID of this report.

job_path : string

The link to details of the job that backs this report.

auth_data_url : string

user : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

app_state : dict

Any application state blob for this report.

finished_at : string/time

The time that the report’s last run finished.

projects : list:

A list of projects containing the report.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

updated_at : string/time

archived : string

The archival status of the requested object(s).

name : string

The name of the report.

state : string

The status of the report’s last run.

api_key_id : integer

The ID of the API key. Can be used for auditing API use by this report.

script : dict:

- id : integer
    The ID for the script.
- sql : string
    The raw SQL query for the script.
- name : string
    The name of the script.

valid_output_file : boolean

Whether the job (a script or a query) that backs the report currently has a valid output file.

template_id : integer

The ID of the template used for this report.

api_key : string

A Civis API key that can be used by this report.

auth_code_url : string

auth_thumbnail_url : string

URL for a thumbnail of the report.

config : string

Any configuration metadata for this report.

tableau_id : integer

provide_api_key : boolean

Whether the report requests an API Key from the report viewer.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.
put_projects(id, project_id)

Add a Report to a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
put_shares_groups(id, group_ids, permission_level)

Set the permissions groups has on this object

Parameters:

id : integer

ID of the resource to be shared

group_ids : list

An array of one or more group IDs

permission_level : string

Options are: “read”, “write”, or “manage”
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_shares_users(id, permission_level, user_ids)

Set the permissions users have on this object

Parameters:

id : integer

ID of the resource to be shared

permission_level : string

Options are: “read”, “write”, or “manage”

user_ids : list

An array of one or more user IDs
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
Scripts
class Scripts(session, return_type='civis')

Methods

delete_containers_projects(id, project_id) Remove a container docker from a project
delete_containers_runs(id, run_id) Cancel a run
delete_containers_shares_groups(id, group_id) Revoke the permissions a group has on this object
delete_containers_shares_users(id, user_id) Revoke the permissions a user has on this object
delete_custom_projects(id, project_id) Remove a Job from a project
delete_custom_runs(id, run_id) Cancel a run
delete_custom_shares_groups(id, group_id) Revoke the permissions a group has on this object
delete_custom_shares_users(id, user_id) Revoke the permissions a user has on this object
delete_javascript_projects(id, project_id) Remove a scripted sql from a project
delete_javascript_runs(id, run_id) Cancel a run
delete_javascript_shares_groups(id, group_id) Revoke the permissions a group has on this object
delete_javascript_shares_users(id, user_id) Revoke the permissions a user has on this object
delete_python3_projects(id, project_id) Remove a python docker from a project
delete_python3_runs(id, run_id) Cancel a run
delete_python3_shares_groups(id, group_id) Revoke the permissions a group has on this object
delete_python3_shares_users(id, user_id) Revoke the permissions a user has on this object
delete_r_projects(id, project_id) Remove a r docker from a project
delete_r_runs(id, run_id) Cancel a run
delete_r_shares_groups(id, group_id) Revoke the permissions a group has on this object
delete_r_shares_users(id, user_id) Revoke the permissions a user has on this object
delete_sql_projects(id, project_id) Remove a scripts from a project
delete_sql_runs(id, run_id) Cancel a run
delete_sql_shares_groups(id, group_id) Revoke the permissions a group has on this object
delete_sql_shares_users(id, user_id) Revoke the permissions a user has on this object
get(id) Get details about a script
get_containers(id) View a container
get_containers_runs(id, run_id) Check status of a run
get_custom(id) Get a CustomScript
get_custom_runs(id, run_id) Check status of a run
get_javascript(id) Get a JavaScript Script
get_javascript_runs(id, run_id) Check status of a run
get_python3(id) Get a Python Script
get_python3_runs(id, run_id) Check status of a run
get_r(id) Get an R Script
get_r_runs(id, run_id) Check status of a run
get_sql(id) Get a SQL script
get_sql_runs(id, run_id) Check status of a run
list(**kwargs) List scripts
list_containers_projects(id) List the projects a container docker belongs to
list_containers_runs(id, **kwargs) List runs for the given container
list_containers_runs_logs(id, run_id, **kwargs) Get the logs for a run
list_containers_runs_outputs(id, run_id, ...) List the outputs for a run
list_containers_shares(id) List users and groups permissioned on this object
list_custom(**kwargs) List Custom Scripts
list_custom_projects(id) List the projects a Job belongs to
list_custom_runs(id, **kwargs) List runs for the given custom
list_custom_runs_logs(id, run_id, **kwargs) Get the logs for a run
list_custom_runs_outputs(id, run_id, **kwargs) List the outputs for a run
list_custom_shares(id) List users and groups permissioned on this object
list_history(id) Get the run history and outputs of this script
list_javascript_projects(id) List the projects a scripted sql belongs to
list_javascript_runs(id, **kwargs) List runs for the given javascript
list_javascript_runs_logs(id, run_id, **kwargs) Get the logs for a run
list_javascript_runs_outputs(id, run_id, ...) List the outputs for a run
list_javascript_shares(id) List users and groups permissioned on this object
list_python3_projects(id) List the projects a python docker belongs to
list_python3_runs(id, **kwargs) List runs for the given python
list_python3_runs_logs(id, run_id, **kwargs) Get the logs for a run
list_python3_runs_outputs(id, run_id, **kwargs) List the outputs for a run
list_python3_shares(id) List users and groups permissioned on this object
list_r_projects(id) List the projects a r docker belongs to
list_r_runs(id, **kwargs) List runs for the given r
list_r_runs_logs(id, run_id, **kwargs) Get the logs for a run
list_r_runs_outputs(id, run_id, **kwargs) List the outputs for a run
list_r_shares(id) List users and groups permissioned on this object
list_sql_projects(id) List the projects a scripts belongs to
list_sql_runs(id, **kwargs) List runs for the given sql
list_sql_runs_logs(id, run_id, **kwargs) Get the logs for a run
list_sql_runs_outputs(id, run_id, **kwargs) List the outputs for a run
list_sql_shares(id) List users and groups permissioned on this object
list_types() List available script types
patch(id, **kwargs) Update a script
patch_containers(id, **kwargs) Update a container
patch_containers_runs(id, run_id, **kwargs) Update a run
patch_custom(id, **kwargs) Update some attributes of this CustomScript
patch_javascript(id, **kwargs) Update some attributes of this JavaScript Script
patch_python3(id, **kwargs) Update some attributes of this Python Script
patch_r(id, **kwargs) Update some attributes of this R Script
patch_sql(id, **kwargs) Update some attributes of this SQL script
post(credential_id, remote_host_id, name, ...) Create a script
post_cancel(id) Cancel a run
post_containers(docker_command, ...) Create a container
post_containers_runs(id) Start a run
post_containers_runs_heartbeats(id, run_id) Indicate that the given run is being handled
post_containers_runs_logs(id, run_id, **kwargs) Add log messages
post_containers_runs_outputs(id, run_id, ...) Add an output for a run
post_custom(from_template_id, **kwargs) Create a CustomScript
post_custom_runs(id) Start a run
post_custom_runs_outputs(id, run_id, ...) Add an output for a run
post_javascript(credential_id, source, name, ...) Create a JavaScript Script
post_javascript_runs(id) Start a run
post_javascript_runs_outputs(id, run_id, ...) Add an output for a run
post_python3(source, name, **kwargs) Create a Python Script
post_python3_runs(id) Start a run
post_python3_runs_outputs(id, run_id, ...) Add an output for a run
post_r(source, name, **kwargs) Create an R Script
post_r_runs(id) Start a run
post_r_runs_outputs(id, run_id, object_id, ...) Add an output for a run
post_run(id) Run a script
post_sql(sql, credential_id, remote_host_id, ...) Create a SQL script
post_sql_runs(id) Start a run
put_containers(id, docker_command, ...) Edit a container
put_containers_archive(id, status) Update the archive status of this object
put_containers_projects(id, project_id) Add a container docker to a project
put_containers_shares_groups(id, group_ids, ...) Set the permissions groups has on this object
put_containers_shares_users(id, ...) Set the permissions users have on this object
put_custom(id, **kwargs) Replace all attributes of this CustomScript
put_custom_archive(id, status) Update the archive status of this object
put_custom_projects(id, project_id) Add a Job to a project
put_custom_shares_groups(id, group_ids, ...) Set the permissions groups has on this object
put_custom_shares_users(id, ...) Set the permissions users have on this object
put_javascript(id, credential_id, source, ...) Replace all attributes of this JavaScript Script
put_javascript_archive(id, status) Update the archive status of this object
put_javascript_projects(id, project_id) Add a scripted sql to a project
put_javascript_shares_groups(id, group_ids, ...) Set the permissions groups has on this object
put_javascript_shares_users(id, ...) Set the permissions users have on this object
put_python3(id, source, name, **kwargs) Replace all attributes of this Python Script
put_python3_archive(id, status) Update the archive status of this object
put_python3_projects(id, project_id) Add a python docker to a project
put_python3_shares_groups(id, group_ids, ...) Set the permissions groups has on this object
put_python3_shares_users(id, ...) Set the permissions users have on this object
put_r(id, source, name, **kwargs) Replace all attributes of this R Script
put_r_archive(id, status) Update the archive status of this object
put_r_projects(id, project_id) Add a r docker to a project
put_r_shares_groups(id, group_ids, ...) Set the permissions groups has on this object
put_r_shares_users(id, permission_level, ...) Set the permissions users have on this object
put_sql(id, sql, credential_id, ...) Replace all attributes of this SQL script
put_sql_archive(id, status) Update the archive status of this object
put_sql_projects(id, project_id) Add a scripts to a project
put_sql_shares_groups(id, group_ids, ...) Set the permissions groups has on this object
put_sql_shares_users(id, permission_level, ...) Set the permissions users have on this object
delete_containers_projects(id, project_id)

Remove a container docker from a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
delete_containers_runs(id, run_id)

Cancel a run

Parameters:

id : integer

The ID of the container.

run_id : integer

The ID of the run.
Returns:

None

Response code 202: success
delete_containers_shares_groups(id, group_id)

Revoke the permissions a group has on this object

Parameters:

id : integer

ID of the resource to be revoked

group_id : integer

ID of the group
Returns:

None

Response code 204: success
delete_containers_shares_users(id, user_id)

Revoke the permissions a user has on this object

Parameters:

id : integer

ID of the resource to be revoked

user_id : integer

ID of the user
Returns:

None

Response code 204: success
delete_custom_projects(id, project_id)

Remove a Job from a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
delete_custom_runs(id, run_id)

Cancel a run

Parameters:

id : integer

The ID of the custom.

run_id : integer

The ID of the run.
Returns:

None

Response code 202: success
delete_custom_shares_groups(id, group_id)

Revoke the permissions a group has on this object

Parameters:

id : integer

ID of the resource to be revoked

group_id : integer

ID of the group
Returns:

None

Response code 204: success
delete_custom_shares_users(id, user_id)

Revoke the permissions a user has on this object

Parameters:

id : integer

ID of the resource to be revoked

user_id : integer

ID of the user
Returns:

None

Response code 204: success
delete_javascript_projects(id, project_id)

Remove a scripted sql from a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
delete_javascript_runs(id, run_id)

Cancel a run

Parameters:

id : integer

The ID of the javascript.

run_id : integer

The ID of the run.
Returns:

None

Response code 202: success
delete_javascript_shares_groups(id, group_id)

Revoke the permissions a group has on this object

Parameters:

id : integer

ID of the resource to be revoked

group_id : integer

ID of the group
Returns:

None

Response code 204: success
delete_javascript_shares_users(id, user_id)

Revoke the permissions a user has on this object

Parameters:

id : integer

ID of the resource to be revoked

user_id : integer

ID of the user
Returns:

None

Response code 204: success
delete_python3_projects(id, project_id)

Remove a python docker from a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
delete_python3_runs(id, run_id)

Cancel a run

Parameters:

id : integer

The ID of the python.

run_id : integer

The ID of the run.
Returns:

None

Response code 202: success
delete_python3_shares_groups(id, group_id)

Revoke the permissions a group has on this object

Parameters:

id : integer

ID of the resource to be revoked

group_id : integer

ID of the group
Returns:

None

Response code 204: success
delete_python3_shares_users(id, user_id)

Revoke the permissions a user has on this object

Parameters:

id : integer

ID of the resource to be revoked

user_id : integer

ID of the user
Returns:

None

Response code 204: success
delete_r_projects(id, project_id)

Remove a r docker from a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
delete_r_runs(id, run_id)

Cancel a run

Parameters:

id : integer

The ID of the r.

run_id : integer

The ID of the run.
Returns:

None

Response code 202: success
delete_r_shares_groups(id, group_id)

Revoke the permissions a group has on this object

Parameters:

id : integer

ID of the resource to be revoked

group_id : integer

ID of the group
Returns:

None

Response code 204: success
delete_r_shares_users(id, user_id)

Revoke the permissions a user has on this object

Parameters:

id : integer

ID of the resource to be revoked

user_id : integer

ID of the user
Returns:

None

Response code 204: success
delete_sql_projects(id, project_id)

Remove a scripts from a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
delete_sql_runs(id, run_id)

Cancel a run

Parameters:

id : integer

The ID of the sql.

run_id : integer

The ID of the run.
Returns:

None

Response code 202: success
delete_sql_shares_groups(id, group_id)

Revoke the permissions a group has on this object

Parameters:

id : integer

ID of the resource to be revoked

group_id : integer

ID of the group
Returns:

None

Response code 204: success
delete_sql_shares_users(id, user_id)

Revoke the permissions a user has on this object

Parameters:

id : integer

ID of the resource to be revoked

user_id : integer

ID of the user
Returns:

None

Response code 204: success
get(id)

Get details about a script

Parameters:

id : integer

The ID for the script.
Returns:

id : integer

The ID for the script.

expanded_arguments : dict

Expanded arguments for use in injecting into different environments.

template_script_id : integer

The ID of the template script, if any.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time this script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

sql : string

The raw SQL query for the script.

type : string

The type of script.

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
get_containers(id)

View a container

Parameters:

id : integer

The ID for the script.
Returns:

id : integer

The ID for the script.

remote_host_credential_id : integer

The id of the database credentials to pass into the environment of the container.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

docker_command : string

The command to run on the container. Will be run via sh as: [“sh”, “-c”, dockerCommand]

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template script.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

docker_image_name : string

The name of the docker image to pull from DockerHub.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

archived : string

The archival status of the requested object(s).

repo_http_uri : string

The location of a github repo to clone into the container, e.g. github.com/my-user/my-repo.git.

name : string

The name of the container.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

docker_image_tag : string

The tag of the docker image to pull from DockerHub (default: latest).

git_credential_id : integer

The id of the git credential to be used when checking out the specified git repo. If not supplied, the first git credential you’ve submitted will be used. Unnecessary if no git repo is specified or the git repo is public.

repo_ref : string

The tag or branch of the github repo to clone into the container.

type : string

The type of the script (e.g Container)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB).
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
get_containers_runs(id, run_id)

Check status of a run

Parameters:

id : integer

The ID of the container.

run_id : integer

The ID of the run.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

container_id : integer

The ID of the container.

finished_at : string/time

The time the last run completed.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
get_custom(id)

Get a CustomScript

Parameters:

id : integer
Returns:

id : integer

The ID for the script.

time_zone : string

The time zone of this script.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

finished_at : string/time

The time that the script’s last run finished.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

code_preview : string

The code that this script will run with arguments inserted.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

credential_id : integer

The credential that this script will use.

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

type : string

The type of the script (e.g Custom)

remote_host_id : integer

The remote host ID that this script will connect to.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
get_custom_runs(id, run_id)

Check status of a run

Parameters:

id : integer

The ID of the custom.

run_id : integer

The ID of the run.
Returns:

custom_id : integer

The ID of the custom.

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
get_javascript(id)

Get a JavaScript Script

Parameters:

id : integer
Returns:

id : integer

The ID for the script.

credential_id : integer

The credential that this script will use.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

remote_host_id : integer

The remote host ID that this script will connect to.

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

source : string

The body/text of the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
get_javascript_runs(id, run_id)

Check status of a run

Parameters:

id : integer

The ID of the javascript.

run_id : integer

The ID of the run.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

javascript_id : integer

The ID of the javascript.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
get_python3(id)

Get a Python Script

Parameters:

id : integer
Returns:

id : integer

The ID for the script.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

source : string

The body/text of the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
get_python3_runs(id, run_id)

Check status of a run

Parameters:

id : integer

The ID of the python.

run_id : integer

The ID of the run.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

python_id : integer

The ID of the python.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
get_r(id)

Get an R Script

Parameters:

id : integer
Returns:

id : integer

The ID for the script.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

source : string

The body/text of the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
get_r_runs(id, run_id)

Check status of a run

Parameters:

id : integer

The ID of the r.

run_id : integer

The ID of the run.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

r_id : integer

The ID of the r.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
get_sql(id)

Get a SQL script

Parameters:

id : integer
Returns:

id : integer

The ID for the script.

expanded_arguments : dict

Expanded arguments for use in injecting into different environments.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

code_preview : string

The code that this script will run with arguments inserted.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

credential_id : integer

The credential that this script will use.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

remote_host_id : integer

The remote host ID that this script will connect to.

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

csv_settings : dict:

- compression : string
    The type of compression to use, if any, one of "none", "zip", or
    "gzip". Default: gzip
- include_header : boolean
    Whether or not to include headers in the output data. Default: true
- filename_prefix : string
    A user specified filename prefix for the output file to have. Default:
    null
- unquoted : boolean
    Whether or not to quote fields. Default: false
- force_multifile : boolean
    Whether or not the csv should be split into multiple files. Default:
    false
- column_delimiter : string
    Which delimiter to use, one of "comma", "tab", or "pipe". Default:
    comma

next_run_at : string/time

The time of the next scheduled run.

sql : string

The raw SQL query for the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
get_sql_runs(id, run_id)

Check status of a run

Parameters:

id : integer

The ID of the sql.

run_id : integer

The ID of the run.
Returns:

state : string

The state of this run.

id : integer

The ID of this run.

output : list:

A list of the outputs of this script.
- output_name : string
    The name of the output file.
- file_id : integer
    The unique ID of the output file.
- path : string
    The temporary link to download this output file, valid for 36 hours.

finished_at : string/time

The time that this run finished.

sql_id : integer

The ID of this sql.

started_at : string/time

The time the last run started.

error : string

The error message for this run, if present.

is_cancel_requested : boolean

True if run cancel requested, else false.
list(**kwargs)

List scripts

Parameters:

type : string, optional

If specified, return objects of these types. The valid types are ‘sql’, ‘python3’, ‘r’, and ‘javascript’.

author : string, optional

If specified, return objects from this author. Must use user IDs. A comma separated list of IDs is also accepted to return objects from multiple authors.

status : string, optional

If specified, returns objects with one of these statuses. It accepts a comma-separated list, possible values are ‘running’, ‘failed’, ‘succeeded’, ‘idle’, ‘scheduled’.

archived : string, optional

The archival status of the requested object(s).

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 50.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to updated_at. Must be one of: updated_at, name, created_at, last_run.updated_at.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

id : integer

The ID for the script.

from_template_id : integer

The ID of the template this script uses, if any.

template_script_id : integer

The ID of the template script, if any.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

parent_id : integer

The ID of the parent job that will trigger this script

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

archived : string

The archival status of the requested object(s).

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

updated_at : string/time

The time the script was last updated.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

name : string

The name of the script.
list_containers_projects(id)

List the projects a container docker belongs to

Parameters:

id : integer

The ID of the resource.
Returns:

description : string

A description of the project

id : integer

The ID for this project.

auto_share : boolean

archived : string

The archival status of the requested object(s).

updated_at : string/time

name : string

The name of this project.

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.
list_containers_runs(id, **kwargs)

List runs for the given container

Parameters:

id : integer

The ID of the container.

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 100.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to id. Must be one of: id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

container_id : integer

The ID of the container.

finished_at : string/time

The time the last run completed.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
list_containers_runs_logs(id, run_id, **kwargs)

Get the logs for a run

Parameters:

id : integer

The ID of the container.

run_id : integer

The ID of the run.

last_id : integer, optional

The ID of the last log message received. Log entries with this ID value or lower will be omitted.Logs are sorted by ID if this value is provided, and are otherwise sorted by createdAt.

limit : integer, optional

The maximum number of log messages to return. Default of 10000.
Returns:

level : string

The level of the log. One of unknown,fatal,error,warn,info,debug.

id : integer

The ID of the log.

created_at : string/date-time

The time the log was created.

message : string

The log message.
list_containers_runs_outputs(id, run_id, **kwargs)

List the outputs for a run

Parameters:

id : integer

The ID of the output.

run_id : integer

The ID of the run.

limit : integer, optional

Number of results to return. Defaults to its maximum of 50.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to created_at. Must be one of: created_at, id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

link : string

The link to retrieve the output object.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project

name : string

The name of the output object.
list_containers_shares(id)

List users and groups permissioned on this object

Parameters:

id : integer

The ID of the object.
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
list_custom(**kwargs)

List Custom Scripts

Parameters:

from_template_id : integer, optional

The template script that this app uses.

author : string, optional

If specified, return objects from this author. Must use user IDs. A comma separated list of IDs is also accepted to return objects from multiple authors.

status : string, optional

If specified, returns objects with one of these statuses. It accepts a comma-separated list, possible values are ‘running’, ‘failed’, ‘succeeded’, ‘idle’, ‘scheduled’.

archived : string, optional

The archival status of the requested object(s).

limit : integer, optional

Number of results to return. Defaults to its maximum of 50.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to updated_at. Must be one of: updated_at, name, created_at.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to asc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

id : integer

The ID for the script.

parent_id : integer

The ID of the parent job that will trigger this script

from_template_id : integer

The ID of the template script.

created_at : string/time

The time this script was created.

archived : string

The archival status of the requested object(s).

finished_at : string/time

The time that the script’s last run finished.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

type : string

The type of the script (e.g Custom)

updated_at : string/time

The time the script was last updated.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

name : string

The name of the script.
list_custom_projects(id)

List the projects a Job belongs to

Parameters:

id : integer

The ID of the resource.
Returns:

description : string

A description of the project

id : integer

The ID for this project.

auto_share : boolean

archived : string

The archival status of the requested object(s).

updated_at : string/time

name : string

The name of this project.

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.
list_custom_runs(id, **kwargs)

List runs for the given custom

Parameters:

id : integer

The ID of the custom.

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 100.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to id. Must be one of: id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

custom_id : integer

The ID of the custom.

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
list_custom_runs_logs(id, run_id, **kwargs)

Get the logs for a run

Parameters:

id : integer

The ID of the custom.

run_id : integer

The ID of the run.

last_id : integer, optional

The ID of the last log message received. Log entries with this ID value or lower will be omitted.Logs are sorted by ID if this value is provided, and are otherwise sorted by createdAt.

limit : integer, optional

The maximum number of log messages to return. Default of 10000.
Returns:

level : string

The level of the log. One of unknown,fatal,error,warn,info,debug.

id : integer

The ID of the log.

created_at : string/date-time

The time the log was created.

message : string

The log message.
list_custom_runs_outputs(id, run_id, **kwargs)

List the outputs for a run

Parameters:

id : integer

The ID of the output.

run_id : integer

The ID of the run.

limit : integer, optional

Number of results to return. Defaults to its maximum of 50.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to created_at. Must be one of: created_at, id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

link : string

The link to retrieve the output object.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project

name : string

The name of the output object.
list_custom_shares(id)

List users and groups permissioned on this object

Parameters:

id : integer

The ID of the object.
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
list_history(id)

Get the run history and outputs of this script

Parameters:

id : integer

The ID for the script.
Returns:

state : string

The state of this run.

id : integer

The ID of this run.

output : list:

A list of the outputs of this script.
- output_name : string
    The name of the output file.
- file_id : integer
    The unique ID of the output file.
- path : string
    The temporary link to download this output file, valid for 36 hours.

finished_at : string/time

The time that this run finished.

sql_id : integer

The ID of this sql.

error : string

The error message for this run, if present.

is_cancel_requested : boolean

True if run cancel requested, else false.
list_javascript_projects(id)

List the projects a scripted sql belongs to

Parameters:

id : integer

The ID of the resource.
Returns:

description : string

A description of the project

id : integer

The ID for this project.

auto_share : boolean

archived : string

The archival status of the requested object(s).

updated_at : string/time

name : string

The name of this project.

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.
list_javascript_runs(id, **kwargs)

List runs for the given javascript

Parameters:

id : integer

The ID of the javascript.

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 100.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to id. Must be one of: id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

javascript_id : integer

The ID of the javascript.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
list_javascript_runs_logs(id, run_id, **kwargs)

Get the logs for a run

Parameters:

id : integer

The ID of the javascript.

run_id : integer

The ID of the run.

last_id : integer, optional

The ID of the last log message received. Log entries with this ID value or lower will be omitted.Logs are sorted by ID if this value is provided, and are otherwise sorted by createdAt.

limit : integer, optional

The maximum number of log messages to return. Default of 10000.
Returns:

level : string

The level of the log. One of unknown,fatal,error,warn,info,debug.

id : integer

The ID of the log.

created_at : string/date-time

The time the log was created.

message : string

The log message.
list_javascript_runs_outputs(id, run_id, **kwargs)

List the outputs for a run

Parameters:

id : integer

The ID of the output.

run_id : integer

The ID of the run.

limit : integer, optional

Number of results to return. Defaults to its maximum of 50.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to created_at. Must be one of: created_at, id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

link : string

The link to retrieve the output object.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project

name : string

The name of the output object.
list_javascript_shares(id)

List users and groups permissioned on this object

Parameters:

id : integer

The ID of the object.
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
list_python3_projects(id)

List the projects a python docker belongs to

Parameters:

id : integer

The ID of the resource.
Returns:

description : string

A description of the project

id : integer

The ID for this project.

auto_share : boolean

archived : string

The archival status of the requested object(s).

updated_at : string/time

name : string

The name of this project.

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.
list_python3_runs(id, **kwargs)

List runs for the given python

Parameters:

id : integer

The ID of the python.

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 100.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to id. Must be one of: id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

python_id : integer

The ID of the python.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
list_python3_runs_logs(id, run_id, **kwargs)

Get the logs for a run

Parameters:

id : integer

The ID of the python.

run_id : integer

The ID of the run.

last_id : integer, optional

The ID of the last log message received. Log entries with this ID value or lower will be omitted.Logs are sorted by ID if this value is provided, and are otherwise sorted by createdAt.

limit : integer, optional

The maximum number of log messages to return. Default of 10000.
Returns:

level : string

The level of the log. One of unknown,fatal,error,warn,info,debug.

id : integer

The ID of the log.

created_at : string/date-time

The time the log was created.

message : string

The log message.
list_python3_runs_outputs(id, run_id, **kwargs)

List the outputs for a run

Parameters:

id : integer

The ID of the output.

run_id : integer

The ID of the run.

limit : integer, optional

Number of results to return. Defaults to its maximum of 50.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to created_at. Must be one of: created_at, id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

link : string

The link to retrieve the output object.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project

name : string

The name of the output object.
list_python3_shares(id)

List users and groups permissioned on this object

Parameters:

id : integer

The ID of the object.
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
list_r_projects(id)

List the projects a r docker belongs to

Parameters:

id : integer

The ID of the resource.
Returns:

description : string

A description of the project

id : integer

The ID for this project.

auto_share : boolean

archived : string

The archival status of the requested object(s).

updated_at : string/time

name : string

The name of this project.

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.
list_r_runs(id, **kwargs)

List runs for the given r

Parameters:

id : integer

The ID of the r.

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 100.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to id. Must be one of: id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

r_id : integer

The ID of the r.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
list_r_runs_logs(id, run_id, **kwargs)

Get the logs for a run

Parameters:

id : integer

The ID of the r.

run_id : integer

The ID of the run.

last_id : integer, optional

The ID of the last log message received. Log entries with this ID value or lower will be omitted.Logs are sorted by ID if this value is provided, and are otherwise sorted by createdAt.

limit : integer, optional

The maximum number of log messages to return. Default of 10000.
Returns:

level : string

The level of the log. One of unknown,fatal,error,warn,info,debug.

id : integer

The ID of the log.

created_at : string/date-time

The time the log was created.

message : string

The log message.
list_r_runs_outputs(id, run_id, **kwargs)

List the outputs for a run

Parameters:

id : integer

The ID of the output.

run_id : integer

The ID of the run.

limit : integer, optional

Number of results to return. Defaults to its maximum of 50.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to created_at. Must be one of: created_at, id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

link : string

The link to retrieve the output object.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project

name : string

The name of the output object.
list_r_shares(id)

List users and groups permissioned on this object

Parameters:

id : integer

The ID of the object.
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
list_sql_projects(id)

List the projects a scripts belongs to

Parameters:

id : integer

The ID of the resource.
Returns:

description : string

A description of the project

id : integer

The ID for this project.

auto_share : boolean

archived : string

The archival status of the requested object(s).

updated_at : string/time

name : string

The name of this project.

users : list:

Users who can see the project
- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

created_at : string/time

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.
list_sql_runs(id, **kwargs)

List runs for the given sql

Parameters:

id : integer

The ID of the sql.

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 100.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to id. Must be one of: id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

state : string

The state of this run.

id : integer

The ID of this run.

output : list:

A list of the outputs of this script.
- output_name : string
    The name of the output file.
- file_id : integer
    The unique ID of the output file.
- path : string
    The temporary link to download this output file, valid for 36 hours.

finished_at : string/time

The time that this run finished.

sql_id : integer

The ID of this sql.

started_at : string/time

The time the last run started.

error : string

The error message for this run, if present.

is_cancel_requested : boolean

True if run cancel requested, else false.
list_sql_runs_logs(id, run_id, **kwargs)

Get the logs for a run

Parameters:

id : integer

The ID of the sql.

run_id : integer

The ID of the run.

last_id : integer, optional

The ID of the last log message received. Log entries with this ID value or lower will be omitted.Logs are sorted by ID if this value is provided, and are otherwise sorted by createdAt.

limit : integer, optional

The maximum number of log messages to return. Default of 10000.
Returns:

level : string

The level of the log. One of unknown,fatal,error,warn,info,debug.

id : integer

The ID of the log.

created_at : string/date-time

The time the log was created.

message : string

The log message.
list_sql_runs_outputs(id, run_id, **kwargs)

List the outputs for a run

Parameters:

id : integer

The ID of the output.

run_id : integer

The ID of the run.

limit : integer, optional

Number of results to return. Defaults to its maximum of 50.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to created_at. Must be one of: created_at, id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

link : string

The link to retrieve the output object.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project

name : string

The name of the output object.
list_sql_shares(id)

List users and groups permissioned on this object

Parameters:

id : integer

The ID of the object.
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
list_types()

List available script types

Returns:

name : string

The name of the type.
patch(id, **kwargs)

Update a script

Parameters:

id : integer

The ID for the script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

template_script_id : integer, optional

The ID of the template script, if any. A script cannot both have a template script and be a template for other scripts.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
Cannot be set if this script uses a template script.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

name : string, optional

The name of the script.

sql : string, optional

The raw SQL query for the script.
Returns:

id : integer

The ID for the script.

expanded_arguments : dict

Expanded arguments for use in injecting into different environments.

template_script_id : integer

The ID of the template script, if any.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time this script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

sql : string

The raw SQL query for the script.

type : string

The type of script.

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
patch_containers(id, **kwargs)

Update a container

Parameters:

id : integer

The ID for the script.

time_zone : string, optional

The time zone of this script.

repo_ref : string, optional

The tag or branch of the github repo to clone into the container.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

name : string, optional

The name of the container.

docker_command : string, optional

The command to run on the container. Will be run via sh as: [“sh”, “-c”, dockerCommand]

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

docker_image_tag : string, optional

The tag of the docker image to pull from DockerHub (default: latest).

remote_host_credential_id : integer, optional

The id of the database credentials to pass into the environment of the container.

git_credential_id : integer, optional

The id of the git credential to be used when checking out the specified git repo. If not supplied, the first git credential you’ve submitted will be used. Unnecessary if no git repo is specified or the git repo is public.

docker_image_name : string, optional

The name of the docker image to pull from DockerHub.

user_context : string, optional

“runner” or “author”, who to execute the script as when run as a template.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

required_resources : dict, optional:

- memory : integer
    The amount of RAM to allocate for the container (in MiB).
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares.

target_project_id : integer, optional

Target project to which script outputs will be added.

repo_http_uri : string, optional

The location of a github repo to clone into the container, e.g. github.com/my-user/my-repo.git.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

remote_host_credential_id : integer

The id of the database credentials to pass into the environment of the container.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

docker_command : string

The command to run on the container. Will be run via sh as: [“sh”, “-c”, dockerCommand]

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template script.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

docker_image_name : string

The name of the docker image to pull from DockerHub.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

archived : string

The archival status of the requested object(s).

repo_http_uri : string

The location of a github repo to clone into the container, e.g. github.com/my-user/my-repo.git.

name : string

The name of the container.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

docker_image_tag : string

The tag of the docker image to pull from DockerHub (default: latest).

git_credential_id : integer

The id of the git credential to be used when checking out the specified git repo. If not supplied, the first git credential you’ve submitted will be used. Unnecessary if no git repo is specified or the git repo is public.

repo_ref : string

The tag or branch of the github repo to clone into the container.

type : string

The type of the script (e.g Container)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB).
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
patch_containers_runs(id, run_id, **kwargs)

Update a run

Parameters:

id : integer

The ID for the script.

run_id : integer

The ID of the script run.

state : string, optional

The state of the script.

bocce_accepted_at : string/date-time, optional

The time when a bocce worker began processing the script.

bocce_started_at : string/date-time, optional

The time when a bocce worker began executing the script.
Returns:

None

Response code 204: success
patch_custom(id, **kwargs)

Update some attributes of this CustomScript

Parameters:

id : integer

The ID for the script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

time_zone : string, optional

The time zone of this script.

credential_id : integer, optional

The credential that this script will use.

parent_id : integer, optional

The ID of the parent job that will trigger this script

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

remote_host_id : integer, optional

The remote host ID that this script will connect to.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.

target_project_id : integer, optional

Target project to which script outputs will be added.

name : string, optional

The name of the script.
Returns:

id : integer

The ID for the script.

time_zone : string

The time zone of this script.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

finished_at : string/time

The time that the script’s last run finished.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

code_preview : string

The code that this script will run with arguments inserted.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

credential_id : integer

The credential that this script will use.

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

type : string

The type of the script (e.g Custom)

remote_host_id : integer

The remote host ID that this script will connect to.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
patch_javascript(id, **kwargs)

Update some attributes of this JavaScript Script

Parameters:

id : integer

The ID for the script.

time_zone : string, optional

The time zone of this script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

next_run_at : string/time, optional

The time of the next scheduled run.

credential_id : integer, optional

The credential that this script will use.

user_context : string, optional

“runner” or “author”, who to execute the script as when run as a template.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

source : string, optional

The body/text of the script.

name : string, optional

The name of the script.

target_project_id : integer, optional

Target project to which script outputs will be added.

remote_host_id : integer, optional

The remote host ID that this script will connect to.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

credential_id : integer

The credential that this script will use.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

remote_host_id : integer

The remote host ID that this script will connect to.

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

source : string

The body/text of the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
patch_python3(id, **kwargs)

Update some attributes of this Python Script

Parameters:

id : integer

The ID for the script.

time_zone : string, optional

The time zone of this script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

next_run_at : string/time, optional

The time of the next scheduled run.

user_context : string, optional

“runner” or “author”, who to execute the script as when run as a template.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

source : string, optional

The body/text of the script.

required_resources : dict, optional:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

target_project_id : integer, optional

Target project to which script outputs will be added.

name : string, optional

The name of the script.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

source : string

The body/text of the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
patch_r(id, **kwargs)

Update some attributes of this R Script

Parameters:

id : integer

The ID for the script.

time_zone : string, optional

The time zone of this script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

next_run_at : string/time, optional

The time of the next scheduled run.

user_context : string, optional

“runner” or “author”, who to execute the script as when run as a template.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

source : string, optional

The body/text of the script.

required_resources : dict, optional:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

target_project_id : integer, optional

Target project to which script outputs will be added.

name : string, optional

The name of the script.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

source : string

The body/text of the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
patch_sql(id, **kwargs)

Update some attributes of this SQL script

Parameters:

id : integer

The ID for the script.

time_zone : string, optional

The time zone of this script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

csv_settings : dict, optional:

- compression : string
    The type of compression to use, if any, one of "none", "zip", or
    "gzip". Default: gzip
- include_header : boolean
    Whether or not to include headers in the output data. Default: true
- filename_prefix : string
    A user specified filename prefix for the output file to have. Default:
    null
- unquoted : boolean
    Whether or not to quote fields. Default: false
- force_multifile : boolean
    Whether or not the csv should be split into multiple files. Default:
    false
- column_delimiter : string
    Which delimiter to use, one of "comma", "tab", or "pipe". Default:
    comma

next_run_at : string/time, optional

The time of the next scheduled run.

sql : string, optional

The raw SQL query for the script.

credential_id : integer, optional

The credential that this script will use.

user_context : string, optional

“runner” or “author”, who to execute the script as when run as a template.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

remote_host_id : integer, optional

The remote host ID that this script will connect to.

name : string, optional

The name of the script.

target_project_id : integer, optional

Target project to which script outputs will be added.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

expanded_arguments : dict

Expanded arguments for use in injecting into different environments.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

code_preview : string

The code that this script will run with arguments inserted.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

credential_id : integer

The credential that this script will use.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

remote_host_id : integer

The remote host ID that this script will connect to.

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

csv_settings : dict:

- compression : string
    The type of compression to use, if any, one of "none", "zip", or
    "gzip". Default: gzip
- include_header : boolean
    Whether or not to include headers in the output data. Default: true
- filename_prefix : string
    A user specified filename prefix for the output file to have. Default:
    null
- unquoted : boolean
    Whether or not to quote fields. Default: false
- force_multifile : boolean
    Whether or not the csv should be split into multiple files. Default:
    false
- column_delimiter : string
    Which delimiter to use, one of "comma", "tab", or "pipe". Default:
    comma

next_run_at : string/time

The time of the next scheduled run.

sql : string

The raw SQL query for the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
post(credential_id, remote_host_id, name, sql, **kwargs)

Create a script

Parameters:

credential_id : integer

The credential ID.

remote_host_id : integer

The database ID.

name : string

The name of the script.

sql : string

The raw SQL query for the script.

hidden : boolean, optional

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

template_script_id : integer, optional

The ID of the template script, if any. A script cannot both have a template script and be a template for other scripts.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
Cannot be set if this script uses a template script.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

template_script_id : integer

The ID of the template script, if any.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
post_cancel(id)

Cancel a run

Parameters:

id : integer

The ID of the job.
Returns:

state : string

The state of the run, one of ‘queued’, ‘running’ or ‘cancelled’.

id : integer

The ID of the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
post_containers(docker_command, docker_image_name, required_resources, **kwargs)

Create a container

Parameters:

docker_command : string

The command to run on the container. Will be run via sh as: [“sh”, “-c”, dockerCommand]

docker_image_name : string

The name of the docker image to pull from DockerHub.

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB).
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares.

time_zone : string, optional

The time zone of this script.

repo_ref : string, optional

The tag or branch of the github repo to clone into the container.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

name : string, optional

The name of the container.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

docker_image_tag : string, optional

The tag of the docker image to pull from DockerHub (default: latest).

remote_host_credential_id : integer, optional

The id of the database credentials to pass into the environment of the container.

git_credential_id : integer, optional

The id of the git credential to be used when checking out the specified git repo. If not supplied, the first git credential you’ve submitted will be used. Unnecessary if no git repo is specified or the git repo is public.

hidden : boolean, optional

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

user_context : string, optional

“runner” or “author”, who to execute the script as when run as a template.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

target_project_id : integer, optional

Target project to which script outputs will be added.

repo_http_uri : string, optional

The location of a github repo to clone into the container, e.g. github.com/my-user/my-repo.git.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

remote_host_credential_id : integer

The id of the database credentials to pass into the environment of the container.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

docker_command : string

The command to run on the container. Will be run via sh as: [“sh”, “-c”, dockerCommand]

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template script.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

docker_image_name : string

The name of the docker image to pull from DockerHub.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

archived : string

The archival status of the requested object(s).

repo_http_uri : string

The location of a github repo to clone into the container, e.g. github.com/my-user/my-repo.git.

name : string

The name of the container.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

docker_image_tag : string

The tag of the docker image to pull from DockerHub (default: latest).

git_credential_id : integer

The id of the git credential to be used when checking out the specified git repo. If not supplied, the first git credential you’ve submitted will be used. Unnecessary if no git repo is specified or the git repo is public.

repo_ref : string

The tag or branch of the github repo to clone into the container.

type : string

The type of the script (e.g Container)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB).
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
post_containers_runs(id)

Start a run

Parameters:

id : integer

The ID of the container.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

container_id : integer

The ID of the container.

finished_at : string/time

The time the last run completed.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
post_containers_runs_heartbeats(id, run_id)

Indicate that the given run is being handled

Parameters:

id : integer

The ID of the container.

run_id : integer

The ID of the run.
Returns:

None

Response code 204: success
post_containers_runs_logs(id, run_id, **kwargs)

Add log messages

Parameters:

id : integer

The ID of the script.

run_id : integer

The ID of the script run.

level : string, optional

The log level of this message [default: info]

messages : list, optional:

- level : string
    The log level of this message [default: info]
- created_at : string/date-time
- message : string
    The log message to store.

message : string, optional

The log message to store.
Returns:

None

Response code 204: success
post_containers_runs_outputs(id, run_id, object_id, object_type)

Add an output for a run

Parameters:

id : integer

The ID of the output.

run_id : integer

The ID of the run.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project
Returns:

link : string

The link to retrieve the output object.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project

name : string

The name of the output object.
post_custom(from_template_id, **kwargs)

Create a CustomScript

Parameters:

from_template_id : integer

The ID of the template script.

credential_id : integer, optional

The credential that this script will use.

time_zone : string, optional

The time zone of this script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.

hidden : boolean, optional

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

parent_id : integer, optional

The ID of the parent job that will trigger this script

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

remote_host_id : integer, optional

The remote host ID that this script will connect to.

target_project_id : integer, optional

Target project to which script outputs will be added.

name : string, optional

The name of the script.
Returns:

id : integer

The ID for the script.

time_zone : string

The time zone of this script.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

finished_at : string/time

The time that the script’s last run finished.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

code_preview : string

The code that this script will run with arguments inserted.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

credential_id : integer

The credential that this script will use.

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

type : string

The type of the script (e.g Custom)

remote_host_id : integer

The remote host ID that this script will connect to.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
post_custom_runs(id)

Start a run

Parameters:

id : integer

The ID of the custom.
Returns:

custom_id : integer

The ID of the custom.

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
post_custom_runs_outputs(id, run_id, object_id, object_type)

Add an output for a run

Parameters:

id : integer

The ID of the output.

run_id : integer

The ID of the run.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project
Returns:

link : string

The link to retrieve the output object.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project

name : string

The name of the output object.
post_javascript(credential_id, source, name, remote_host_id, **kwargs)

Create a JavaScript Script

Parameters:

credential_id : integer

The credential that this script will use.

source : string

The body/text of the script.

name : string

The name of the script.

remote_host_id : integer

The remote host ID that this script will connect to.

time_zone : string, optional

The time zone of this script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

next_run_at : string/time, optional

The time of the next scheduled run.

hidden : boolean, optional

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

user_context : string, optional

“runner” or “author”, who to execute the script as when run as a template.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

target_project_id : integer, optional

Target project to which script outputs will be added.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

credential_id : integer

The credential that this script will use.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

remote_host_id : integer

The remote host ID that this script will connect to.

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

source : string

The body/text of the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
post_javascript_runs(id)

Start a run

Parameters:

id : integer

The ID of the javascript.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

javascript_id : integer

The ID of the javascript.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
post_javascript_runs_outputs(id, run_id, object_id, object_type)

Add an output for a run

Parameters:

id : integer

The ID of the output.

run_id : integer

The ID of the run.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project
Returns:

link : string

The link to retrieve the output object.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project

name : string

The name of the output object.
post_python3(source, name, **kwargs)

Create a Python Script

Parameters:

source : string

The body/text of the script.

name : string

The name of the script.

time_zone : string, optional

The time zone of this script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

next_run_at : string/time, optional

The time of the next scheduled run.

hidden : boolean, optional

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

required_resources : dict, optional:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

user_context : string, optional

“runner” or “author”, who to execute the script as when run as a template.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

target_project_id : integer, optional

Target project to which script outputs will be added.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

source : string

The body/text of the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
post_python3_runs(id)

Start a run

Parameters:

id : integer

The ID of the python.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

python_id : integer

The ID of the python.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
post_python3_runs_outputs(id, run_id, object_id, object_type)

Add an output for a run

Parameters:

id : integer

The ID of the output.

run_id : integer

The ID of the run.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project
Returns:

link : string

The link to retrieve the output object.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project

name : string

The name of the output object.
post_r(source, name, **kwargs)

Create an R Script

Parameters:

source : string

The body/text of the script.

name : string

The name of the script.

time_zone : string, optional

The time zone of this script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

next_run_at : string/time, optional

The time of the next scheduled run.

hidden : boolean, optional

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

required_resources : dict, optional:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

user_context : string, optional

“runner” or “author”, who to execute the script as when run as a template.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

target_project_id : integer, optional

Target project to which script outputs will be added.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

source : string

The body/text of the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
post_r_runs(id)

Start a run

Parameters:

id : integer

The ID of the r.
Returns:

state : string

The state of the run, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the run.

finished_at : string/time

The time the last run completed.

r_id : integer

The ID of the r.

started_at : string/time

The time the last run started at.

error : string

The error, if any, returned by the run.

is_cancel_requested : boolean

True if run cancel requested, else false.
post_r_runs_outputs(id, run_id, object_id, object_type)

Add an output for a run

Parameters:

id : integer

The ID of the output.

run_id : integer

The ID of the run.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project
Returns:

link : string

The link to retrieve the output object.

object_id : integer

The ID of the output object.

object_type : string

The type of the output. Valid values are File, Report, Table, or Project

name : string

The name of the output object.
post_run(id)

Run a script

Parameters:

id : integer

The ID for the script.
Returns:

None

Response code 204: success
post_sql(sql, credential_id, remote_host_id, name, **kwargs)

Create a SQL script

Parameters:

sql : string

The raw SQL query for the script.

credential_id : integer

The credential that this script will use.

remote_host_id : integer

The remote host ID that this script will connect to.

name : string

The name of the script.

time_zone : string, optional

The time zone of this script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

csv_settings : dict, optional:

- compression : string
    The type of compression to use, if any, one of "none", "zip", or
    "gzip". Default: gzip
- include_header : boolean
    Whether or not to include headers in the output data. Default: true
- filename_prefix : string
    A user specified filename prefix for the output file to have. Default:
    null
- unquoted : boolean
    Whether or not to quote fields. Default: false
- force_multifile : boolean
    Whether or not the csv should be split into multiple files. Default:
    false
- column_delimiter : string
    Which delimiter to use, one of "comma", "tab", or "pipe". Default:
    comma

next_run_at : string/time, optional

The time of the next scheduled run.

hidden : boolean, optional

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

user_context : string, optional

“runner” or “author”, who to execute the script as when run as a template.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

target_project_id : integer, optional

Target project to which script outputs will be added.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

expanded_arguments : dict

Expanded arguments for use in injecting into different environments.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

code_preview : string

The code that this script will run with arguments inserted.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

credential_id : integer

The credential that this script will use.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

remote_host_id : integer

The remote host ID that this script will connect to.

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

csv_settings : dict:

- compression : string
    The type of compression to use, if any, one of "none", "zip", or
    "gzip". Default: gzip
- include_header : boolean
    Whether or not to include headers in the output data. Default: true
- filename_prefix : string
    A user specified filename prefix for the output file to have. Default:
    null
- unquoted : boolean
    Whether or not to quote fields. Default: false
- force_multifile : boolean
    Whether or not the csv should be split into multiple files. Default:
    false
- column_delimiter : string
    Which delimiter to use, one of "comma", "tab", or "pipe". Default:
    comma

next_run_at : string/time

The time of the next scheduled run.

sql : string

The raw SQL query for the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
post_sql_runs(id)

Start a run

Parameters:

id : integer

The ID of the sql.
Returns:

state : string

The state of this run.

id : integer

The ID of this run.

output : list:

A list of the outputs of this script.
- output_name : string
    The name of the output file.
- file_id : integer
    The unique ID of the output file.
- path : string
    The temporary link to download this output file, valid for 36 hours.

finished_at : string/time

The time that this run finished.

sql_id : integer

The ID of this sql.

started_at : string/time

The time the last run started.

error : string

The error message for this run, if present.

is_cancel_requested : boolean

True if run cancel requested, else false.
put_containers(id, docker_command, docker_image_name, required_resources, **kwargs)

Edit a container

Parameters:

id : integer

The ID for the script.

docker_command : string

The command to run on the container. Will be run via sh as: [“sh”, “-c”, dockerCommand]

docker_image_name : string

The name of the docker image to pull from DockerHub.

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB).
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares.

time_zone : string, optional

The time zone of this script.

repo_ref : string, optional

The tag or branch of the github repo to clone into the container.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

name : string, optional

The name of the container.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

docker_image_tag : string, optional

The tag of the docker image to pull from DockerHub (default: latest).

remote_host_credential_id : integer, optional

The id of the database credentials to pass into the environment of the container.

git_credential_id : integer, optional

The id of the git credential to be used when checking out the specified git repo. If not supplied, the first git credential you’ve submitted will be used. Unnecessary if no git repo is specified or the git repo is public.

user_context : string, optional

“runner” or “author”, who to execute the script as when run as a template.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

target_project_id : integer, optional

Target project to which script outputs will be added.

repo_http_uri : string, optional

The location of a github repo to clone into the container, e.g. github.com/my-user/my-repo.git.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

remote_host_credential_id : integer

The id of the database credentials to pass into the environment of the container.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

docker_command : string

The command to run on the container. Will be run via sh as: [“sh”, “-c”, dockerCommand]

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template script.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

docker_image_name : string

The name of the docker image to pull from DockerHub.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

archived : string

The archival status of the requested object(s).

repo_http_uri : string

The location of a github repo to clone into the container, e.g. github.com/my-user/my-repo.git.

name : string

The name of the container.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

docker_image_tag : string

The tag of the docker image to pull from DockerHub (default: latest).

git_credential_id : integer

The id of the git credential to be used when checking out the specified git repo. If not supplied, the first git credential you’ve submitted will be used. Unnecessary if no git repo is specified or the git repo is public.

repo_ref : string

The tag or branch of the github repo to clone into the container.

type : string

The type of the script (e.g Container)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB).
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
put_containers_archive(id, status)

Update the archive status of this object

Parameters:

id : integer

The ID of the object.

status : boolean

The desired archived status of the object.
Returns:

id : integer

The ID for the script.

remote_host_credential_id : integer

The id of the database credentials to pass into the environment of the container.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

docker_command : string

The command to run on the container. Will be run via sh as: [“sh”, “-c”, dockerCommand]

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template script.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

docker_image_name : string

The name of the docker image to pull from DockerHub.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

archived : string

The archival status of the requested object(s).

repo_http_uri : string

The location of a github repo to clone into the container, e.g. github.com/my-user/my-repo.git.

name : string

The name of the container.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

docker_image_tag : string

The tag of the docker image to pull from DockerHub (default: latest).

git_credential_id : integer

The id of the git credential to be used when checking out the specified git repo. If not supplied, the first git credential you’ve submitted will be used. Unnecessary if no git repo is specified or the git repo is public.

repo_ref : string

The tag or branch of the github repo to clone into the container.

type : string

The type of the script (e.g Container)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB).
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
put_containers_projects(id, project_id)

Add a container docker to a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
put_containers_shares_groups(id, group_ids, permission_level)

Set the permissions groups has on this object

Parameters:

id : integer

ID of the resource to be shared

group_ids : list

An array of one or more group IDs

permission_level : string

Options are: “read”, “write”, or “manage”
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_containers_shares_users(id, permission_level, user_ids)

Set the permissions users have on this object

Parameters:

id : integer

ID of the resource to be shared

permission_level : string

Options are: “read”, “write”, or “manage”

user_ids : list

An array of one or more user IDs
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_custom(id, **kwargs)

Replace all attributes of this CustomScript

Parameters:

id : integer

The ID for the script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

time_zone : string, optional

The time zone of this script.

credential_id : integer, optional

The credential that this script will use.

parent_id : integer, optional

The ID of the parent job that will trigger this script

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

remote_host_id : integer, optional

The remote host ID that this script will connect to.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.

target_project_id : integer, optional

Target project to which script outputs will be added.

name : string, optional

The name of the script.
Returns:

id : integer

The ID for the script.

time_zone : string

The time zone of this script.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

finished_at : string/time

The time that the script’s last run finished.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

code_preview : string

The code that this script will run with arguments inserted.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

credential_id : integer

The credential that this script will use.

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

type : string

The type of the script (e.g Custom)

remote_host_id : integer

The remote host ID that this script will connect to.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
put_custom_archive(id, status)

Update the archive status of this object

Parameters:

id : integer

The ID of the object.

status : boolean

The desired archived status of the object.
Returns:

id : integer

The ID for the script.

time_zone : string

The time zone of this script.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

finished_at : string/time

The time that the script’s last run finished.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

code_preview : string

The code that this script will run with arguments inserted.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

credential_id : integer

The credential that this script will use.

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

type : string

The type of the script (e.g Custom)

remote_host_id : integer

The remote host ID that this script will connect to.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
put_custom_projects(id, project_id)

Add a Job to a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
put_custom_shares_groups(id, group_ids, permission_level)

Set the permissions groups has on this object

Parameters:

id : integer

ID of the resource to be shared

group_ids : list

An array of one or more group IDs

permission_level : string

Options are: “read”, “write”, or “manage”
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_custom_shares_users(id, permission_level, user_ids)

Set the permissions users have on this object

Parameters:

id : integer

ID of the resource to be shared

permission_level : string

Options are: “read”, “write”, or “manage”

user_ids : list

An array of one or more user IDs
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_javascript(id, credential_id, source, name, remote_host_id, **kwargs)

Replace all attributes of this JavaScript Script

Parameters:

id : integer

The ID for the script.

credential_id : integer

The credential that this script will use.

source : string

The body/text of the script.

name : string

The name of the script.

remote_host_id : integer

The remote host ID that this script will connect to.

time_zone : string, optional

The time zone of this script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

next_run_at : string/time, optional

The time of the next scheduled run.

user_context : string, optional

“runner” or “author”, who to execute the script as when run as a template.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

target_project_id : integer, optional

Target project to which script outputs will be added.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

credential_id : integer

The credential that this script will use.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

remote_host_id : integer

The remote host ID that this script will connect to.

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

source : string

The body/text of the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
put_javascript_archive(id, status)

Update the archive status of this object

Parameters:

id : integer

The ID of the object.

status : boolean

The desired archived status of the object.
Returns:

id : integer

The ID for the script.

credential_id : integer

The credential that this script will use.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

remote_host_id : integer

The remote host ID that this script will connect to.

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

source : string

The body/text of the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
put_javascript_projects(id, project_id)

Add a scripted sql to a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
put_javascript_shares_groups(id, group_ids, permission_level)

Set the permissions groups has on this object

Parameters:

id : integer

ID of the resource to be shared

group_ids : list

An array of one or more group IDs

permission_level : string

Options are: “read”, “write”, or “manage”
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_javascript_shares_users(id, permission_level, user_ids)

Set the permissions users have on this object

Parameters:

id : integer

ID of the resource to be shared

permission_level : string

Options are: “read”, “write”, or “manage”

user_ids : list

An array of one or more user IDs
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_python3(id, source, name, **kwargs)

Replace all attributes of this Python Script

Parameters:

id : integer

The ID for the script.

source : string

The body/text of the script.

name : string

The name of the script.

time_zone : string, optional

The time zone of this script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

next_run_at : string/time, optional

The time of the next scheduled run.

user_context : string, optional

“runner” or “author”, who to execute the script as when run as a template.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

required_resources : dict, optional:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

target_project_id : integer, optional

Target project to which script outputs will be added.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

source : string

The body/text of the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
put_python3_archive(id, status)

Update the archive status of this object

Parameters:

id : integer

The ID of the object.

status : boolean

The desired archived status of the object.
Returns:

id : integer

The ID for the script.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

source : string

The body/text of the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
put_python3_projects(id, project_id)

Add a python docker to a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
put_python3_shares_groups(id, group_ids, permission_level)

Set the permissions groups has on this object

Parameters:

id : integer

ID of the resource to be shared

group_ids : list

An array of one or more group IDs

permission_level : string

Options are: “read”, “write”, or “manage”
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_python3_shares_users(id, permission_level, user_ids)

Set the permissions users have on this object

Parameters:

id : integer

ID of the resource to be shared

permission_level : string

Options are: “read”, “write”, or “manage”

user_ids : list

An array of one or more user IDs
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_r(id, source, name, **kwargs)

Replace all attributes of this R Script

Parameters:

id : integer

The ID for the script.

source : string

The body/text of the script.

name : string

The name of the script.

time_zone : string, optional

The time zone of this script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

next_run_at : string/time, optional

The time of the next scheduled run.

user_context : string, optional

“runner” or “author”, who to execute the script as when run as a template.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

required_resources : dict, optional:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

target_project_id : integer, optional

Target project to which script outputs will be added.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

source : string

The body/text of the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
put_r_archive(id, status)

Update the archive status of this object

Parameters:

id : integer

The ID of the object.

status : boolean

The desired archived status of the object.
Returns:

id : integer

The ID for the script.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

required_resources : dict:

- memory : integer
    The amount of RAM to allocate for the container (in MiB). Must be at
    least 4 MiB.
- disk_space : number/float
    The amount of disk space, in GB, to allocate for the container. This
    space will be used to hold the git repo configured for the container
    and anything your container writes to /tmp or /data. Fractional values
    (e.g. 0.25) are supported.
- cpu : integer
    The number of CPU shares to allocate for the container. Each core has
    1024 shares. Must be at least 2 shares.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

next_run_at : string/time

The time of the next scheduled run.

source : string

The body/text of the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
put_r_projects(id, project_id)

Add a r docker to a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
put_r_shares_groups(id, group_ids, permission_level)

Set the permissions groups has on this object

Parameters:

id : integer

ID of the resource to be shared

group_ids : list

An array of one or more group IDs

permission_level : string

Options are: “read”, “write”, or “manage”
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_r_shares_users(id, permission_level, user_ids)

Set the permissions users have on this object

Parameters:

id : integer

ID of the resource to be shared

permission_level : string

Options are: “read”, “write”, or “manage”

user_ids : list

An array of one or more user IDs
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_sql(id, sql, credential_id, remote_host_id, name, **kwargs)

Replace all attributes of this SQL script

Parameters:

id : integer

The ID for the script.

sql : string

The raw SQL query for the script.

credential_id : integer

The credential that this script will use.

remote_host_id : integer

The remote host ID that this script will connect to.

name : string

The name of the script.

time_zone : string, optional

The time zone of this script.

arguments : dict, optional

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

schedule : dict, optional:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

csv_settings : dict, optional:

- compression : string
    The type of compression to use, if any, one of "none", "zip", or
    "gzip". Default: gzip
- include_header : boolean
    Whether or not to include headers in the output data. Default: true
- filename_prefix : string
    A user specified filename prefix for the output file to have. Default:
    null
- unquoted : boolean
    Whether or not to quote fields. Default: false
- force_multifile : boolean
    Whether or not the csv should be split into multiple files. Default:
    false
- column_delimiter : string
    Which delimiter to use, one of "comma", "tab", or "pipe". Default:
    comma

next_run_at : string/time, optional

The time of the next scheduled run.

user_context : string, optional

“runner” or “author”, who to execute the script as when run as a template.

params : list, optional:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

parent_id : integer, optional

The ID of the parent job that will trigger this script

target_project_id : integer, optional

Target project to which script outputs will be added.

notifications : dict, optional:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
Returns:

id : integer

The ID for the script.

expanded_arguments : dict

Expanded arguments for use in injecting into different environments.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

code_preview : string

The code that this script will run with arguments inserted.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

credential_id : integer

The credential that this script will use.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

remote_host_id : integer

The remote host ID that this script will connect to.

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

csv_settings : dict:

- compression : string
    The type of compression to use, if any, one of "none", "zip", or
    "gzip". Default: gzip
- include_header : boolean
    Whether or not to include headers in the output data. Default: true
- filename_prefix : string
    A user specified filename prefix for the output file to have. Default:
    null
- unquoted : boolean
    Whether or not to quote fields. Default: false
- force_multifile : boolean
    Whether or not the csv should be split into multiple files. Default:
    false
- column_delimiter : string
    Which delimiter to use, one of "comma", "tab", or "pipe". Default:
    comma

next_run_at : string/time

The time of the next scheduled run.

sql : string

The raw SQL query for the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
put_sql_archive(id, status)

Update the archive status of this object

Parameters:

id : integer

The ID of the object.

status : boolean

The desired archived status of the object.
Returns:

id : integer

The ID for the script.

expanded_arguments : dict

Expanded arguments for use in injecting into different environments.

projects : list:

A list of projects containing the script.
- id : integer
    The ID for the project.
- name : string
    The name of the project.

code_preview : string

The code that this script will run with arguments inserted.

schedule : dict:

- scheduled_minutes : list
    Minutes of the day it is scheduled on
- scheduled_runs_per_hour : integer
    Alternative to scheduled minutes, number of times to run per hour
- scheduled : boolean
    If the object is scheduled
- scheduled_hours : list
    Hours of the day it is scheduled on
- scheduled_days : list
    Day based on numeric value starting at 0 for Sunday

from_template_id : integer

The ID of the template this script uses, if any.

links : dict:

- runs : string
    The runs link to get the run information list for this script.
- details : string
    The details link to get more information about the script.

created_at : string/time

The time this script was created.

hidden : boolean

The hidden status of the object. Setting this to true hides it from most API endpoints. The object can still be queried directly by ID

credential_id : integer

The credential that this script will use.

arguments : dict

Dictionary of name/value pairs to use to run this script. Only settable if this script has defined params.

finished_at : string/time

The time that the script’s last run finished.

is_template : boolean

Whether others scripts use this one as a template.

parent_id : integer

The ID of the parent job that will trigger this script

template_script_name : string

The name of the template script.

updated_at : string/time

The time the script was last updated.

archived : string

The archival status of the requested object(s).

remote_host_id : integer

The remote host ID that this script will connect to.

name : string

The name of the script.

state : string

The status of the script’s last run.

time_zone : string

The time zone of this script.

user_context : string

“runner” or “author”, who to execute the script as when run as a template.

csv_settings : dict:

- compression : string
    The type of compression to use, if any, one of "none", "zip", or
    "gzip". Default: gzip
- include_header : boolean
    Whether or not to include headers in the output data. Default: true
- filename_prefix : string
    A user specified filename prefix for the output file to have. Default:
    null
- unquoted : boolean
    Whether or not to quote fields. Default: false
- force_multifile : boolean
    Whether or not the csv should be split into multiple files. Default:
    false
- column_delimiter : string
    Which delimiter to use, one of "comma", "tab", or "pipe". Default:
    comma

next_run_at : string/time

The time of the next scheduled run.

sql : string

The raw SQL query for the script.

type : string

The type of the script (e.g SQL, Container, Python, R, JavaScript)

params : list:

A definition of the parameters this script accepts in the arguments field.
- description : string
    A short sentence or fragment describing this parameter to the end user.
- value : string
    The value you would like to set this param to. Setting this value makes
    this parameter a fixed param.
- type : string
    The type of parameter. Valid options: string, integer, float, bool,
    file, database, credential_aws, credential_redshift, or
    credential_custom
- required : boolean
    Whether this param is required.
- default : string
    If an argument for this parameter is not defined, it will use this
    default value. Use true, True, t, y, yes, or 1 for true bool's or
    false, False, f, n, no, or 0 for false bool's. Cannot be used for
    parameters that are required or a credential type.
- name : string
    The variable's name as used within your code.
- label : string
    The label to present to users when asking them for the value.

running_as : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

template_dependents_count : integer

How many other scripts use this one as a template.

published_as_template_id : integer

The ID of the template that this script is backing.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

target_project_id : integer

Target project to which script outputs will be added.

author : dict:

- id : integer
    The ID of this user.
- initials : string
    This user's initials.
- online : boolean
    Whether this user is online.
- username : string
    This user's username.
- name : string
    This user's name.

notifications : dict:

- success_on : boolean
    If success email notifications are on
- failure_email_addresses : list
    Addresses to notify by e-mail when the job fails.
- stall_warning_minutes : integer
    Stall warning emails will be sent after this amount of minutes.
- failure_on : boolean
    If failure email notifications are on
- urls : list
    URLs to receive a POST request at job completion
- success_email_body : string
    Custom body text for success e-mail, written in Markdown.
- success_email_subject : string
    Custom subject line for success e-mail.
- success_email_addresses : list
    Addresses to notify by e-mail when the job completes successfully.
put_sql_projects(id, project_id)

Add a scripts to a project

Parameters:

id : integer

ID of the resource

project_id : integer

The ID of the project
Returns:

None

Response code 204: success
put_sql_shares_groups(id, group_ids, permission_level)

Set the permissions groups has on this object

Parameters:

id : integer

ID of the resource to be shared

group_ids : list

An array of one or more group IDs

permission_level : string

Options are: “read”, “write”, or “manage”
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
put_sql_shares_users(id, permission_level, user_ids)

Set the permissions users have on this object

Parameters:

id : integer

ID of the resource to be shared

permission_level : string

Options are: “read”, “write”, or “manage”

user_ids : list

An array of one or more user IDs
Returns:

readers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

total_user_shares : integer

For owners, the number of total users shared. For writers and readers, the number of visible users shared.

total_group_shares : integer

For owners, the number of total groups shared. For writers and readers, the number of visible groups shared.

writers : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string

owners : dict:

- users : list::
    - id : integer
    - name : string
- groups : list::
    - id : integer
    - name : string
Tables
class Tables(session, return_type='civis')

Methods

get(id) Show basic table info
get_enhancements_cass_ncoa(id, source_table_id) View the status of a CASS / NCOA table enhancement
get_enhancements_geocodings(id, source_table_id) View the status of a geocoding table enhancement
get_enhancements_prepared_matchings(id, ...) View a prepared matching enhancement
get_enhancements_table_matchings(id, ...) View a table matching enhancement
list(**kwargs) List tables
list_columns(id, **kwargs) List columns in the specified table
patch(id, **kwargs) Update a table
post(schema, database_id, data, name) Import a file into a table
post_enhancements_cass_ncoa(source_table_id, ...) Standardize addresses in a table
post_enhancements_geocodings(source_table_id) Geocode a table
post_enhancements_prepared_matchings(...) Match person records against a dynamo table prepared by Civis
post_enhancements_table_matchings(...) Match person records against an arbitrary Redshift table
post_refresh(id) Request a refresh for column and table statistics
get(id)

Show basic table info

Parameters:

id : integer
Returns:

sortkeys : string

The column used as the Amazon Redshift sortkey.

id : integer

The ID of the table.

view_def : string

joins : list:

- id : integer
- right_identifier : string
- left_table_id : integer
- right_table_id : integer
- updated_at : string/time
- on : string
- left_join : boolean
- created_at : string/time
- left_identifier : string

refresh_status : string

How up-to-date the table’s statistics on row counts, null counts, distinct counts, and values distributions are. One of: refreshing, stale, or current.

last_refresh : string/date-time

The time of the last statistics refresh.

description : string

The description of the table, as specified by the table owner

is_view : boolean

True if this table represents a view. False if it represents a regular table.

refresh_id : string

The ID of the most recent statistics refresh.

ontology_mapping : dict

The ontology-key to column-name mapping. See /ontology for the list of valid ontology keys.

enhancements : list:

- updated_at : string/time
- join_id : integer
- created_at : string/time
- type : string

size_mb : number/float

The size of the table in megabytes.

schema : string

The name of the schema containing the table.

owner : string

The database username of the table’s owner.

row_count : integer

The number of rows in the table.

multipart_key : list

column_count : integer

The number of columns in the table.

distkey : string

The column used as the Amazon Redshift distkey.

columns : list:

- coverage_count : integer
    Number of non-null values in the column.
- description : string
    The description of the column, as specified by the table owner
- encoding : string
    The compression encoding for this columnSee: http://docs.aws.amazon.com
    /redshift/latest/dg/c_Compression_encodings.html
- sql_type : string
    SQL type of the column.
- value_distribution_percent : dict
    A mapping between each value in the column and the percentage of rows
    with that value.Only present for tables with fewer than approximately
    25,000,000 rows and for columns with fewer than twenty distinct values.
- min_value : string
    Smallest value in the column.
- order : integer
    Relative position of the column in the table.
- stddev : number/float
    Stddev of the column, where applicable.
- sample_values : list
    A sample of values from the column.
- useable_as_independent_variable : boolean
    Whether the column may be used as an independent variable to train a
    model.
- useable_as_primary_key : boolean
    Whether the column may be used as an primary key to identify table
    rows.
- distinct_count : integer
    Number of distinct values in the column.
- value_distribution : dict
    An object mapping distinct values in the column to the number of times
    they appear in the column
- possible_dependent_variable_types : list
    Possible dependent variable types the column may be used to model.
    Null if it may not be used as a dependent variable.
- null_count : integer
    Number of null values in the column.
- max_value : string
    Largest value in the column.
- avg_value : number/float
    Average value of the column, where applicable.
- name : string
    Name of the column.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

database_id : integer

The ID of the database.

name : string

Name of the table.

outgoing_table_matches : list:

- target_id : integer
    Target ID
- target : dict::
    - name : string
- target_type : string
    Target type
- job : dict::
    - state : string
        Whether the job is idle, queued, running, cancelled, or failed.
    - runs : list::
        Information about the most recent runs of the job.
        - state : string
        - id : integer
        - finished_at : string/time
            The time that the run completed.
        - started_at : string/time
            The time that the run started.
        - error : string
            The error message for this run, if present.
        - created_at : string/time
            The time that the run was queued.
    - id : integer
    - hidden : boolean
        The hidden status of the object. Setting this to true hides it from
        most API endpoints. The object can still be queried directly by ID
    - type : string
    - updated_at : string/date-time
    - last_run : dict::
        - state : string
        - id : integer
        - finished_at : string/time
            The time that the run completed.
        - started_at : string/time
            The time that the run started.
        - error : string
            The error message for this run, if present.
        - created_at : string/time
            The time that the run was queued.
    - match_options : dict::
        - max_matches : integer
        - threshold : string
    - created_at : string/date-time
    - name : string
- source_table_id : integer
    Source table
get_enhancements_cass_ncoa(id, source_table_id)

View the status of a CASS / NCOA table enhancement

Parameters:

id : integer

The ID of the enhancement.

source_table_id : integer

The ID of the table that was enhanced.
Returns:

state : string

The state of the enhancement, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the enhancement.

source_table_id : integer

The ID of the table that was enhanced.

enhanced_table_schema : string

The schema name of the table created by the enhancement.

perform_ncoa : boolean

Whether to update addresses for records matching the National Change of Address (NCOA) database.

output_level : string

The set of fields persisted by a CASS or NCOA enhancement.For CASS enhancements, one of ‘cass’ or ‘all.’For NCOA enhancements, one of ‘cass’, ‘ncoa’ , ‘coalesced’ or ‘all’.By default, all fields will be returned.

enhanced_table_name : string

The name of the table created by the enhancement.

ncoa_credential_id : integer

Credential to use when performing NCOA updates. Required if ‘performNcoa’ is true.
get_enhancements_geocodings(id, source_table_id)

View the status of a geocoding table enhancement

Parameters:

id : integer

The ID of the enhancement.

source_table_id : integer

The ID of the table that was enhanced.
Returns:

state : string

The state of the enhancement, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

enhanced_table_name : string

The name of the table created by the enhancement.

id : integer

The ID of the enhancement.

enhanced_table_schema : string

The schema name of the table created by the enhancement.

source_table_id : integer

The ID of the table that was enhanced.
get_enhancements_prepared_matchings(id, source_table_id)

View a prepared matching enhancement

Parameters:

id : integer

The ID of the enhancement.

source_table_id : integer

The ID of the table that was enhanced.
Returns:

state : string

The state of the enhancement, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

max_matches : integer

The maximum number of individuals a person may be matched with.A value of 0 indicates that all matches should be returned.

id : integer

The ID of the enhancement.

source_table_id : integer

The ID of the table that was enhanced.

enhanced_table_schema : string

The schema name of the table created by the enhancement.

match_table_id : integer

The ID of the Dynamo table to match against.

enhanced_table_name : string

The name of the table created by the enhancement.

threshold : number/float

The confidence threshold which must be met for two individuals to be declared a match. Must be less than or equal to 1 and greater than or equal to 0.
get_enhancements_table_matchings(id, source_table_id)

View a table matching enhancement

Parameters:

id : integer

The ID of the enhancement.

source_table_id : integer

The ID of the table that was enhanced.
Returns:

state : string

The state of the enhancement, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

max_matches : integer

The maximum number of individuals a person may be matched with.A value of 0 indicates that all matches should be returned.

id : integer

The ID of the enhancement.

source_table_id : integer

The ID of the table that was enhanced.

enhanced_table_schema : string

The schema name of the table created by the enhancement.

match_table_id : integer

The ID of the Redshift table to match against.

enhanced_table_name : string

The name of the table created by the enhancement.

threshold : number/float

The confidence threshold which must be met for two individuals to be declared a match. Must be less than or equal to 1 and greater than or equal to 0.
list(**kwargs)

List tables

Parameters:

database_id : integer, optional

The ID of the database.

schema : string, optional

If specified, will be used to filter the tables returned. Substring matching is supported with “%” and “*” wildcards (e.g., “schema=%census%” will return both “client_census.table” and “census_2010.table”).

name : string, optional

If specified, will be used to filter the tables returned. Substring matching is supported with “%” and “*” wildcards (e.g., “name=%table%” will return both “table1” and “my table”).

search : string, optional

If specified, will be used to filter the tables returned. Will search across schema and name (in the full form schema.name) and will return any full name containing the search string.

limit : integer, optional

Number of results to return. Defaults to 50. Maximum allowed is 1000.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to schema. Must be one of: schema, name, search.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to asc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

sortkeys : string

The column used as the Amazon Redshift sortkey.

id : integer

The ID of the table.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

size_mb : number/float

The size of the table in megabytes.

schema : string

The name of the schema containing the table.

owner : string

The database username of the table’s owner.

row_count : integer

The number of rows in the table.

refresh_id : string

The ID of the most recent statistics refresh.

refresh_status : string

How up-to-date the table’s statistics on row counts, null counts, distinct counts, and values distributions are. One of: refreshing, stale, or current.

last_refresh : string/date-time

The time of the last statistics refresh.

description : string

The description of the table, as specified by the table owner

column_count : integer

The number of columns in the table.

distkey : string

The column used as the Amazon Redshift distkey.

is_view : boolean

True if this table represents a view. False if it represents a regular table.

database_id : integer

The ID of the database.

name : string

Name of the table.
list_columns(id, **kwargs)

List columns in the specified table

Parameters:

id : integer

name : string, optional

Search for columns with the given name, within the specified table.

limit : integer, optional

Number of results to return. Defaults to its maximum of 50.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to name. Must be one of: name, order.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to asc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

coverage_count : integer

Number of non-null values in the column.

description : string

The description of the column, as specified by the table owner

encoding : string

sql_type : string

SQL type of the column.

value_distribution_percent : dict

A mapping between each value in the column and the percentage of rows with that value.Only present for tables with fewer than approximately 25,000,000 rows and for columns with fewer than twenty distinct values.

min_value : string

Smallest value in the column.

order : integer

Relative position of the column in the table.

stddev : number/float

Stddev of the column, where applicable.

sample_values : list

A sample of values from the column.

useable_as_independent_variable : boolean

Whether the column may be used as an independent variable to train a model.

useable_as_primary_key : boolean

Whether the column may be used as an primary key to identify table rows.

distinct_count : integer

Number of distinct values in the column.

value_distribution : dict

An object mapping distinct values in the column to the number of times they appear in the column

possible_dependent_variable_types : list

Possible dependent variable types the column may be used to model. Null if it may not be used as a dependent variable.

null_count : integer

Number of null values in the column.

max_value : string

Largest value in the column.

avg_value : number/float

Average value of the column, where applicable.

name : string

Name of the column.
patch(id, **kwargs)

Update a table

Parameters:

id : integer

The ID of the table.

description : string, optional

The user-defined description of the table.

ontology_mapping : dict, optional

The ontology-key to column-name mapping. See /ontology for the list of valid ontology keys.
Returns:

sortkeys : string

The column used as the Amazon Redshift sortkey.

id : integer

The ID of the table.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

size_mb : number/float

The size of the table in megabytes.

schema : string

The name of the schema containing the table.

owner : string

The database username of the table’s owner.

row_count : integer

The number of rows in the table.

refresh_id : string

The ID of the most recent statistics refresh.

ontology_mapping : dict

The ontology-key to column-name mapping. See /ontology for the list of valid ontology keys.

refresh_status : string

How up-to-date the table’s statistics on row counts, null counts, distinct counts, and values distributions are. One of: refreshing, stale, or current.

last_refresh : string/date-time

The time of the last statistics refresh.

description : string

The description of the table, as specified by the table owner

column_count : integer

The number of columns in the table.

distkey : string

The column used as the Amazon Redshift distkey.

is_view : boolean

True if this table represents a view. False if it represents a regular table.

database_id : integer

The ID of the database.

name : string

Name of the table.
post(schema, database_id, data, name)

Import a file into a table

Parameters:

schema : string

The destination schema name.

database_id : integer

The ID of the destination database.

data : string

The file to import, uploaded using HTTP multipart.

name : string

The destination table name, without the schema prefix.
Returns:

state : string

The state of the last run.

finished_at : string/date-time

The end time of the last run.

schema : string

The destination schema name.

started_at : string/date-time

The start time of the last run.

database_id : integer

The ID of the destination database.

name : string

The destination table name, without the schema prefix.
post_enhancements_cass_ncoa(source_table_id, **kwargs)

Standardize addresses in a table

Parameters:

source_table_id : integer

The ID of the table to be enhanced.

output_level : string, optional

The set of fields persisted by a CASS or NCOA enhancement.For CASS enhancements, one of ‘cass’ or ‘all.’For NCOA enhancements, one of ‘cass’, ‘ncoa’ , ‘coalesced’ or ‘all’.By default, all fields will be returned.

perform_ncoa : boolean, optional

Whether to update addresses for records matching the National Change of Address (NCOA) database.

ncoa_credential_id : integer, optional

Credential to use when performing NCOA updates. Required if ‘performNcoa’ is true.
Returns:

state : string

The state of the enhancement, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

id : integer

The ID of the enhancement.

source_table_id : integer

The ID of the table that was enhanced.

enhanced_table_schema : string

The schema name of the table created by the enhancement.

perform_ncoa : boolean

Whether to update addresses for records matching the National Change of Address (NCOA) database.

output_level : string

The set of fields persisted by a CASS or NCOA enhancement.For CASS enhancements, one of ‘cass’ or ‘all.’For NCOA enhancements, one of ‘cass’, ‘ncoa’ , ‘coalesced’ or ‘all’.By default, all fields will be returned.

enhanced_table_name : string

The name of the table created by the enhancement.

ncoa_credential_id : integer

Credential to use when performing NCOA updates. Required if ‘performNcoa’ is true.
post_enhancements_geocodings(source_table_id)

Geocode a table

Parameters:

source_table_id : integer

The ID of the table to be enhanced.
Returns:

state : string

The state of the enhancement, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

enhanced_table_name : string

The name of the table created by the enhancement.

id : integer

The ID of the enhancement.

enhanced_table_schema : string

The schema name of the table created by the enhancement.

source_table_id : integer

The ID of the table that was enhanced.
post_enhancements_prepared_matchings(source_table_id, match_table_id, threshold, **kwargs)

Match person records against a dynamo table prepared by Civis

Parameters:

source_table_id : integer

The ID of the table to be enhanced.

match_table_id : integer

The ID of the Dynamo table to match against.

threshold : number/float

The confidence threshold which must be met for two individuals to be declared a match. Must be less than or equal to 1 and greater than or equal to 0.

max_matches : integer, optional

The maximum number of individuals a person may be matched with.A value of 0 indicates that all matches should be returned.
Returns:

state : string

The state of the enhancement, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

max_matches : integer

The maximum number of individuals a person may be matched with.A value of 0 indicates that all matches should be returned.

id : integer

The ID of the enhancement.

source_table_id : integer

The ID of the table that was enhanced.

enhanced_table_schema : string

The schema name of the table created by the enhancement.

match_table_id : integer

The ID of the Dynamo table to match against.

enhanced_table_name : string

The name of the table created by the enhancement.

threshold : number/float

The confidence threshold which must be met for two individuals to be declared a match. Must be less than or equal to 1 and greater than or equal to 0.
post_enhancements_table_matchings(source_table_id, match_table_id, threshold, **kwargs)

Match person records against an arbitrary Redshift table

Parameters:

source_table_id : integer

The ID of the table to be enhanced.

match_table_id : integer

The ID of the Redshift table to match against.

threshold : number/float

The confidence threshold which must be met for two individuals to be declared a match. Must be less than or equal to 1 and greater than or equal to 0.

max_matches : integer, optional

The maximum number of individuals a person may be matched with.A value of 0 indicates that all matches should be returned.
Returns:

state : string

The state of the enhancement, one of ‘queued’ ‘running’ ‘succeeded’ ‘failed’ or ‘cancelled’.

max_matches : integer

The maximum number of individuals a person may be matched with.A value of 0 indicates that all matches should be returned.

id : integer

The ID of the enhancement.

source_table_id : integer

The ID of the table that was enhanced.

enhanced_table_schema : string

The schema name of the table created by the enhancement.

match_table_id : integer

The ID of the Redshift table to match against.

enhanced_table_name : string

The name of the table created by the enhancement.

threshold : number/float

The confidence threshold which must be met for two individuals to be declared a match. Must be less than or equal to 1 and greater than or equal to 0.
post_refresh(id)

Request a refresh for column and table statistics

Parameters:

id : integer
Returns:

sortkeys : string

The column used as the Amazon Redshift sortkey.

id : integer

The ID of the table.

view_def : string

joins : list:

- id : integer
- right_identifier : string
- left_table_id : integer
- right_table_id : integer
- updated_at : string/time
- on : string
- left_join : boolean
- created_at : string/time
- left_identifier : string

refresh_status : string

How up-to-date the table’s statistics on row counts, null counts, distinct counts, and values distributions are. One of: refreshing, stale, or current.

last_refresh : string/date-time

The time of the last statistics refresh.

description : string

The description of the table, as specified by the table owner

is_view : boolean

True if this table represents a view. False if it represents a regular table.

refresh_id : string

The ID of the most recent statistics refresh.

ontology_mapping : dict

The ontology-key to column-name mapping. See /ontology for the list of valid ontology keys.

enhancements : list:

- updated_at : string/time
- join_id : integer
- created_at : string/time
- type : string

size_mb : number/float

The size of the table in megabytes.

schema : string

The name of the schema containing the table.

owner : string

The database username of the table’s owner.

row_count : integer

The number of rows in the table.

multipart_key : list

column_count : integer

The number of columns in the table.

distkey : string

The column used as the Amazon Redshift distkey.

columns : list:

- coverage_count : integer
    Number of non-null values in the column.
- description : string
    The description of the column, as specified by the table owner
- encoding : string
    The compression encoding for this columnSee: http://docs.aws.amazon.com
    /redshift/latest/dg/c_Compression_encodings.html
- sql_type : string
    SQL type of the column.
- value_distribution_percent : dict
    A mapping between each value in the column and the percentage of rows
    with that value.Only present for tables with fewer than approximately
    25,000,000 rows and for columns with fewer than twenty distinct values.
- min_value : string
    Smallest value in the column.
- order : integer
    Relative position of the column in the table.
- stddev : number/float
    Stddev of the column, where applicable.
- sample_values : list
    A sample of values from the column.
- useable_as_independent_variable : boolean
    Whether the column may be used as an independent variable to train a
    model.
- useable_as_primary_key : boolean
    Whether the column may be used as an primary key to identify table
    rows.
- distinct_count : integer
    Number of distinct values in the column.
- value_distribution : dict
    An object mapping distinct values in the column to the number of times
    they appear in the column
- possible_dependent_variable_types : list
    Possible dependent variable types the column may be used to model.
    Null if it may not be used as a dependent variable.
- null_count : integer
    Number of null values in the column.
- max_value : string
    Largest value in the column.
- avg_value : number/float
    Average value of the column, where applicable.
- name : string
    Name of the column.

last_run : dict:

- state : string
- id : integer
- finished_at : string/time
    The time that the run completed.
- started_at : string/time
    The time that the run started.
- error : string
    The error message for this run, if present.
- created_at : string/time
    The time that the run was queued.

database_id : integer

The ID of the database.

name : string

Name of the table.

outgoing_table_matches : list:

- target_id : integer
    Target ID
- target : dict::
    - name : string
- target_type : string
    Target type
- job : dict::
    - state : string
        Whether the job is idle, queued, running, cancelled, or failed.
    - runs : list::
        Information about the most recent runs of the job.
        - state : string
        - id : integer
        - finished_at : string/time
            The time that the run completed.
        - started_at : string/time
            The time that the run started.
        - error : string
            The error message for this run, if present.
        - created_at : string/time
            The time that the run was queued.
    - id : integer
    - hidden : boolean
        The hidden status of the object. Setting this to true hides it from
        most API endpoints. The object can still be queried directly by ID
    - type : string
    - updated_at : string/date-time
    - last_run : dict::
        - state : string
        - id : integer
        - finished_at : string/time
            The time that the run completed.
        - started_at : string/time
            The time that the run started.
        - error : string
            The error message for this run, if present.
        - created_at : string/time
            The time that the run was queued.
    - match_options : dict::
        - max_matches : integer
        - threshold : string
    - created_at : string/date-time
    - name : string
- source_table_id : integer
    Source table
Users
class Users(session, return_type='civis')

Methods

delete_api_keys(id, key_id) Revoke the specified API key
get(id) Show info about a user
get_api_keys(id, key_id) Show the specified API key
list(**kwargs) List users
list_api_keys(id, **kwargs) Show API keys belonging to the specified user
list_me() Show info about the logged-in user
patch_me(**kwargs) Update info about the logged-in user
post_api_keys(id, expires_in, name, **kwargs) Create a new API key belonging to the logged-in user
delete_api_keys(id, key_id)

Revoke the specified API key

Parameters:

id : string

The ID of the user or ‘me’.

key_id : integer

The ID of the API key.
Returns:

last_used_at : string/date-time

The date and time when the key was last used.

constraints : list:

Constraints on the abilities of the created key
- get_allowed : boolean
    Whether the constraint allows GET requests.
- patch_allowed : boolean
    Whether the constraint allows PATCH requests.
- head_allowed : boolean
    Whether the constraint allows HEAD requests.
- constraint_type : string
    The type of constraint (exact/prefix/regex/verb).
- delete_allowed : boolean
    Whether the constraint allows DELETE requests.
- post_allowed : boolean
    Whether the constraint allows POST requests.
- constraint : string
    The path matcher of the constraint.
- put_allowed : boolean
    Whether the constraint allows PUT requests.

id : integer

The ID of the API key.

revoked_at : string/date-time

The date and time when the key was revoked.

use_count : integer

The number of times the key has been used.

expired : boolean

True if the key has expired.

expires_at : string/date-time

The date and time when the key expired.

active : boolean

True if the key has neither expired nor been revoked.

scopes : list

The scopes which the key is permissioned on.

created_at : string/date-time

The date and time when the key was created.

name : string

The name of the API key.
get(id)

Show info about a user

Parameters:

id : integer

The ID of this user.
Returns:

state : string

The state of this user.

time_zone : string

The time zone of this user.

id : integer

The ID of this user.

prefers_sms_otp : string

The preference for phone authorization of this user

groups : list:

An array of all the groups this user is in.
- id : integer
    The ID of this group.
- organization_id : integer
    The organization associated with this group.
- name : string
    The name of this group.

github_username : string

The GitHub username of this user.

vpn_enabled : string

The availability of vpn for this user.

user : string

The username of this user.

phone : string

The phone number of this user.

title : string

The title of this user.

email : string

The email of this user.

primary_group_id : integer

The ID of the primary group of this user.

otp_required_for_login : string

The two factor authorization requirement for this user.

initials : string

The initials of this user.

department : string

The deartment of this user.

city : string

The city of this user.

active : string

The account status of this user.

name : string

The name of this user.
get_api_keys(id, key_id)

Show the specified API key

Parameters:

id : string

The ID of the user or ‘me’.

key_id : integer

The ID of the API key.
Returns:

last_used_at : string/date-time

The date and time when the key was last used.

constraints : list:

Constraints on the abilities of the created key
- get_allowed : boolean
    Whether the constraint allows GET requests.
- patch_allowed : boolean
    Whether the constraint allows PATCH requests.
- head_allowed : boolean
    Whether the constraint allows HEAD requests.
- constraint_type : string
    The type of constraint (exact/prefix/regex/verb).
- delete_allowed : boolean
    Whether the constraint allows DELETE requests.
- post_allowed : boolean
    Whether the constraint allows POST requests.
- constraint : string
    The path matcher of the constraint.
- put_allowed : boolean
    Whether the constraint allows PUT requests.

id : integer

The ID of the API key.

revoked_at : string/date-time

The date and time when the key was revoked.

use_count : integer

The number of times the key has been used.

expired : boolean

True if the key has expired.

expires_at : string/date-time

The date and time when the key expired.

active : boolean

True if the key has neither expired nor been revoked.

scopes : list

The scopes which the key is permissioned on.

created_at : string/date-time

The date and time when the key was created.

name : string

The name of the API key.
list(**kwargs)

List users

Parameters:

feature_flag : string, optional

Return users that have a feature flag enabled.

account_status : string, optional

The account status by which to filter users. May be one of “active”, “inactive”, or “all”.

query : string, optional

Return users who match the given query, based on name, user, and email.

group_id : integer, optional

The ID of the group by which to filter users. Cannot be present if organization_id is.

organization_id : integer, optional

The ID of the organization by which to filter users. Cannot be present if group_id is.

limit : integer, optional

Number of results to return. Defaults to 20. Maximum allowed is 10000.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to name. Must be one of: name, user.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to asc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

primary_group_id : integer

The ID of the primary group of this user.

id : integer

The ID of this user.

current_sign_in_at : string/date-time

The date and time when the user’s current session began.

groups : list:

An array of all the groups this user is in.
- id : integer
    The ID of this group.
- organization_id : integer
    The organization associated with this group.
- name : string
    The name of this group.

name : string

The name of this user.

user : string

The username of this user.

active : string

The account status of this user.

created_at : string/date-time

The date and time when the user was created.

email : string

The email of this user.
list_api_keys(id, **kwargs)

Show API keys belonging to the specified user

Parameters:

id : string

The ID of the user or ‘me’.

limit : integer, optional

Number of results to return. Defaults to its maximum of 50.

page_num : integer, optional

Page number of the results to return. Defaults to the first page, 1.

order : string, optional

The field on which to order the result set. Defaults to id. Must be one of: id.

order_dir : string, optional

Direction in which to sort, either asc (ascending) or desc (descending) defaulting to desc.

iterator : bool, optional

If True, return a generator to iterate over all responses. Use when more results than the maximum allowed by limit are needed. When True, limit and page_num are ignored. Defaults to False.
Returns:

last_used_at : string/date-time

The date and time when the key was last used.

constraint_count : integer

The number of constraints on the created key

id : integer

The ID of the API key.

revoked_at : string/date-time

The date and time when the key was revoked.

use_count : integer

The number of times the key has been used.

expired : boolean

True if the key has expired.

expires_at : string/date-time

The date and time when the key expired.

active : boolean

True if the key has neither expired nor been revoked.

scopes : list

The scopes which the key is permissioned on.

created_at : string/date-time

The date and time when the key was created.

name : string

The name of the API key.
list_me()

Show info about the logged-in user

Returns:

id : integer

The ID of this user.

groups : list:

An array of all the groups this user is in.
- id : integer
    The ID of this group.
- organization_id : integer
    The organization associated with this group.
- name : string
    The name of this group.

organization_name : string

The name of the organization the user belongs to.

feature_flags : dict

The feature flag settings for this user.

roles : list

The roles this user has, listed by slug.

username : string

This user’s username.

custom_branding : string

The branding of Platform for this user.

last_checked_announcements : string/date-time

The date and time at which the user last checked their announcements.

initials : string

This user’s initials.

preferences : dict

This user’s preferences.

email : string

This user’s email address.

name : string

This user’s name.
patch_me(**kwargs)

Update info about the logged-in user

Parameters:

preferences : dict, optional:

- project_detail_order_dir : string
    Order direction for projects detail pages.
- result_index_type_filter : string
    Type filter for the results index page.
- result_index_order_dir : string
    Order direction for the results index page.
- model_index_order_field : string
    Order field for the models index page.
- enhancement_index_order_field : string
    Order field for the enhancements index page.
- export_index_order_dir : string
    Order direction for the exports index page.
- civis_explore_skip_intro : boolean
    Whether the user is shown steps for each exploration.
- import_index_order_field : string
    Order field for the imports index page.
- result_index_order_field : string
    Order field for the results index page.
- enhancement_index_archived_filter : string
    Archived filter for the enhancements index page.
- script_index_author_filter : string
    Author filter for the scripts index page.
- import_index_type_filter : string
    Type filter for the imports index page.
- script_index_archived_filter : string
    Archived filter for the scripts index page.
- script_index_order_dir : string
    Order direction for the scripts index page.
- app_index_order_dir : string
    Oder direction for the apps index pages.
- enhancement_index_author_filter : string
    Author filter for the enhancements index page.
- export_index_type_filter : string
    Type filter for the exports index page.
- import_index_dest_filter : string
    Destination filter for the imports index page.
- import_index_status_filter : string
    Status filter for the imports index page.
- model_index_thumbnail_view : string
    Thumbnail view for the models index page.
- app_index_order_field : string
    Order field for the apps index pages.
- result_index_archived_filter : string
    Archived filter for the results index page.
- model_index_status_filter : string
    Status filter for the models index page.
- script_index_order_field : string
    Order field for the scripts index page.
- project_detail_author_filter : string
    Author filter for projects detail pages.
- project_index_order_dir : string
    Order direction for the projects index page.
- export_index_status_filter : string
    Status filter for the exports index page.
- project_index_archived_filter : string
    Archived filter for the projects index page.
- model_index_author_filter : string
    Author filter for the models index page.
- project_index_order_field : string
    Order field for the projects index page.
- enhancement_index_order_dir : string
    Order direction for the enhancements index page.
- preferred_server_id : integer
    ID of preferred server.
- project_detail_order_field : string
    Order field for projects detail pages.
- script_index_type_filter : string
    Type filter for the scripts index page.
- import_index_order_dir : string
    Order direction for the imports index page.
- export_index_order_field : string
    Order field for the exports index page.
- import_index_archived_filter : string
    Archived filter for the imports index page.
- result_index_author_filter : string
    Author filter for the results index page.
- model_index_archived_filter : string
    Archived filter for the models index page.
- model_index_order_dir : string
    Order direction for the models index page.
- project_detail_archived_filter : string
    Arhived filter for the projects detail pages.
- script_index_status_filter : string
    Status filter for the scripts index page.
- export_index_author_filter : string
    Author filter for the exports index page.
- project_index_author_filter : string
    Author filter for the projects index page.
- report_index_thumbnail_view : string
    Thumbnail view for the reports index page.
- project_detail_type_filter : string
    Type filter for projects detail pages.
- import_index_author_filter : string
    Author filter for the imports index page.

last_checked_announcements : string/date-time, optional

The date and time at which the user last checked their announcements.
Returns:

id : integer

The ID of this user.

groups : list:

An array of all the groups this user is in.
- id : integer
    The ID of this group.
- organization_id : integer
    The organization associated with this group.
- name : string
    The name of this group.

organization_name : string

The name of the organization the user belongs to.

feature_flags : dict

The feature flag settings for this user.

roles : list

The roles this user has, listed by slug.

username : string

This user’s username.

custom_branding : string

The branding of Platform for this user.

last_checked_announcements : string/date-time

The date and time at which the user last checked their announcements.

initials : string

This user’s initials.

preferences : dict

This user’s preferences.

email : string

This user’s email address.

name : string

This user’s name.
post_api_keys(id, expires_in, name, **kwargs)

Create a new API key belonging to the logged-in user

Parameters:

id : string

The ID of the user or ‘me’.

expires_in : integer

The number of seconds the key should last for.

name : string

The name of the API key.

constraints : list, optional:

Constraints on the abilities of the created key.
- get_allowed : boolean
    Whether the constraint allows GET requests.
- patch_allowed : boolean
    Whether the constraint allows PATCH requests.
- head_allowed : boolean
    Whether the constraint allows HEAD requests.
- constraint_type : string
    The type of constraint (exact/prefix/regex/verb).
- delete_allowed : boolean
    Whether the constraint allows DELETE requests.
- post_allowed : boolean
    Whether the constraint allows POST requests.
- constraint : string
    The path matcher of the constraint.
- put_allowed : boolean
    Whether the constraint allows PUT requests.
Returns:

id : integer

The ID of the API key.

expired : boolean

True if the key has expired.

expires_at : string/date-time

The date and time when the key expired.

scopes : list

The scopes which the key is permissioned on.

created_at : string/date-time

The date and time when the key was created.

last_used_at : string/date-time

The date and time when the key was last used.

constraints : list:

Constraints on the abilities of the created key
- get_allowed : boolean
    Whether the constraint allows GET requests.
- patch_allowed : boolean
    Whether the constraint allows PATCH requests.
- head_allowed : boolean
    Whether the constraint allows HEAD requests.
- constraint_type : string
    The type of constraint (exact/prefix/regex/verb).
- delete_allowed : boolean
    Whether the constraint allows DELETE requests.
- post_allowed : boolean
    Whether the constraint allows POST requests.
- constraint : string
    The path matcher of the constraint.
- put_allowed : boolean
    Whether the constraint allows PUT requests.

token : string

The API key.

revoked_at : string/date-time

The date and time when the key was revoked.

active : boolean

True if the key has neither expired nor been revoked.

use_count : integer

The number of times the key has been used.

name : string

The name of the API key.

Command Line Interface

A command line interface (CLI) to Civis is provided. This can be invoked by typing the command civis in the shell (sh, bash, zsh, etc.). It can also be used in Civis container scripts where the Docker image has this client installed. Here’s a simple example of printing the types of scripts.

> civis scripts list-types
- name: sql
- name: python3
- name: javascript
- name: r
- name: containers

Not all API endpoints are available through the CLI since some take complex data types (e.g., arrays, objects/dictionaries) as input. However, functionality is available for getting information about scripts, logs, etc., as well as executing already created scripts.

There are a few extra, CLI-only commands that wrap the Files API endpoints to make uploading and downloading files easier: civis files upload $PATH and civis files download $FILEID $PATH.

The default output format is YAML, but the --json-output allows you to get output in JSON.

Indices and tables