client.scripts.get_javascript

A method of the Scripts endpoint.

get_javascript(id: int) → Response

Get a JavaScript Script

API URL: GET /scripts/javascript/{id}

import civis
client = civis.APIClient()
response = client.scripts.get_javascript(...)

Parameters:

idint

Returns:

civis.Response

• idint

  The ID for the script.

• namestr

  The name of the script.

• typestr

  The type of the script (e.g SQL, Container, Python, R, JavaScript, dbt)

• created_atstr (time)

  The time this script was created.

• updated_atstr (time)

  The time the script was last updated.

• authorcivis.Response

  • idint

    The ID of this user.

  • namestr

    This user’s name.

  • usernamestr

    This user’s username.

  • initialsstr

    This user’s initials.

  • onlinebool

    Whether this user is online.

• statestr

  The status of the script’s last run.

• finished_atstr (time)

  The time that the script’s last run finished.

• categorystr

  The category of the script.

• projectsList[civis.Response]

  A list of projects containing the script.

  • idint

    The ID for the project.

  • namestr

    The name of the project.

• parent_idint

  The ID of the parent job that will trigger this script

• user_contextstr

  “runner” or “author”, who to execute the script as when run as a template.

• paramsList[civis.Response]

  A definition of the parameters this script accepts in the arguments field.

  • namestr

    The variable’s name as used within your code.

  • labelstr

    The label to present to users when asking them for the value.

  • descriptionstr

    A short sentence or fragment describing this parameter to the end user.

  • typestr

    The type of parameter. Valid options: string, multi_line_string, integer, float, bool, file, table, database, credential_aws, credential_redshift, or credential_custom

  • requiredbool

    Whether this param is required.

  • valueobject

    The value you would like to set this param to. Setting this value makes this parameter a fixed param.

  • defaultstr

    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.

  • allowed_valuesList[civis.Response]

    The possible values this parameter can take, effectively making this an enumerable parameter. Allowed values is an array of hashes of the following format: {label: ‘Import’, ‘value’: ‘import’}

• argumentscivis.Response

  Parameter-value pairs to use when running this script. Only settable if this script has defined parameters.

• is_templatebool

  Whether others scripts use this one as a template.

• published_as_template_idint

  The ID of the template that this script is backing.

• from_template_idint

  The ID of the template this script uses, if any.

• template_dependents_countint

  How many other scripts use this one as a template.

• template_script_namestr

  The name of the template script.

• linkscivis.Response

  • detailsstr

    The details link to get more information about the script.

  • runsstr

    The runs link to get the run information list for this script.

• schedulecivis.Response

  • scheduledbool

    If the item is scheduled.

  • scheduled_daysList[int]

    Days of the week, based on numeric value starting at 0 for Sunday. Mutually exclusive with scheduledDaysOfMonth

  • scheduled_hoursList[int]

    Hours of the day it is scheduled on.

  • scheduled_minutesList[int]

    Minutes of the day it is scheduled on.

  • scheduled_runs_per_hourint

    Deprecated in favor of scheduled minutes.

  • scheduled_days_of_monthList[int]

    Days of the month it is scheduled on, mutually exclusive with scheduledDays.

• notificationscivis.Response

  • urlsList[str]

    URLs to receive a POST request at job completion

  • success_email_subjectstr

    Custom subject line for success e-mail.

  • success_email_bodystr

    Custom body text for success e-mail, written in Markdown.

  • success_email_addressesList[str]

    Addresses to notify by e-mail when the job completes successfully.

  • success_email_from_namestr

    Name from which success emails are sent; defaults to “Civis.”

  • success_email_reply_tostr

    Address for replies to success emails; defaults to the author of the job.

  • failure_email_addressesList[str]

    Addresses to notify by e-mail when the job fails.

  • stall_warning_minutesint

    Stall warning emails will be sent after this amount of minutes.

  • success_onbool

    If success email notifications are on. Defaults to user’s preferences.

  • failure_onbool

    If failure email notifications are on. Defaults to user’s preferences.

• running_ascivis.Response

  • idint

    The ID of this user.

  • namestr

    This user’s name.

  • usernamestr

    This user’s username.

  • initialsstr

    This user’s initials.

  • onlinebool

    Whether this user is online.

• next_run_atstr (time)

  The time of the next scheduled run.

• time_zonestr

  The time zone of this script.

• last_runcivis.Response

  • id : int

  • statestr

    The state of the run. One of queued, running, succeeded, failed or cancelled.

  • created_atstr (time)

    The time that the run was queued.

  • started_atstr (time)

    The time that the run started.

  • finished_atstr (time)

    The time that the run completed.

  • errorstr

    The error message for this run, if present.

• my_permission_levelstr

  Your permission level on the object. One of “read”, “write”, or “manage”.

• hiddenbool

  The hidden status of the item.

• target_project_idint

  Target project to which script outputs will be added.

• archivedbool

  The archival status of the requested item(s).

• sourcestr

  The body/text of the script.

• remote_host_idint

  The remote host ID that this script will connect to.

• credential_idint

  The credential that this script will use.

• running_as_idint

  The ID of the runner of this script.