unSkript Documentation
Free SandboxBlogGitHubSlack Community
  • What is unSkript?
  • Guides
    • Contribute to Open Source
    • Getting started
      • Sign Up/Install
      • Authentication
        • Okta configuration
          • Okta Groups Sync
      • Create a Proxy
      • Add Credentials to Connect your Resources
      • Key Terms
  • RunBooks
    • Prebuilt xRunBooks
      • xRunBooks for CloudOps
      • xRunBooks for Cost Optimization
      • xRunBooks for DevOps
      • xRunBooks for IAM
      • xRunBooks for SecOps
      • xRunBooks for SRE
      • xRunBooks for Troubleshooting
    • Creating RunBooks
      • Importing unSkript xRunBooks
      • Create a xRunBook
      • Add an Action
      • Connecting Actions
      • Create a RunBook Input Parameter
      • Create a Credential
      • Writing Notes
      • Running XRunBooks
        • Running RunBooks with Approvals
      • Schedules
      • xRunBook Executions
      • Alarms
        • Create an Alarm Webhook
          • Webhooks for onprem installations
        • Create a Grafana Alert
        • Attaching runbooks to alarms
      • Folders
      • RunBook Outputs
  • Actions
    • What is an Action?
    • Create Custom Actions
    • Create Actions with AI
    • Actions
      • Action Configuration
        • Configure Action Inputs
        • Add Action Inputs
        • Action Output
        • Action Iterator
          • Using Iterators
        • Action Poll
        • Action Start Condition
      • Anatomy of an Action
    • Prebuilt Actions
  • Healthchecks
    • What is a HealthCheck?
    • Create a HealthCheck
      • Create a HealthCheck Folder
      • Adding Checks
    • HealthCheck Parameters
    • Running HealthChecks
    • HealthCheck Remediation
  • Workflows
    • What is a Workflow?
  • Connnecting
    • Connectors
      • Airflow
        • Airflow Actions
      • AWS
        • AWS Actions
          • AWS Cloudwatch Actions
          • AWS EC2 Actions
          • AWS ECS Actions
          • AWS EKS Actions
          • AWS ELB Actions
          • AWS IAM Actions
          • AWS Postgres Actions
          • AWS RDS Actions
          • AWS RedShift Actions
          • AWS S3 Actions
          • AWS VPC Actions
      • Azure
        • Azure Actions
      • ChatGPT
        • ChatGPT Actions
      • Datadog
        • Configuring webhook in Datadog
        • Datadog Actions
          • Datadog Alert Actions
          • Datadog Metrics Actions
          • Datadog Monitor Actions
      • Elasticsearch
        • Elasticsearch Actions
      • GCP
        • GCP Actions
          • GCP Bucket Actions
          • GCP GKE Actions
          • GCP IAM Actions
          • GCP VM Actions
      • Github
        • Github Actions
      • Grafana
        • Grafana Actions
      • Hadoop
        • Hadoop Actions
      • Jenkins
        • Jenkins Actions
      • Jira
        • Jira Actions
      • Kafka
        • Kafka Actions
      • Kubernetes
        • K8s Actions
      • MongoDB
        • MongoDB Actions
      • MS SQL
        • MSSQL Actions
      • MySQL
        • MySQL Actions
      • Netbox
        • Netbox Actions
      • Nomad
        • Nomad Actions
      • OpenSearch
        • opensearch Actions
      • Pingdom
        • Pingdom Actions
      • Postgres
        • Postgres Actions
      • Prometheus
        • Prometheus Actions
      • Redis
        • Redis Actions
      • REST
        • REST Actions
      • SalesForce
        • SalesForce Actions
      • Slack
        • Slack Actions
      • Snowflake
        • Snowflake Actions
      • Splunk
        • Splunk Actions
      • SSH
        • SSH Actions
      • Stripe
        • Stripe Actions
      • Terraform
        • Terraform Actions
      • Zabbix
    • Proxies
      • Environment
        • RunBooks Across Environments: ServiceIDs
      • unSkript Proxy
      • AWS Proxy
      • GCP Proxy
    • Secret store
      • Vault
  • Tooling
    • Role Based Access Control
      • RBAC Roles
    • API reference
      • Authentication
      • Endpoints
        • Executions
        • RunBooks
        • Schedules
    • Command Line Tool
    • Notifications
  • Fundamentals
    • Jupyter Notebook 101
  • Use Cases
    • DevOps
    • SRE
  • Open source
    • Runbooks.sh
    • Contribute to Open Source
  • Lists
    • AWS Service Quota list
Powered by GitBook
On this page

Was this helpful?

  1. Tooling
  2. API reference
  3. Endpoints

Executions

PreviousEndpointsNextRunBooks

Last updated 1 year ago

Was this helpful?

List all Executions

Curl Example:

curl 'https://<domain>/v1alpha1/executions?pageSize=10' -H "X-unSkript-API-Key:<api token>"

Get Details of a Specific Execution

Curl Example:

curl  'https://<domain>/v1alpha1/executions/10007011-12a6-41c1-98ea-1b3ced62604e' \
      -H "X-unSkript-API-Key:<api token>"
      

Lists execution

get

Lists executions matching the optional filter

Query parameters
reqHdr.tidstringOptional

tid is the unique request id.

pageSizeinteger ยท int32Optional

page_size specifies the maximum number of results to be returned.

Example: {"value":25}
pageTokenstringOptional

page_token is used to request a specific page of the list results.

filterstringOptional

filter expression.

orderBystringOptional

order_by is used to sort the fields by ascending or descending.

timeRangestringOptional

Time Range is used to filter the data by last month, last year and by default is all.

Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
get
GET /v1alpha1/executions HTTP/1.1
Host: 
Accept: */*
{
  "respHdr": {
    "tid": "text",
    "requestTid": "text"
  },
  "execution": [
    {
      "id": "text",
      "workflowName": "text",
      "createTime": "2025-05-09T12:48:50.832Z",
      "startTime": "2025-05-09T12:48:50.832Z",
      "endTime": "2025-05-09T12:48:50.832Z",
      "duration": "text",
      "version": "text",
      "executionStatus": "EXECUTION_STATUS_UNSPECIFIED",
      "inputs": "text",
      "output": "text",
      "executor": "text",
      "approver": "text",
      "reason": "text",
      "executionType": "EXECUTION_TYPE_UNSPECIFIED"
    }
  ],
  "statusTable": {
    "ANY_ADDITIONAL_PROPERTY": 1
  },
  "nextPageToken": "text",
  "pageCount": 1,
  "aggregateTotalTable": {
    "ANY_ADDITIONAL_PROPERTY": 1
  }
}

Get execution details

get

Gets execution details

Path parameters
executionIdstringRequired

execution_id is the id of execution.

Query parameters
reqHdr.tidstringOptional

tid is the unique request id.

summarybooleanOptional

summary gives the execution details without the output field.

Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
get
GET /v1alpha1/executions/{executionId} HTTP/1.1
Host: 
Accept: */*
{
  "respHdr": {
    "tid": "text",
    "requestTid": "text"
  },
  "execution": {
    "id": "text",
    "workflowName": "text",
    "createTime": "2025-05-09T12:48:50.832Z",
    "startTime": "2025-05-09T12:48:50.832Z",
    "endTime": "2025-05-09T12:48:50.832Z",
    "duration": "text",
    "version": "text",
    "executionStatus": "EXECUTION_STATUS_UNSPECIFIED",
    "inputs": "text",
    "output": "text",
    "executor": "text",
    "approver": "text",
    "reason": "text",
    "executionType": "EXECUTION_TYPE_UNSPECIFIED"
  }
}
  • List all Executions
  • GETLists execution
  • Get Details of a Specific Execution
  • GETGet execution details