Workable Connector 0.1.0 Reference
Configurations
Config
Default configuration.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Name |
String |
The name for this configuration. Connectors reference the configuration with this name. |
x |
|
Connection |
The connection types to provide to this configuration. |
x |
||
Name |
String |
The identifier of this element used to reference it in other components. |
x |
|
Expiration Policy |
Configures the minimum amount of time that a dynamic configuration instance can remain idle before the runtime considers it eligible for expiration. This does not mean that the platform will expire the instance at the exact moment that it becomes eligible. The runtime will actually purge the instances when it sees it fit. |
Connection Types
Bearer Auth
Provides access to the Workable API using a bearer token.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
baseUri |
String |
The base URI for the Workable API. |
x |
|
token |
String |
The API key token for authentication. |
x |
|
TLS Configuration |
The TLS configuration for secure connections. |
|||
Reconnection |
When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy. |
addCandidateComment
<workable:add-candidate-comment>
Adds a comment to a candidate record.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
id |
String |
Candidate identifier associated with the comment. |
x |
|
body |
Any |
The request body content. |
#[payload] |
|
Config Ref |
ConfigurationProvider |
The name of the configuration to use to execute this component. |
x |
|
Target Variable |
String |
Name of the variable that stores the operation output. |
||
Target Value |
String |
An expression to evaluate against the operation’s output and store the expression outcome in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
addCandidateRating
<workable:add-candidate-rating>
Adds a rating to a candidate record.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
id |
String |
Candidate identifier to rate. |
x |
|
body |
Any |
The request body content. |
#[payload] |
|
Config Ref |
ConfigurationProvider |
The name of the configuration to use to execute this component. |
x |
|
Target Variable |
String |
Name of the variable that stores the operation output. |
||
Target Value |
String |
An expression to evaluate against the operation’s output and store the expression outcome in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
copyCandidateToJob
<workable:copy-candidate-to-job>
Copies a candidate to a different job.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
id |
String |
Candidate identifier to copy. |
x |
|
body |
Any |
The request body content. |
#[payload] |
|
Config Ref |
ConfigurationProvider |
The name of the configuration to use to execute this component. |
x |
|
Target Variable |
String |
Name of the variable that stores the operation output. |
||
Target Value |
String |
An expression to evaluate against the operation’s output and store the expression outcome in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
createCandidateForJob
<workable:create-candidate-for-job>
Creates a candidate for a specific job.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
shortcode |
String |
Job shortcode that receives the candidate. |
x |
|
body |
Any |
The request body content. |
#[payload] |
|
Config Ref |
ConfigurationProvider |
The name of the configuration to use to execute this component. |
x |
|
Target Variable |
String |
Name of the variable that stores the operation output. |
||
Target Value |
String |
An expression to evaluate against the operation’s output and store the expression outcome in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
createCandidateInTalentPool
<workable:create-candidate-in-talent-pool>
Creates a candidate in the talent pool.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
body |
Any |
The request body content. |
#[payload] |
|
Config Ref |
ConfigurationProvider |
The name of the configuration to use to execute this component. |
x |
|
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
An expression to evaluate against the operation’s output and store the expression outcome in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
disqualifyCandidate
<workable:disqualify-candidate>
Disqualifies a candidate from further consideration.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
id |
String |
Candidate identifier to disqualify. |
x |
|
body |
Any |
Payload that defines the disqualification details. |
#[payload] |
|
Config Ref |
ConfigurationProvider |
The name of the configuration to use to execute this component. |
x |
|
Target Variable |
String |
Name of the variable that stores the operation output. |
||
Target Value |
String |
Expression evaluated against the operation output and stored in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
getAllCandidates
<workable:get-all-candidates>
Retrieves all candidates that meet the provided filter criteria.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
limit |
Number |
The maximum number of results to return. |
||
since_id |
String |
Returns candidates created after the specified candidate ID. |
||
max_id |
String |
Returns candidates created before the specified candidate ID. |
||
created_after |
DateTime |
Returns candidates created after the specified date and time. |
||
updated_after |
DateTime |
Returns candidates updated after the specified date and time. |
||
Config Ref |
ConfigurationProvider |
The name of the configuration to use to execute this component. |
x |
|
Target Variable |
String |
Name of the variable that stores the operation output. |
||
Target Value |
String |
An expression to evaluate against the operation’s output and store the expression outcome in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
getCandidateActivities
<workable:get-candidate-activities>
Retrieves activity records for a candidate.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
id |
String |
Candidate identifier whose activities you want to retrieve. |
x |
|
limit |
Number |
The maximum number of results to return. |
||
offset |
Number |
Number of activity records to skip before returning results. |
||
Config Ref |
ConfigurationProvider |
The name of the configuration to use to execute this component. |
x |
|
Target Variable |
String |
Name of the variable that stores the operation output. |
||
Target Value |
String |
An expression to evaluate against the operation’s output and store the expression outcome in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
getCandidateById
<workable:get-candidate-by-id>
Retrieves a candidate by identifier.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
id |
String |
Candidate identifier to retrieve. |
x |
|
Config Ref |
ConfigurationProvider |
The name of the configuration to use to execute this component. |
x |
|
Target Variable |
String |
Name of the variable that stores the operation output. |
||
Target Value |
String |
An expression to evaluate against the operation’s output and store the expression outcome in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
getCandidateOffer
<workable:get-candidate-offer>
Retrieves the offer details for a candidate.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
id |
String |
Candidate identifier whose offer you want to retrieve. |
x |
|
Config Ref |
ConfigurationProvider |
The name of the configuration to use to execute this component. |
x |
|
Target Variable |
String |
Name of the variable that stores the operation output. |
||
Target Value |
String |
An expression to evaluate against the operation’s output and store the expression outcome in the target variable . |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
moveCandidateToStage
<workable:move-candidate-to-stage>
Moves a candidate to a different recruitment stage.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
id |
String |
Candidate identifier to move. |
x |
|
body |
Any |
The request body content. |
#[payload] |
|
Config Ref |
ConfigurationProvider |
The name of the configuration to use to execute this component. |
x |
|
Target Variable |
String |
Name of the variable that stores the operation output. |
||
Target Value |
String |
An expression to evaluate against the operation’s output and store the expression outcome in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
revertCandidateDisqualification
<workable:revert-candidate-disqualification>
Reverts a candidate disqualification.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
id |
String |
Candidate identifier to reinstate. |
x |
|
body |
Any |
The request body content. |
#[payload] |
|
Config Ref |
ConfigurationProvider |
The name of the configuration to use to execute this component. |
x |
|
Target Variable |
String |
Name of the variable that stores the operation output. |
||
Target Value |
String |
An expression to evaluate against the operation’s output and store the expression outcome in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
updateCandidate
<workable:update-candidate>
Updates candidate details.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
id |
String |
Candidate identifier to update. |
x |
|
body |
Any |
The request body content. |
#[payload] |
|
Config Ref |
ConfigurationProvider |
The name of the configuration to use to execute this component. |
x |
|
Target Variable |
String |
Name of the variable that stores the operation output. |
||
Target Value |
String |
An expression to evaluate against the operation’s output and store the expression outcome in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
updateCandidateTags
<workable:update-candidate-tags>
Updates tags assigned to a candidate.
Parameters
| Name | Type | Description | Default Value | Required |
|---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
id |
String |
Candidate identifier whose tags you want to update. |
x |
|
body |
Any |
The request body content. |
#[payload] |
|
Config Ref |
ConfigurationProvider |
The name of the configuration to use to execute this component. |
x |
|
Target Variable |
String |
Name of the variable that stores the operation output. |
||
Target Value |
String |
An expression to evaluate against the operation’s output and store the expression outcome in the target variable. |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
Types
TLS
Configures TLS to provide secure communications for the Mule app.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Enabled Protocols |
String |
A comma-separated list of protocols enabled for this context. |
||
Enabled Cipher Suites |
String |
A comma-separated list of cipher suites enabled for this context. |
||
Trust Store |
Configures the TLS truststore. |
|||
Key Store |
Configures the TLS keystore. |
|||
Revocation Check |
Configures a revocation checking mechanism. |
Truststore
Configures the truststore for TLS.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Path |
String |
The location (which will be resolved relative to the current classpath and file system, if possible) of the trust store. |
||
Password |
String |
The password used to protect the trust store. |
||
Type |
String |
The type of store used. |
||
Algorithm |
String |
The algorithm used by the trust store. |
||
Insecure |
Boolean |
If true, no certificate validations will be performed, rendering connections vulnerable to attacks. Use at your own risk. |
Keystore
Configures the keystore for the TLS protocol. The keystore you generate contains a private key and a public certificate.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Path |
String |
The location (which will be resolved relative to the current classpath and file system, if possible) of the key store. |
||
Type |
String |
The type of store used. |
||
Alias |
String |
When the key store contains many private keys, this attribute indicates the alias of the key that should be used. If not defined, the first key in the file will be used by default. |
||
Key Password |
String |
The password used to protect the private key. |
||
Password |
String |
The password used to protect the key store. |
||
Algorithm |
String |
The algorithm used by the key store. |
Standard Revocation Check
Configures standard revocation checks for TLS certificates.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Only End Entities |
Boolean |
Specifies whether to verify only the last element in the certificate chain. |
||
Prefer Crls |
Boolean |
Specifies whether to check the Certification Revocation List (CRL) first for certificate validity. |
||
No Fallback |
Boolean |
Specifies whether to avoid using the secondary method to check certificate validity. |
||
Soft Fail |
Boolean |
Specifies whether to avoid verification failure when the revocation server cannot be reached. |
Custom OCSP Responder
Configures a custom OCSP responder for certification revocation checks.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Url |
String |
The URL of the OCSP responder. |
||
Cert Alias |
String |
Alias of the signing certificate for the OCSP response. If specified, the alias must be in the truststore. |
CRL File
Specifies the location of the certification revocation list (CRL) file.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Path |
String |
Path to the CRL file. |
Reconnection
Configures a reconnection strategy for an operation.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Fails Deployment |
Boolean |
When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy. |
||
Reconnection Strategy |
Reconnection strategy to use. |
Reconnect
Configures a standard reconnection strategy, which specifies how often to reconnect and how many reconnection attempts the connector source or operation can make.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Frequency |
Number |
Specifies how often to attempt to reconnect, in milliseconds. |
||
Blocking |
Boolean |
If false, the reconnection strategy will run in a separate, non-blocking thread. |
||
Count |
Number |
Specifies how many reconnection attempts the Mule app can make. |
Reconnect Forever
Configures a forever reconnection strategy by which the connector source or operation attempts to reconnect at a specified frequency for as long as the Mule app runs.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Frequency |
Number |
Specifies how often to attempt to reconnect, in milliseconds. |
||
Blocking |
Boolean |
If false, the reconnection strategy will run in a separate, non-blocking thread. |
Expiration Policy
Configures an expiration policy strategy.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Max Idle Time |
Number |
A scalar time value for the maximum amount of time a dynamic configuration instance should be allowed to be idle before it’s considered eligible for expiration. |
||
Time Unit |
Enumeration, one of:
|
Time unit for the Max Idle Time field. |
Error Mapping
Defines an error mapping entry.
| Field | Type | Description | Default Value | Required |
|---|---|---|---|---|
Source |
Enumeration, one of:
|
Source of the error. |
||
Target |
String |
Target of the error. |
x |



