Get Action

Get Action

The returned definition contains base data for the action, as well the input parameter's definitions and the output type.

Request
URI
GET
https://{api_host}/vco/api/actions/{categoryName}/{actionName}
COPY
Path Parameters
string
categoryName
Required

categoryName

string
actionName
Required

actionName

Query Parameters
string of array
params
Optional

params


Authentication
This operation uses the following authentication methods.
Responses
200

The request is successful

Returns Action of type(s) application/json
{
    "relations": {
        "startIndex": 0,
        "count": 0,
        "total": 0,
        "link": [
            {
                "rel": "string",
                "type": "string",
                "attributes": [
                    {
                        "name": "string",
                        "displayName": "string",
                        "value": "string",
                        "displayValue": "string"
                    }
                ],
                "href": "string"
            }
        ]
    },
    "id": "string",
    "name": "string",
    "module": "string",
    "description": "string",
    "version": "string",
    "fqn": "string",
    "script": "string",
    "runtime": "string",
    "outputParameterType": "string",
    "href": "string",
    "input-parameters": [
        {
            "name": "string",
            "type": "Example types are: SecureString, MimeAttachment, Regexp, Array/VC:VirtualMachine, boolean, string and etc.",
            "description": "string",
            "scope": "string",
            "updated": false,
            "encrypt-value": false
        }
    ],
    "output-type": "string",
    "iconId": "string",
    "bundleHasContent": false,
    "runtimeMemoryLimit": 0,
    "runtimeTimeout": 0,
    "entryPoint": "string",
    "actionEnvironmentId": "string",
    "actionEnvironmentName": "string",
    "validationMessage": "string"
}
object
relations
Optional

relations

string
id
Optional

id

string As ^[\p{L}_$][\p{L}0-9_$]*$
name
Required

name

string As ^[\p{L}_][\p{L}0-9_-]*(\.[\p{L}0-9_-]+)*$
module
Required

module

string
description
Optional

description

string
version
Optional

version

string
fqn
Optional

fqn

string
script
Optional

script

string
runtime
Optional

runtime

string
outputParameterType
Optional

outputParameterType

string
href
Optional

href

array of object
input-parameters
Optional

input-parameters

string
output-type
Optional

output-type

string
iconId
Optional

iconId

boolean
bundleHasContent
Optional

bundleHasContent

integer As int64 As int64
runtimeMemoryLimit
Optional

runtimeMemoryLimit

integer As int64 As int64
runtimeTimeout
Optional

runtimeTimeout

string
entryPoint
Optional

entryPoint

string
actionEnvironmentId
Optional

actionEnvironmentId

string
actionEnvironmentName
Optional

actionEnvironmentName

string
validationMessage
Optional

validationMessage


401

The user is not authorized

Returns Action of type(s) application/json
"Action Object"
object
relations
Optional

relations

string
id
Optional

id

string As ^[\p{L}_$][\p{L}0-9_$]*$
name
Required

name

string As ^[\p{L}_][\p{L}0-9_-]*(\.[\p{L}0-9_-]+)*$
module
Required

module

string
description
Optional

description

string
version
Optional

version

string
fqn
Optional

fqn

string
script
Optional

script

string
runtime
Optional

runtime

string
outputParameterType
Optional

outputParameterType

string
href
Optional

href

array of object
input-parameters
Optional

input-parameters

string
output-type
Optional

output-type

string
iconId
Optional

iconId

boolean
bundleHasContent
Optional

bundleHasContent

integer As int64 As int64
runtimeMemoryLimit
Optional

runtimeMemoryLimit

integer As int64 As int64
runtimeTimeout
Optional

runtimeTimeout

string
entryPoint
Optional

entryPoint

string
actionEnvironmentId
Optional

actionEnvironmentId

string
actionEnvironmentName
Optional

actionEnvironmentName

string
validationMessage
Optional

validationMessage


404

Can not find an action with the specified name

Returns Action of type(s) application/json
"Action Object"
object
relations
Optional

relations

string
id
Optional

id

string As ^[\p{L}_$][\p{L}0-9_$]*$
name
Required

name

string As ^[\p{L}_][\p{L}0-9_-]*(\.[\p{L}0-9_-]+)*$
module
Required

module

string
description
Optional

description

string
version
Optional

version

string
fqn
Optional

fqn

string
script
Optional

script

string
runtime
Optional

runtime

string
outputParameterType
Optional

outputParameterType

string
href
Optional

href

array of object
input-parameters
Optional

input-parameters

string
output-type
Optional

output-type

string
iconId
Optional

iconId

boolean
bundleHasContent
Optional

bundleHasContent

integer As int64 As int64
runtimeMemoryLimit
Optional

runtimeMemoryLimit

integer As int64 As int64
runtimeTimeout
Optional

runtimeTimeout

string
entryPoint
Optional

entryPoint

string
actionEnvironmentId
Optional

actionEnvironmentId

string
actionEnvironmentName
Optional

actionEnvironmentName

string
validationMessage
Optional

validationMessage


Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/vco/api/actions/{categoryName}/{actionName}