Altair SLC Hub Pipelines (2024.0.0)

Download OpenAPI specification:Download

Authentication

bearerAuth

Security Scheme Type HTTP
HTTP Authorization Scheme bearer
Bearer format "JWT"

queryPipelineFolderEntries

Queries pipeline folder entries

Authorizations:
query Parameters
filter[namespace][EQ]
string
filter[namespace][IN]
Array of strings
filter[name][EQ]
string
filter[name][CO]
string
filter[name][ST]
string
filter[folderId][EQ]
string
filter[folderPath][EQ]
string
filter[_type][EQ]
string (pipelineEntityType)
Enum: "Pipeline" "Folder"
filter[_id][IN]
Array of strings
filter[_created][LT]
string <date-time>
filter[_created][GT]
string <date-time>
filter[_modified][LT]
string <date-time>
filter[_modified][GT]
string <date-time>
page[offset]
integer
page[limit]
integer
sort
string
Enum: "_created" "-_created" "_modified" "-_modified" "name" "-name"

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "totalCount": 0
}

createPipelineTreeEntity

Creates a new pipeline or pipeline folder

Authorizations:
Request Body schema:
_id
string
_created
string <date-time>
_modified
string <date-time>
name
string
namespace
string
_type
string (pipelineEntityType)
folderId
string
folderPath
string
object (pipelineSpec)

Responses

Request samples

Content type
Example
{
  • "_id": "string",
  • "_created": "2019-08-24T14:15:22Z",
  • "_modified": "2019-08-24T14:15:22Z",
  • "name": "string",
  • "namespace": "string",
  • "_type": "Pipeline",
  • "folderId": "string",
  • "folderPath": "string",
  • "spec": {
    }
}

Response samples

Content type
application/json
Example
{
  • "_id": "string",
  • "_created": "2019-08-24T14:15:22Z",
  • "_modified": "2019-08-24T14:15:22Z",
  • "name": "string",
  • "namespace": "string",
  • "_type": "Pipeline",
  • "folderId": "string",
  • "folderPath": "string",
  • "spec": {
    }
}

pipelineNameAvailability

Authorizations:
query Parameters
name
required
string
namespace
required
string
folderId
string

Responses

Response samples

Content type
application/json
{
  • "result": true,
  • "reason": "invalid",
  • "msg": "string"
}

getPipelineTreeEntity

Authorizations:
path Parameters
id
required
string
query Parameters
fields
Array of strings (pipelineFolderEntryEntityField)
Items Enum: "_id" "_created" "_modified" "_type" "name" "folderId" "folderPath"

Responses

Response samples

Content type
application/json
Example
{
  • "_id": "string",
  • "_created": "2019-08-24T14:15:22Z",
  • "_modified": "2019-08-24T14:15:22Z",
  • "name": "string",
  • "namespace": "string",
  • "_type": "Pipeline",
  • "folderId": "string",
  • "folderPath": "string",
  • "spec": {
    }
}

replacePipelineTreeEntity

Replaces the definition of the entity. In most cases it is preferable to use the PATCH method.

It is not permitted to change a pipeline into a folder or vice versa. The _id, _created and _modified fields in the request body are ignored

Authorizations:
path Parameters
id
required
string
Request Body schema: application/json
_id
string
_created
string <date-time>
_modified
string <date-time>
name
string
namespace
string
_type
string (pipelineEntityType)
folderId
string
folderPath
string
object (pipelineSpec)

Responses

Request samples

Content type
application/json
Example
{
  • "_id": "string",
  • "_created": "2019-08-24T14:15:22Z",
  • "_modified": "2019-08-24T14:15:22Z",
  • "name": "string",
  • "namespace": "string",
  • "_type": "Pipeline",
  • "folderId": "string",
  • "folderPath": "string",
  • "spec": {
    }
}

Response samples

Content type
application/json
Example
{
  • "_id": "string",
  • "_created": "2019-08-24T14:15:22Z",
  • "_modified": "2019-08-24T14:15:22Z",
  • "name": "string",
  • "namespace": "string",
  • "_type": "Pipeline",
  • "folderId": "string",
  • "folderPath": "string",
  • "spec": {
    }
}

patchPipelineTreeEntity

Applies a modification to the entity using a JSON Patch document.

It is not permitted to change a pipeline into a folder or vice versa. Any attempt to change the _id, _created and _modified fields are ignored

Authorizations:
path Parameters
id
required
string
Request Body schema: application/json-patch+json
Array ()
op
required
string
Enum: "add" "remove" "replace"

The operation to be performed

path
required
string

A JSON-Pointer

value
any

The value to be used within the operations.

Responses

Request samples

Content type
application/json-patch+json
[
  • {
    }
]

Response samples

Content type
application/json
Example
{
  • "_id": "string",
  • "_created": "2019-08-24T14:15:22Z",
  • "_modified": "2019-08-24T14:15:22Z",
  • "name": "string",
  • "namespace": "string",
  • "_type": "Pipeline",
  • "folderId": "string",
  • "folderPath": "string",
  • "spec": {
    }
}

deletePipelineTreeEntity

Deletes the given pipeline or folder. If a folder is specified, a recursive deletion of the folder and all its contents is performed.

Authorizations:
path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "msg": "string"
}

submitPipeline

Submits the pipeline, creating a pipeline run

Authorizations:
path Parameters
id
required
string
Request Body schema: application/json
executionProfileId
required
string

Responses

Request samples

Content type
application/json
{
  • "executionProfileId": "string"
}

Response samples

Content type
application/json
{
  • "pipelineRunId": "string"
}

validatePipeline

Authorizations:
path Parameters
id
required
string

Responses

Response samples

Content type
application/json
{
  • "errors": [
    ]
}

validatePipelineTreeEntity

Validates a new pipeline or pipeline folder

Authorizations:
Request Body schema: application/json
_id
string
_created
string <date-time>
_modified
string <date-time>
name
string
namespace
string
_type
string (pipelineEntityType)
folderId
string
folderPath
string
object (pipelineSpec)

Responses

Request samples

Content type
application/json
Example
{
  • "_id": "string",
  • "_created": "2019-08-24T14:15:22Z",
  • "_modified": "2019-08-24T14:15:22Z",
  • "name": "string",
  • "namespace": "string",
  • "_type": "Pipeline",
  • "folderId": "string",
  • "folderPath": "string",
  • "spec": {
    }
}

Response samples

Content type
application/json
{
  • "errors": [
    ]
}

Queries current pipeline run instances

Authorizations:
query Parameters
filter[namespace][EQ]
string
filter[namespace][IN]
Array of strings
filter[created][LT]
string <date-time>
filter[created][GT]
string <date-time>
filter[startedAt][LT]
string <date-time>
filter[startedAt][GT]
string <date-time>
filter[finishedAt][LT]
string <date-time>
filter[finishedAt][GT]
string <date-time>
filter[state][EQ]
string (pipelineRunState)
Enum: "Queued" "Executing" "Succeeded" "Failed" "Cancelled"
filter[state][IN]
string
filter[ownerPrincipal][EQ]
string
filter[pipelineId][EQ]
string
page[offset]
integer
page[limit]
integer
sort
string
Enum: "created" "-created"

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Creates a new pipeline run

Authorizations:
Request Body schema: application/json

The definition of the pipeline. In the definition any value for the id, status or created fields will be ignored. That is, only the spec field is honoured

id
string
created
string <date-time>
ownerPrincipal
string
pipelineId
string
pipelinePath
string
object (pipelineRunStatus)
required
object (pipelineSpec)
entryPoint
string
executionProfileId
required
string

Responses

Request samples

Content type
application/json
{
  • "id": "string",
  • "created": "2019-08-24T14:15:22Z",
  • "ownerPrincipal": "string",
  • "pipelineId": "string",
  • "pipelinePath": "string",
  • "status": {
    },
  • "spec": {
    },
  • "entryPoint": "string",
  • "executionProfileId": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "created": "2019-08-24T14:15:22Z",
  • "ownerPrincipal": "string",
  • "pipelineId": "string",
  • "pipelinePath": "string",
  • "status": {
    },
  • "spec": {
    },
  • "entryPoint": "string",
  • "executionProfileId": "string"
}

Returns the given pipeline run

Authorizations:
path Parameters
pipelineRunId
required
string

ID of the pipeline run

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "created": "2019-08-24T14:15:22Z",
  • "ownerPrincipal": "string",
  • "pipelineId": "string",
  • "pipelinePath": "string",
  • "status": {
    },
  • "spec": {
    },
  • "entryPoint": "string",
  • "executionProfileId": "string"
}

Deletes the given pipeline run

Authorizations:
path Parameters
pipelineRunId
required
string

ID of the pipeline run

Responses

Response samples

Content type
application/json
{
  • "msg": "string"
}

Returns the current status of a given pipeline run by ID

Authorizations:
path Parameters
pipelineRunId
required
string

ID of the pipeline run

Responses

Response samples

Content type
application/json
{
  • "state": "Queued",
  • "startedAt": "2019-08-24T14:15:22Z",
  • "finishedAt": "2019-08-24T14:15:22Z",
  • "nodeStatus": {
    }
}

Returns a list of the results generated by all nodes in the given pipeline run

Authorizations:
path Parameters
pipelineRunId
required
string

ID of the pipeline run

Responses

Response samples

Content type
application/json
{
  • "property1": [
    ],
  • "property2": [
    ]
}

Returns the current status of a specific node in the given pipeline run

Authorizations:
path Parameters
pipelineRunId
required
string

ID of the pipeline run

nodeName
required
string

Name of the pipeline node

Responses

Response samples

Content type
application/json
{
  • "state": "Waiting",
  • "startedAt": "2019-08-24T14:15:22Z",
  • "finishedAt": "2019-08-24T14:15:22Z",
  • "exitCode": 0,
  • "events": [
    ]
}

Returns the standard output or standard error log from execution of a given node in a pipeline run

Authorizations:
path Parameters
pipelineRunId
required
string

ID of the pipeline run

nodeName
required
string

Name of the pipeline node

logType
required
string
Enum: "stdout" "stderr"

Type of log to return

Responses

Response samples

Content type
application/json
{
  • "msg": "string"
}

Returns a list of the results generated by the given node in a pipeline run

Authorizations:
path Parameters
pipelineRunId
required
string

ID of the pipeline run

nodeName
required
string

Name of the pipeline node

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Returns the content of the given node result

Authorizations:
path Parameters
pipelineRunId
required
string

ID of the pipeline run

nodeName
required
string

Name of the pipeline node

resultName
required
string

Name of the result

Responses

Response samples

Content type
application/json
{
  • "msg": "string"
}

Returns info for the given node result

Authorizations:
path Parameters
pipelineRunId
required
string

ID of the pipeline run

nodeName
required
string

Name of the pipeline node

resultName
required
string

Name of the result

Responses

Response samples

Content type
application/json
{
  • "name": "string",
  • "contentType": "string",
  • "size": 0
}

Requests cancellation of a pipeline run

Authorizations:
path Parameters
pipelineRunId
required
string

ID of the pipeline run

Responses

Response samples

Content type
application/json
{
  • "msg": "string"
}

Queries triggers for a given pipeline

Authorizations:
path Parameters
id
required
string
query Parameters
filter[type][EQ]
string (triggerType)
Enum: "Cron" "File"
filter[created][LT]
string <date-time>
filter[created][GT]
string <date-time>
filter[modified][LT]
string <date-time>
filter[modified][GT]
string <date-time>
filter[disabled][EQ]
boolean
page[offset]
integer
page[limit]
integer
sort
string
Enum: "created" "-created" "modified" "-modified"

Responses

Response samples

Content type
application/json
{
  • "totalCount": 0,
  • "data": [
    ]
}

Creates a new trigger

Authorizations:
path Parameters
id
required
string
Request Body schema: application/json
id
string
pipelineId
required
string
created
string <date-time>
modified
string <date-time>
runAsPrincipal
string
disabled
required
boolean
required
any (triggerSpec)
executionProfileId
required
string

Responses

Request samples

Content type
application/json
{
  • "id": "string",
  • "pipelineId": "string",
  • "created": "2019-08-24T14:15:22Z",
  • "modified": "2019-08-24T14:15:22Z",
  • "runAsPrincipal": "string",
  • "disabled": true,
  • "trigger": {
    },
  • "executionProfileId": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "pipelineId": "string",
  • "created": "2019-08-24T14:15:22Z",
  • "modified": "2019-08-24T14:15:22Z",
  • "runAsPrincipal": "string",
  • "disabled": true,
  • "trigger": {
    },
  • "executionProfileId": "string"
}

Queries triggers

Authorizations:
query Parameters
filter[namespace][EQ]
string
filter[namespace][IN]
Array of strings
filter[type][EQ]
string (triggerType)
Enum: "Cron" "File"
filter[pipelineId][EQ]
string
filter[runAsPrincipal][EQ]
string
filter[executionProfile][EQ]
string
filter[disabled][EQ]
boolean
filter[created][LT]
string <date-time>
filter[created][GT]
string <date-time>
filter[modified][LT]
string <date-time>
filter[modified][GT]
string <date-time>
page[offset]
integer
page[limit]
integer
sort
string
Enum: "created" "-created" "modified" "-modified"

Responses

Response samples

Content type
application/json
{
  • "totalCount": 0,
  • "data": [
    ]
}

Returns a pipeline trigger by ID

Authorizations:
path Parameters
triggerId
required
string

ID of the trigger

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "pipelineId": "string",
  • "created": "2019-08-24T14:15:22Z",
  • "modified": "2019-08-24T14:15:22Z",
  • "runAsPrincipal": "string",
  • "disabled": true,
  • "trigger": {
    },
  • "executionProfileId": "string"
}

Deletes a trigger by ID

Authorizations:
path Parameters
triggerId
required
string

ID of the trigger

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "pipelineId": "string",
  • "created": "2019-08-24T14:15:22Z",
  • "modified": "2019-08-24T14:15:22Z",
  • "runAsPrincipal": "string",
  • "disabled": true,
  • "trigger": {
    },
  • "executionProfileId": "string"
}

Replaces the definition of the given trigger

The values of the created and modified fields in the request body are ignored. If present the id field must match the ID of the trigger

Authorizations:
path Parameters
triggerId
required
string

ID of the trigger

Request Body schema: application/json
id
string
pipelineId
required
string
created
string <date-time>
modified
string <date-time>
runAsPrincipal
string
disabled
required
boolean
required
any (triggerSpec)
executionProfileId
required
string

Responses

Request samples

Content type
application/json
{
  • "id": "string",
  • "pipelineId": "string",
  • "created": "2019-08-24T14:15:22Z",
  • "modified": "2019-08-24T14:15:22Z",
  • "runAsPrincipal": "string",
  • "disabled": true,
  • "trigger": {
    },
  • "executionProfileId": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "pipelineId": "string",
  • "created": "2019-08-24T14:15:22Z",
  • "modified": "2019-08-24T14:15:22Z",
  • "runAsPrincipal": "string",
  • "disabled": true,
  • "trigger": {
    },
  • "executionProfileId": "string"
}

Patches the trigger with a JSON Patch document

Authorizations:
path Parameters
triggerId
required
string

ID of the trigger

Request Body schema: application/json-patch+json
Array ()
op
required
string
Enum: "add" "remove" "replace"

The operation to be performed

path
required
string

A JSON-Pointer

value
any

The value to be used within the operations.

Responses

Request samples

Content type
application/json-patch+json
[
  • {
    }
]

Response samples

Content type
application/json
{
  • "id": "string",
  • "pipelineId": "string",
  • "created": "2019-08-24T14:15:22Z",
  • "modified": "2019-08-24T14:15:22Z",
  • "runAsPrincipal": "string",
  • "disabled": true,
  • "trigger": {
    },
  • "executionProfileId": "string"
}

Returns the history of firings of the given trigger

Authorizations:
path Parameters
triggerId
required
string

ID of the trigger

query Parameters
filter[triggerTime][LT]
string <date-time>
filter[triggerTime][GT]
string <date-time>
page[offset]
integer
page[limit]
integer
sort
string
Enum: "triggerTime" "-triggerTime" "triggerId" "-triggerId"

Responses

Response samples

Content type
application/json
{
  • "totalCount": 0,
  • "data": [
    ]
}

Queries trigger firings for all triggers

Authorizations:
query Parameters
filter[triggerId][EQ]
string
filter[triggerTime][LT]
string <date-time>
filter[triggerTime][GT]
string <date-time>
page[offset]
integer
page[limit]
integer
sort
string
Enum: "triggerTime" "-triggerTime" "triggerId" "-triggerId"

Responses

Response samples

Content type
application/json
{
  • "totalCount": 0,
  • "data": [
    ]
}