Introduction
Using JRuby
API error messages
API command line access
Using DSL
IntroductionGetting started with DSLGenerating DSL scriptsDSL automation as codeDSL editorsTroubleshooting and FAQs
DSL method reference
Using the RESTful API
Using the Perl API
Perl API reference
IntroductionAccess tokensACL managementApplication dependencyApplicationsApplication tier Artifact managementCatalogsChange historyCI build detailCI configurationCI jobsComponentsCredential managementCustom filtersDatabase configurationData retentionCloudBees AnalyticsDirectory provider managementDynamic environmentsEmail configuration managementEmail notifier managementEnvironmentEnvironment tierGateway and zone managementGet application environment inventoryInstalling or upgrading remote agentsJob managementMicroservicesObject tagsParameter managementPersonasPipelines and releasesPlugin managementPlugin configuration managementProcedure managementProcessProcess dependencyProcess stepProject managementProperty managementResource managementRolling deploySchedule managementService accounts for webhooksServer managementSingle sign on for SAMLSnapshotsTier mapTrigger managementUser and group managementUser profile email managementWait dependenciesWorkflow definition managementWorkflow managementWork itemsWorkspace managementMiscellaneous management
Perl API response and element glossary
Using the Groovy API
IntroductionExamplesTroubleshooting
Groovy API reference
IntroductionaccesstokenaclaclentryactualparameteractualparametersapplicationapplicationdependencyapplicationtierarchiveconnectorartifactartifactversioncatalogcatalogitemcatalogitemruncibuildcibuilddetailciconfigurationcieventclustercomponentcredentialcredentialproviderdashboarddashboardcolumndataretentionpolicydeployerapplicationdeployerconfigurationdeploymenthistoryitemdevopsinsightdatasourcedirectoryprovideremailconfigemailnotifierentitychangeenvironmentenvironmentinventoryitemenvironmenttemplateenvironmenttemplatetierenvironmenttemplatetiermapenvironmenttemplatetiermappingenvironmenttierenvtempltierresourcetemplmappingeventsubscriptionflowruntimeformaloutputparameterformalparametergategatewaygrouphookjobjobstepkerberoskeytablicensemicroservicemicroservicemappingnoteobjectopenidconnectconfigurationoutputparameterpersonapersonacategorypersonapagepipelinepluginplugincatalogpluginconfigurationprocedureprocedurestepprocessprocessdependencyprocessstepprojectpropertyreleasereportreportingfilterreportobjectassociationreportobjectattributereportobjecttyperepositoryreservationresourceresourcepoolresourcetemplateresourceusageretrievedartifactsrollingdeployphaserundiscoverysamlidentityprovidersamlserviceproviderschedulescmsyncsearchfilterserverserversettingserversettingcategoryserviceaccountsessionsnapshotstagestatestatedefinitiontagtasktiermaptiermappingtransitiontransitiondefinitiontriggertriggererrordetailuseruseremailutilityresourcewaitdependencywebhookresultwidgetwidgetfilteroverrideworkflowworkflowdefinitionworkitemworkspacezoneArgument models

Hook

2 minute readReference

createHook

Creates a new hook.

Arguments

Argument NameTypeDescription

hookName

String

Name for the hook; must be unique among all hooks. (Required)

projectName

String

projectName of the entity that owns the hook

procedureName

String

hook procedure name

broadcast

Boolean

broadcast flag

description

String

Comment text describing this object that is not interpreted at all by CloudBees CD/RO.

hookParameters

HookParameter array

hook parameters

hookType

String

hook type

procedurePluginKey

String

procedure plugin key

procedureProjectName

String

procedure project name

resourceTemplateName

String

Name of the resource template.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.createHook(
                hookName: 'test-hookName'
                /* optional arguments */)

deleteHook

Deletes a hook associated with an entity.

Arguments

Argument NameTypeDescription

hookName

String

Name for the hook; must be unique among all hooks. (Required)

projectName

String

projectName of the entity that owns the hook

resourceTemplateName

String

Name of the resource template.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.deleteHook(
                hookName: 'test-hookName')

getHook

Get a hook associated with an entity.

Arguments

Argument NameTypeDescription

hookName

String

Name for the hook; must be unique among all hooks. (Required)

projectName

String

projectName of the entity that owns the hook

resourceTemplateName

String

Name of the resource template.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.getHook(
                hookName: 'test-hookName')

getHooks

Get all Hooks associated with an entity.

Arguments

Argument NameTypeDescription

projectName

String

projectName of the entity that owns the hook

resourceTemplateName

String

Name of the resource template.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.getHooks()

modifyHook

Modifies an existing hook.

Arguments

Argument NameTypeDescription

hookName

String

Name for the hook; must be unique among all hooks. (Required)

projectName

String

projectName of the entity that owns the hook

procedureName

String

hook procedure name

broadcast

Boolean

broadcast flag

description

String

Comment text describing this object that is not interpreted at all by CloudBees CD/RO.

hookParameters

HookParameter array

hook parameters

hookType

String

hook type

newName

String

New name for an existing object that is being renamed.

procedurePluginKey

String

procedure plugin key

procedureProjectName

String

procedure project name

resourceTemplateName

String

Name of the resource template.

Usage

import com.electriccloud.client.groovy.ElectricFlow
import com.electriccloud.client.groovy.models.*


ElectricFlow ef = new ElectricFlow()

def result = ef.modifyHook(
                hookName: 'test-hookName'
                /* optional arguments */)
group
job