API docs by Redocly

OpCon REST API (26.0.0.0)

Download OpenAPI specification:

Welcome to the SMA OpCon REST API reference. Use this REST API to interact with the OpCon database.

AccessCodes

Gets a list of Access Codes based on optional criteria specified

Sample request (this returns a list of Access Codes by Name in descending order):

GET /api/accessCodes?sortBy=name:desc
Authorizations:
Token
query Parameters
IncludeCrossReferenceDailyJobs
boolean

Flag to include a list of Daily Jobs secured by the Access Code

IncludeCrossReferenceMasterJobs
boolean

Flag to include a list of Master Jobs secured by the Access Code

Name
string

The Access Code Name (Can accept ? and * wildcards)

Ids
string

Comma-separated list of Access Code Ids

Limit
integer <int32>

Limits the results being fetched. 0 retrieves just a count

Offset
integer <int32>

Retrieves records beginning at this record number

SortOrders
Array of strings
AccessibleCodes
Array of integers <int32> [ items <int32 > ]
SortBy
string

Option to sort Access Codes by Name in ascending (default) or descending (:desc) order

Responses

Response samples

Content type
No sample

Creates a new Access Code and returns it with its Id, if successful

Sample request:

POST /api/accessCodes
        
{
    "name": "Operator"
}
Authorizations:
Token
Request Body schema:
id
integer or null <int32>

The id of the access code

name
string or null

The name of the access code

description
string or null
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceDailyJob)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceMasterJob)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "crossReferencesDailyJobs": [
    ],
  • "crossReferencesMasterJobs": [
    ]
}

Response samples

Content type
No sample

Gets the Access Code with the specified Id

Sample request (this returns the Access Code with Id = 1):

GET /api/accessCodes/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Access Code with the specified Id

Sample request (this updates the Access Code with Id = 1):

PUT /api/accessCodes/1
        
{
    "id": 1,
    "name": "Operator"
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer or null <int32>

The id of the access code

name
string or null

The name of the access code

description
string or null
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceDailyJob)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceMasterJob)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "crossReferencesDailyJobs": [
    ],
  • "crossReferencesMasterJobs": [
    ]
}

Response samples

Content type
No sample

Deletes the Access Code with the specified Id

Sample request (this deletes the Access Code with Id = 1):

DELETE /api/accessCodes/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

ACS

Gets a list of supported applications for this installation

Sample request:

GET api/acs/applications
Authorizations:
Token

Responses

Response samples

Content type
No sample

Gets a list of the names of all tasks which the specified application supports

Sample request:

GET api/acs/{application:string}/tasktypes
Authorizations:
Token
path Parameters
application
required
string

Responses

Gets the JSON schema defining the UI and the form data for a given framework integration as well as the current configuration values

Sample request:

POST /api/acs/rjsf
Authorizations:
Token
Request Body schema:
object (OpCon.Api.Data.Services.ACS.Models.ACSConfigData)
languages
Array of strings or null
isReadOnly
boolean
machineNetComName
string or null

Responses

Request samples

Content type
{
  • "currentConfig": {
    },
  • "languages": [
    ],
  • "isReadOnly": true,
  • "machineNetComName": "string"
}

Gets the JSON schema defining the UI and the form data for a given job type provided by the specified integration as well as the current config values. This call has side effects and can, if not set to read only, update machine records. This endpoint includes schedule-instance properties from the specified Master Schedule

Sample request:

GET /api/acs/rjsf/task/master
Authorizations:
Token
Request Body schema:
object (OpCon.Api.Data.Services.ACS.Models.ACSTaskConfigData)
languages
Array of strings or null
isReadOnly
boolean
integrationIds
Array of integers or null <int32> [ items <int32 > ]
scheduleId
integer or null <int32>

Responses

Request samples

Content type
{
  • "currentConfig": {
    },
  • "languages": [
    ],
  • "isReadOnly": true,
  • "integrationIds": [
    ],
  • "scheduleId": 0
}

Gets the JSON schema defining the UI and the form data for a given job type provided by the specified integration as well as the current config values. This call has side effects and can, if not set to read only, update machine records. This endpoint includes schedule-instance properties from the specified Daily Schedule

Sample request:

GET /api/acs/rjsf/task/daily
Authorizations:
Token
Request Body schema:
object (OpCon.Api.Data.Services.ACS.Models.ACSTaskConfigData)
languages
Array of strings or null
isReadOnly
boolean
integrationIds
Array of integers or null <int32> [ items <int32 > ]
scheduleKey
string or null

Responses

Request samples

Content type
{
  • "currentConfig": {
    },
  • "languages": [
    ],
  • "isReadOnly": true,
  • "integrationIds": [
    ],
  • "scheduleKey": "string"
}

Gets a list of Machines which support the given application and task type

Sample request: ** GET api/acs/{application:string}/{taskName:string}/machines

Authorizations:
Token
path Parameters
application
required
string
taskName
required
string

Responses

Gets a list of Machines which support the given application

Sample request: ** GET api/acs/{application:string}/machines

Authorizations:
Token
path Parameters
application
required
string

Responses

BatchUsers

Gets a list of Batch Users based on optional criteria specified

Sample request (this returns a list of Batch Users by Name in descending order): 

GET /api/batchUsers?sortby=name:desc
Authorizations:
Token
query Parameters
Ids
string

Comma-separated list of Batch User Ids

Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

Platform
string

The Platform (Operating System) of the Batch User (Can accept ? and * wildcards)

PlatformId
integer <int32>

The Id of the Platform Type of the Batch User

RoleName
string

The Batch User Role Name (Can accept ? and * wildcards)

LoginName
string

The Batch User Login Name (Can accept ? and * wildcards)

IncludeRoles
boolean

Flag to include a list of Roles assigned to the Batch User

IncludeAssociations
boolean

Flag to include a list of Daily and Master Jobs to which the Batch User is assigned

AcsApplication
string

The ACS Application of the Batch User (Only used when PlatformID is 27 - ACS)

SortOrder.SortBy
string
SortOrder.IdColumns
Array of strings
SortOrder.ValidSortOrders
Array of strings
SortOrder.ColumnList
Array of strings
SortOrder.SortTypeList
Array of strings
SortBy
string

Option to sort Batch Users by Id or LoginName in ascending (default) or descending (:desc) order

Responses

Response samples

Content type
No sample

Creates a new Batch User and returns it with its Id, if successful

Sample request: 

POST /api/batchUsers  

{  
"platform": {  
    "id": 3,  
    "name": "Windows"  
    }  
"loginName": "TestUser",  
"password": "userPassword"  
"roles": [  
    {  
        "id": 1  
    },  
    {  
        "id": 2  
    }  
    ]  
}
Authorizations:
Token
Request Body schema:
id
integer or null <int32>

Id of the batch user

object (OpCon.Api.Data.Entities.Platform)
loginName
string or null

User name for the batch user

password
string or null

This field is not returned on a GET request. It may be sent in a POST request. If the field is null in a PUT request, it gets ignored and the existing value is unchanged. The value is encrypted optional

acsApplication
string or null

If the Platform is 27 (ACS), then this field describes the application for this batch user. For all other values, this field will be null.

Array of objects or null (OpCon.Api.Data.Services.Roles.Models.Role)

Roles associated with this batch user optional

Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceDailyJob)

Daily jobs associated with this batch user

Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceMasterJob)

Master jobs associated with this batch user

previousLoginName
string or null

Responses

Request samples

Content type
{
  • "id": 0,
  • "platform": {
    },
  • "loginName": "string",
  • "password": "string",
  • "acsApplication": "string",
  • "roles": [
    ],
  • "dailyJobs": [
    ],
  • "jobs": [
    ],
  • "previousLoginName": "string"
}

Response samples

Content type
No sample

Gets the Batch User with the specified Id

Sample request (this returns the Batch User with Id = 1): 

GET /api/batchUsers/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Batch user with the specified Id

Sample request (this updates the Batch User with Id = 1):

PUT /api/batchUsers/1  

{  
    "platform": {  
        "id": 1,  
        "name": "Windows"  
    }  
    "loginName": "TestUser"  
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer or null <int32>

Id of the batch user

object (OpCon.Api.Data.Entities.Platform)
loginName
string or null

User name for the batch user

password
string or null

This field is not returned on a GET request. It may be sent in a POST request. If the field is null in a PUT request, it gets ignored and the existing value is unchanged. The value is encrypted optional

acsApplication
string or null

If the Platform is 27 (ACS), then this field describes the application for this batch user. For all other values, this field will be null.

Array of objects or null (OpCon.Api.Data.Services.Roles.Models.Role)

Roles associated with this batch user optional

Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceDailyJob)

Daily jobs associated with this batch user

Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceMasterJob)

Master jobs associated with this batch user

previousLoginName
string or null

Responses

Request samples

Content type
{
  • "id": 0,
  • "platform": {
    },
  • "loginName": "string",
  • "password": "string",
  • "acsApplication": "string",
  • "roles": [
    ],
  • "dailyJobs": [
    ],
  • "jobs": [
    ],
  • "previousLoginName": "string"
}

Response samples

Content type
No sample

Deletes the Batch User with the specified Id

Sample request (this deletes a Batch User with Id = 11):

DELETE /api/batchUsers/11
Authorizations:
Token
path Parameters
id
required
integer <int32>
query Parameters
Ids
string

Comma-separated list of Batch User Ids

Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

Platform
string

The Platform (Operating System) of the Batch User (Can accept ? and * wildcards)

PlatformId
integer <int32>

The Id of the Platform Type of the Batch User

RoleName
string

The Batch User Role Name (Can accept ? and * wildcards)

LoginName
string

The Batch User Login Name (Can accept ? and * wildcards)

IncludeRoles
boolean

Flag to include a list of Roles assigned to the Batch User

IncludeAssociations
boolean

Flag to include a list of Daily and Master Jobs to which the Batch User is assigned

AcsApplication
string

The ACS Application of the Batch User (Only used when PlatformID is 27 - ACS)

SortOrder.SortBy
string
SortOrder.IdColumns
Array of strings
SortOrder.ValidSortOrders
Array of strings
SortOrder.ColumnList
Array of strings
SortOrder.SortTypeList
Array of strings
SortBy
string

Option to sort Batch Users by Id or LoginName in ascending (default) or descending (:desc) order

Responses

Calendars

Gets a list of Calendars based on optional criteria specified

Sample request (this returns a list of Calendars by name in descending order):

GET /api/calendars?sortby=name:desc
Authorizations:
Token
query Parameters
Count
boolean

Flag to include a total count in the response header

Type
integer <int32>

The Type of the Calendars to fetch (0 = Individual Holiday Calendars, 1 = Other Calendars)

Name
string

The Calendar Name (Can accept ? and * wildcards)

Description
string

The Calendar Description (Can accept ? and * wildcards)

IncludeCrossReferences
boolean

Flag to include a list of Daily and Master Jobs to which the Calendar is assigned

Ids
string

Comma-separated list of Calendar Ids

Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

SortOrders
Array of strings
IgnoreCase
boolean

Flag to indicate case-insensitive search criteria

BasicDetails
boolean

Flag to return just basic details

SortBy
string

Option to sort Calendars by Id, Name, Description or Type in ascending (default) or descending (:desc) order

Responses

Response samples

Content type
No sample

Creates a new Calendar and returns it with its Id, if successful

Sample request (this creates a new calendar):

POST /api/calendars

{
    "name": "CalendarName"
}
Authorizations:
Token
Request Body schema:
id
integer or null <int32>

The id of the calendar

object (OpCon.Api.Data.Entities.MasterSchedule)
type
integer <int32>

The type of the calendar

name
string or null

The name of the calendar

dates
Array of strings or null

The dates for this calendar

description
string or null

The description of the calendar

Array of objects or null (OpCon.Api.Data.Services.Calendars.CalendarAssociation)

Responses

Request samples

Content type
{
  • "id": 0,
  • "schedule": {
    },
  • "type": 0,
  • "name": "string",
  • "dates": [
    ],
  • "description": "string",
  • "calendarAssociations": [
    ]
}

Response samples

Content type
No sample

Gets a count of Calendars based on optional criteria specified

Sample request (this returns a count of calendars having name like the name provided):

GET /api/calendars/count?name=HC:
Authorizations:
Token
query Parameters
Count
boolean

Flag to include a total count in the response header

Type
integer <int32>

The Type of the Calendars to fetch (0 = Individual Holiday Calendars, 1 = Other Calendars)

Name
string

The Calendar Name (Can accept ? and * wildcards)

Description
string

The Calendar Description (Can accept ? and * wildcards)

IncludeCrossReferences
boolean

Flag to include a list of Daily and Master Jobs to which the Calendar is assigned

Ids
string

Comma-separated list of Calendar Ids

Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

SortOrders
Array of strings
IgnoreCase
boolean

Flag to indicate case-insensitive search criteria

BasicDetails
boolean

Flag to return just basic details

SortBy
string

Option to sort Calendars by Id, Name, Description or Type in ascending (default) or descending (:desc) order

Responses

Response samples

Content type
No sample

Gets the Calendar with the specified Id

Sample request (this returns the Calendar with Id = 1 ):

GET /api/calendars/1
Authorizations:
Token
path Parameters
id
required
integer <int32>
query Parameters
Count
boolean

Flag to include a total count in the response header

Type
integer <int32>

The Type of the Calendars to fetch (0 = Individual Holiday Calendars, 1 = Other Calendars)

Name
string

The Calendar Name (Can accept ? and * wildcards)

Description
string

The Calendar Description (Can accept ? and * wildcards)

IncludeCrossReferences
boolean

Flag to include a list of Daily and Master Jobs to which the Calendar is assigned

Ids
string

Comma-separated list of Calendar Ids

Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

SortOrders
Array of strings
IgnoreCase
boolean

Flag to indicate case-insensitive search criteria

BasicDetails
boolean

Flag to return just basic details

SortBy
string

Option to sort Calendars by Id, Name, Description or Type in ascending (default) or descending (:desc) order

Responses

Response samples

Content type
No sample

Updates the Calendar with the specified Id

Sample request:

PUT /api/calendar/1

{
    "id": 1,
    "name": "CalendarName",
    "dates": [ "03/16/2021", "06/02/2021" ]
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer or null <int32>

The id of the calendar

object (OpCon.Api.Data.Entities.MasterSchedule)
type
integer <int32>

The type of the calendar

name
string or null

The name of the calendar

dates
Array of strings or null

The dates for this calendar

description
string or null

The description of the calendar

Array of objects or null (OpCon.Api.Data.Services.Calendars.CalendarAssociation)

Responses

Request samples

Content type
{
  • "id": 0,
  • "schedule": {
    },
  • "type": 0,
  • "name": "string",
  • "dates": [
    ],
  • "description": "string",
  • "calendarAssociations": [
    ]
}

Response samples

Content type
No sample

Deletes the Calendar with the specified Id

Sample request:

DELETE /api/calendars/11
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Deletes Calendar dates older than 30 days for the Calendar with the specified Id, and returns the updated Calendar, if successful

Sample request:

POST /api/calendars/10/deleteOldDates

{
    "calendar": {
        "id": 10,
    }
}
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Deletes Calendar dates older than 30 days from all Calendars

Sample request:

POST /api/calendars/deleteAllOldDates
Authorizations:
Token

Responses

CloudEvents

Gets a list of CloudEvents filters and associated actions based on the optional criteria specified

Sample request:

GET /api/cloudEvents
Authorizations:
Token
query Parameters
Server
string
Path
string
Protocol
string
logonUserName
string
Type
string
Result
integer <int64>
Name
string

Limit results to CloudEventsTriggers whose names match this pattern

EventTypeFilter
string

Limit results to CloudEventsTriggers whose CloudEvents Type matches this pattern

SourceFilter
string

Limit results to CloudEventsTriggers whose Source matches this pattern

OpconEventCountFilter
string
IncludeCount
boolean

Specifies whether to include the total number of records matching these criteria in the response

SortBy
string

Option to sort Cloud Events by Name, EventTypeFilter, SourceFilter, or OpconEventCountFilter

Offset
integer <int32>

Retrieves records beginning at this record number

Limit
integer <int32>

Limits the results being fetched

Responses

Response samples

Content type
No sample

Creates a new CloudEvents filter and associated actions

Sample request:

POST /api/cloudEvents
Authorizations:
Token
Request Body schema:
id
integer <int32>
name
string or null
object (OpCon.Api.Data.Services.CloudEvents.Models.CloudEventsFilter)
Array of objects or null (OpCon.Api.Data.Services.CloudEvents.Models.OpConEvent)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "filter": {
    },
  • "events": [
    ]
}

Response samples

Content type
No sample

Updates an existing CloudEvents filter and associated actions

Sample request:

PUT /api/cloudevents
Authorizations:
Token
Request Body schema:
id
integer <int32>
name
string or null
object (OpCon.Api.Data.Services.CloudEvents.Models.CloudEventsFilter)
Array of objects or null (OpCon.Api.Data.Services.CloudEvents.Models.OpConEvent)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "filter": {
    },
  • "events": [
    ]
}

Response samples

Content type
No sample

Deletes an existing CloudEvents filter and associated actions

Sample request:

DELETE /api/cloudEvents/{cloudEventsId}
Authorizations:
Token
path Parameters
cloudEventsId
required
integer <int32>

Responses

Gets a list of CloudEvents types based on the optional criteria specified

Sample request:

GET /api/cloudEvents/schema
Authorizations:
Token
Request Body schema:
type
string or null

Responses

Request samples

Content type
{
  • "type": "string"
}

Response samples

Content type
No sample

Gets the schema for a CloudEvents type

Sample request:

GET /api/cloudEvents/schema/{cloudEventsType}
Authorizations:
Token
path Parameters
cloudEventsType
required
string

Responses

Response samples

Content type
No sample

Posts CloudEvents to OpCon

Sample request:

POST /api/cloudEvents/events
Authorizations:
Token
Request Body schema:
property name*
additional property
Array of arrays (Newtonsoft.Json.Linq.JToken)

Responses

Request samples

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

Response samples

Content type
No sample

DailyGraphEdges

Gets a list of Daily Graph Edges based on optional criteria specified

Sample request (this returns a list of all daily graph edges):

GET /api/dailyGraphEdges?level=-1
Authorizations:
Token
query Parameters
ScheduleIds
string

Schedule ids to include

Level
integer <int32>

Number of successor and predecessor levels (-1, 0, 1, 2). -1 returns all predecessors up to 1000 levels. Default is 1.

JobIds
string

Job ids to include

ScheduleDates
Array of integers <int32> [ items <int32 > ]

Schedule dates to include

Dates
string
PredecessorLevel
integer <int32>

Number of predecessor levels (-1, 0, 1, 2). -1 returns all predecessors up to 1000 levels. Default is 1.

SuccessorLevel
integer <int32>

Number of successor levels (-1, 0, 1, 2). -1 returns all successors up to 1000 levels. Default is 1.

Responses

Response samples

Content type
No sample

Gets a list of Daily Graph Edges based on optional criteria specified using POST to overcome the long query limitation

Sample request (this returns a list of all Daily Graph Edges):

POST /api/dailyGraphEdges?level=-1
Authorizations:
Token
Request Body schema:
scheduleIds
string or null

Schedule ids to include

level
integer or null <int32>

Number of successor and predecessor levels (-1, 0, 1, 2). -1 returns all predecessors up to 1000 levels. Default is 1.

jobIds
string or null

Job ids to include

scheduleDates
Array of integers or null <int32> [ items <int32 > ]

Schedule dates to include

dates
string or null
predecessorLevel
integer or null <int32>

Number of predecessor levels (-1, 0, 1, 2). -1 returns all predecessors up to 1000 levels. Default is 1.

successorLevel
integer or null <int32>

Number of successor levels (-1, 0, 1, 2). -1 returns all successors up to 1000 levels. Default is 1.

Responses

Request samples

Content type
{
  • "scheduleIds": "string",
  • "level": 0,
  • "jobIds": "string",
  • "scheduleDates": [
    ],
  • "dates": "string",
  • "predecessorLevel": 0,
  • "successorLevel": 0
}

Response samples

Content type
No sample

Gets a list of Daily Graph Edges by job Id

Sample request (this returns a list of Daily Graph Edges for the Daily Schedule having the Id '20221229|1|1'):

GET /api/dailyGraphEdges/20221229|1|1
Authorizations:
Token
path Parameters
id
required
string
query Parameters
ScheduleIds
string

Schedule ids to include

Level
integer <int32>

Number of successor and predecessor levels (-1, 0, 1, 2). -1 returns all predecessors up to 1000 levels. Default is 1.

JobIds
string

Job ids to include

ScheduleDates
Array of integers <int32> [ items <int32 > ]

Schedule dates to include

Dates
string
PredecessorLevel
integer <int32>

Number of predecessor levels (-1, 0, 1, 2). -1 returns all predecessors up to 1000 levels. Default is 1.

SuccessorLevel
integer <int32>

Number of successor levels (-1, 0, 1, 2). -1 returns all successors up to 1000 levels. Default is 1.

Responses

Response samples

Content type
No sample

DailyJobEvent

Gets a list of Daily Job Events

Sample request (this returns a list of Daily Job Events in descending order):

    GET /api/dailyJobs/{jobId}/events
Authorizations:
Token
path Parameters
required
object (OpCon.Api.Data.Entities.Jobs.DailyJobKey)

Responses

Response samples

Content type
No sample

Creates a new Daily Job Event

Sample request:

     POST /api/dailyJobs/{jobId}/events/

     {
         "job": {
             "id": "20210712|6000|1|Unix1"
         },
         "user": {
             "id": 0,
             "name": "ocadm"
         },
         "trigger": {
             "type": "Status",
             "id": 900,
             "name": "Finished OK"
         },
         "event": {
             "type": "$CONSOLE:DISPLAY",
         "parameters": {
             "message": "HELLO"
             }
         },
         "frequency": {
             "name": "********"
  }

}

Authorizations:
Token
path Parameters
required
object (OpCon.Api.Data.Entities.Jobs.DailyJobKey)
Request Body schema:
required
object (OpCon.Api.Data.Services.DailyJobEvents.Models.DailyJobId)
required
object (OpCon.Api.Data.Services.DailyJobEvents.Models.SmaUserModel)
required
object
required
object (OpCon.Api.Data.Services.DailyJobEvents.Models.JobEventDetailsModel)
required
object (OpCon.Api.Data.Services.DailyJobEvents.Models.JobEventFrequencyModel)
id
integer <int32>

Responses

Request samples

Content type
{
  • "job": {
    },
  • "user": {
    },
  • "trigger": {
    },
  • "event": {
    },
  • "frequency": {
    },
  • "id": 0
}

Response samples

Content type
No sample

Updates the Daily Job Events for the specified Job Id

Sample request:

     PUT /api/dailyJobs/{jobId}/events/

     {
         "job": {
             "id": "20210712|6000|1|Unix1"
         },
         "user": {
             "id": 0,
             "name": "ocadm"
         },
         "trigger": {
             "type": "Status",
             "id": 900,
             "name": "Finished OK"
         },
         "event": {
             "type": "$CONSOLE:DISPLAY",
         "parameters": {
             "message": "HELLO"
             }
         },
         "frequency": {
             "name": "********"
  }

}

Authorizations:
Token
path Parameters
required
object (OpCon.Api.Data.Entities.Jobs.DailyJobKey)
Request Body schema:
required
object (OpCon.Api.Data.Services.DailyJobEvents.Models.DailyJobId)
required
object (OpCon.Api.Data.Services.DailyJobEvents.Models.SmaUserModel)
required
object
required
object (OpCon.Api.Data.Services.DailyJobEvents.Models.JobEventDetailsModel)
required
object (OpCon.Api.Data.Services.DailyJobEvents.Models.JobEventFrequencyModel)
id
integer <int32>

Responses

Request samples

Content type
{
  • "job": {
    },
  • "user": {
    },
  • "trigger": {
    },
  • "event": {
    },
  • "frequency": {
    },
  • "id": 0
}

Response samples

Content type
No sample

Deletes a Daily Job Event with the specified Id for the specified Job Id

Sample request:

    DELETE /api/dailyJobs/{jobId}/events/{eventId}
Authorizations:
Token
path Parameters
required
object (OpCon.Api.Data.Entities.Jobs.DailyJobKey)
eventId
required
integer <int32>

Responses

DailyJobs

Gets a list of Daily Jobs based on optional criteria specified

Sample request (returns a list of daily jobs with a job name starting with SMA):

GET /api/dailyJobs?jobName=SMA*
Authorizations:
Token
query Parameters
Uids
string

A comma-separated list of Daily Job Unique Ids (1, 2, etc.)

IncludeDocumentation
boolean

Flag to include a list of Documentation associated with the Daily Job

IncludeThresholdResourceDependencies
boolean

Flag to include a list of Threshold and Resource Dependencies associated with the Daily Job

IncludeThresholdResourceUpdates
boolean

Flag to include a list of Threshold and Resource Updates associated with the Daily Job

IncludeExpressionDependencies
boolean

Flag to include a list of Expression Dependencies associated with the Daily Job

IncludeDependencies
boolean

Flag to include a list of Job Dependencies associated with the Daily Job

IncludeConfigurations
boolean

Flag to include configurations associated with the Daily Job

IncludeCount
boolean

Flag to include a total count of Daily Jobs in the response header

IncludeDetails
boolean

Flag to include details of Daily Job

IncludeEvents
boolean

Flag to include a list of Events associated with the Daily Job

TerminationDescription
string

The Termination Description of the Daily Job

JobName
string

The Job Name of the Daily Job (Can accept ? and * wildcards)

Machine
string

The primary Machine Name assigned to run the Daily Job

StartMachine
string

The Machine Name on which the Daily Job is running

PrimaryMachine
string

The primary Machine Name assigned to run the Daily Job

AlternateMachine
string

The first alternate Machine Name assigned to run the Daily Job

AlternateMachine2
string

The second alternate Machine Name assigned to run the Daily Job

AlternateMachine3
string

The third alternate Machine Name assigned to run the Daily Job

Reason
string

The Daily Job Reason

ScheduleDates
Array of integers <int32> [ items <int32 > ]

Comma-separated list of dates the Daily Job is scheduled to run

SortOrders
Array of strings
JobStatus
string

The Status of the Daily Job

JobStatusCategories
Array of strings

Comma-separated list of Daily Job Statuses

JobType
string

The Daily Job Job Type

PriorityValue
integer <int32>

The Daily Job Priority

ScheduleStatus
string

The Daily Job Schedule Status

ScheduleName
string

The Daily Job Schedule Name

Path
string

The Daily Job Path

TagList
Array of strings

Comma separated list of Daily Job Tags

LimitValue
integer <int32>

Limits the results being fetched

OffsetValue
integer <int32>

Retrieves records beginning at this record number

DepartmentList
Array of integers <int32> [ items <int32 > ]

Comma-separated list of Department Ids

AccessCodeList
Array of integers <int32> [ items <int32 > ]

Comma-separated list of Access Code Ids

JobNumber
integer <int32>
Ids
string

Comma-separated list of Daily Job Ids

ScheduleIds
string
Name
string
Dates
string
Status
string
SortBy
string

Option to sort Daily Jobs by Id (in ascending (default) or descending (:desc) order), Name, Status, Date, Path, Duration (Calculated Duration), Start (Calculated Start Time), End (Calculated End Time), State (Job State), Machine (on which the Daily Job is running), JobType, Priority (Job Priority), TermDesc (Termination Description), and ScheduleStatus (Schedule Status)

Priority
string
AccessCodeIds
string
Limit
string
Offset
string
Tags
string
Categories
string
DepartmentIds
string

Responses

Response samples

Content type
No sample

Gets a list of Daily Jobs based on optional criteria specified using POST to overcome the long query limitation

Sample request (this returns a list of all daily jobs):

POST /api/dailyJobs
Authorizations:
Token
Request Body schema:
uids
string or null

A comma-separated list of Daily Job Unique Ids (1, 2, etc.)

includeDocumentation
boolean

Flag to include a list of Documentation associated with the Daily Job

includeThresholdResourceDependencies
boolean

Flag to include a list of Threshold and Resource Dependencies associated with the Daily Job

includeThresholdResourceUpdates
boolean

Flag to include a list of Threshold and Resource Updates associated with the Daily Job

includeExpressionDependencies
boolean

Flag to include a list of Expression Dependencies associated with the Daily Job

includeDependencies
boolean

Flag to include a list of Job Dependencies associated with the Daily Job

includeConfigurations
boolean

Flag to include configurations associated with the Daily Job

includeCount
boolean

Flag to include a total count of Daily Jobs in the response header

includeDetails
boolean

Flag to include details of Daily Job

includeEvents
boolean

Flag to include a list of Events associated with the Daily Job

terminationDescription
string or null

The Termination Description of the Daily Job

jobName
string or null

The Job Name of the Daily Job (Can accept ? and * wildcards)

machine
string or null

The primary Machine Name assigned to run the Daily Job

startMachine
string or null

The Machine Name on which the Daily Job is running

primaryMachine
string or null

The primary Machine Name assigned to run the Daily Job

alternateMachine
string or null

The first alternate Machine Name assigned to run the Daily Job

alternateMachine2
string or null

The second alternate Machine Name assigned to run the Daily Job

alternateMachine3
string or null

The third alternate Machine Name assigned to run the Daily Job

reason
string or null

The Daily Job Reason

scheduleDates
Array of integers or null <int32> [ items <int32 > ]

Comma-separated list of dates the Daily Job is scheduled to run

sortOrders
Array of strings or null
jobStatus
string or null

The Status of the Daily Job

jobStatusCategories
Array of strings or null

Comma-separated list of Daily Job Statuses

jobType
string or null

The Daily Job Job Type

priorityValue
integer or null <int32>

The Daily Job Priority

scheduleStatus
string or null

The Daily Job Schedule Status

scheduleName
string or null

The Daily Job Schedule Name

path
string or null

The Daily Job Path

tagList
Array of strings or null

Comma separated list of Daily Job Tags

limitValue
integer or null <int32>

Limits the results being fetched

offsetValue
integer or null <int32>

Retrieves records beginning at this record number

departmentList
Array of integers or null <int32> [ items <int32 > ]

Comma-separated list of Department Ids

accessCodeList
Array of integers or null <int32> [ items <int32 > ]

Comma-separated list of Access Code Ids

jobNumber
integer or null <int32>
ids
string or null

Comma-separated list of Daily Job Ids

scheduleIds
string or null
name
string or null
dates
string or null
status
string or null
sortBy
string or null

Option to sort Daily Jobs by Id (in ascending (default) or descending (:desc) order), Name, Status, Date, Path, Duration (Calculated Duration), Start (Calculated Start Time), End (Calculated End Time), State (Job State), Machine (on which the Daily Job is running), JobType, Priority (Job Priority), TermDesc (Termination Description), and ScheduleStatus (Schedule Status)

priority
string or null
accessCodeIds
string or null
limit
string or null
offset
string or null
tags
string or null
categories
string or null
departmentIds
string or null

Responses

Request samples

Content type
{
  • "uids": "string",
  • "includeDocumentation": true,
  • "includeThresholdResourceDependencies": true,
  • "includeThresholdResourceUpdates": true,
  • "includeExpressionDependencies": true,
  • "includeDependencies": true,
  • "includeConfigurations": true,
  • "includeCount": true,
  • "includeDetails": true,
  • "includeEvents": true,
  • "terminationDescription": "string",
  • "jobName": "string",
  • "machine": "string",
  • "startMachine": "string",
  • "primaryMachine": "string",
  • "alternateMachine": "string",
  • "alternateMachine2": "string",
  • "alternateMachine3": "string",
  • "reason": "string",
  • "scheduleDates": [
    ],
  • "sortOrders": [
    ],
  • "jobStatus": "string",
  • "jobStatusCategories": [
    ],
  • "jobType": "string",
  • "priorityValue": 0,
  • "scheduleStatus": "string",
  • "scheduleName": "string",
  • "path": "string",
  • "tagList": [
    ],
  • "limitValue": 0,
  • "offsetValue": 0,
  • "departmentList": [
    ],
  • "accessCodeList": [
    ],
  • "jobNumber": 0,
  • "ids": "string",
  • "scheduleIds": "string",
  • "name": "string",
  • "dates": "string",
  • "status": "string",
  • "sortBy": "string",
  • "priority": "string",
  • "accessCodeIds": "string",
  • "limit": "string",
  • "offset": "string",
  • "tags": "string",
  • "categories": "string",
  • "departmentIds": "string"
}

Response samples

Content type
No sample

Gets the Daily Job with the specified daily job Id

Sample request:

GET /api/dailyJobs/20231106|1|1|SMA Check Identity Limit
Authorizations:
Token
path Parameters
dailyJobId
required
string

Responses

Response samples

Content type
No sample

Updates the Daily Job with the specified daily job Id

Sample request:

PUT /api/dailyJobs/20231106|1|1|SMA Check Identity Limit

{
    "id": "20231106|1|1|SMA Check Identity Limit",
    "name": "SMA Check Identity Limit 2",
    "details": { ... },
    "department": { "id": 32000 },
    "frequency": { ... },
    "jobType": { "id": 6 },
    "accessCode": { "id": 0 },
    "primaryMachine": { "id": 1 },
}
Authorizations:
Token
path Parameters
dailyJobId
required
string
Request Body schema:
uid
integer or null <int64>
uniqueJobId
string or null
object (OpCon.Api.Data.Entities.Jobs.DailyJobDetails)
object (OpCon.Api.Data.Entities.Jobs.DailyJobFeedback)
object (OpCon.Api.Data.Services.Departments.Models.Department)
Array of objects or null (OpCon.Api.Data.Entities.InstanceProperty)
steps
Array of strings or null
id
string or null
priority
integer <int32>
jobName
string or null
object (OpCon.Api.Data.Entities.Frequency)

A frequency

jobNumber
integer <int32>
jorsRequestParameters
string or null
incidentTicketId
string or null
incidentTicketURL
string or null
object (OpCon.Api.Data.Entities.LsamType)
object (OpCon.Api.Data.Services.AccessCodes.Models.AccessCode)

An access code with id and name fields

object (OpCon.Api.Data.Entities.Machine)
object (OpCon.Api.Data.Entities.Machine)
object (OpCon.Api.Data.Entities.Machine)
object (OpCon.Api.Data.Entities.Machine)
object (OpCon.Api.Data.Entities.MachineGroup)
object (OpCon.Api.Data.Entities.Machine)
tags
Array of strings or null
object (OpCon.Api.Data.Entities.JobStatus)
object (OpCon.Api.Data.Entities.DailySchedule)
terminationDescription
string or null
object (OpCon.Api.Data.Entities.Jobs.ComputedTime)
object (OpCon.Api.Data.Entities.Jobs.ComputedTime)
object (OpCon.Api.Data.Entities.Jobs.ComputedDuration)
object (OpCon.Api.Data.Entities.Jobs.DailyJobDocumentation)
Array of objects or null (OpCon.Api.Data.Entities.Jobs.DailyJobThresholdDependency)
Array of objects or null (OpCon.Api.Data.Entities.Jobs.DailyJobResourceDependency)
Array of objects or null (OpCon.Api.Data.Entities.Jobs.DailyJobThresholdResourceUpdate)
Array of objects or null (OpCon.Api.Data.Entities.Jobs.DailyJobThresholdResourceUpdate)
Array of objects or null (OpCon.Api.Data.DailyJobDependency)
Array of objects or null (OpCon.Api.Data.Services.DailyJobEvents.Models.DailyJobEventModel)
Array of objects or null (OpCon.Api.Data.Entities.Jobs.DailyJobConfigurationProperty)
object (OpCon.Api.Data.Entities.Jobs.DailyJobExpressionDependencyCollection)
detailMessages
Array of strings or null
isRecurrent
boolean
features
Array of strings or null
currentStep
string or null
jobGroup
integer <int32>
startMachineId
integer <int32>
startOffset
number <double>
startAbsoluteRelative
string or null
lateToStartTime
number <double>
lateToStartAbsoluteRelative
string or null
start
number <double>
termination
number <double>
estimatedRunTime
integer <int32>
lastUpdate
number <double>
maxMinutes
integer <int32>
originalJobName
string or null
shortName
string or null
calculatedStartTime
number or null <double>
startTimeIsEstimated
boolean
calculatedEndTime
number or null <double>
endTimeIsEstimated
boolean
calculatedDuration
integer <int64>
durationIsEstimated
boolean
subScheduleDailyName
string or null
subScheduleDailyPath
string or null
subScheduleDailyInstance
integer or null <int32>
subScheduleDailyId
integer or null <int32>
subScheduleDailyDate
integer or null <int32>
subScheduleMasterName
string or null
subScheduleMasterId
integer or null <int32>

Responses

Request samples

Content type
{
  • "uid": 0,
  • "uniqueJobId": "string",
  • "details": {
    },
  • "feedback": { },
  • "department": {
    },
  • "instanceProperties": [
    ],
  • "steps": [
    ],
  • "id": "string",
  • "priority": 0,
  • "jobName": "string",
  • "frequency": {
    },
  • "jobNumber": 0,
  • "jorsRequestParameters": "string",
  • "incidentTicketId": "string",
  • "incidentTicketURL": "string",
  • "type": {
    },
  • "accessCode": {
    },
  • "machine": {
    },
  • "alternateMachine": {
    },
  • "alternateMachine2": {
    },
  • "alternateMachine3": {
    },
  • "machineGroup": {
    },
  • "startMachine": {
    },
  • "tags": [
    ],
  • "jobStatus": {
    },
  • "schedule": {
    },
  • "terminationDescription": "string",
  • "computedStartTime": {
    },
  • "computedEndTime": {
    },
  • "computedDuration": {
    },
  • "documentation": {
    },
  • "thresholdDependencies": [
    ],
  • "resourceDependencies": [
    ],
  • "thresholdUpdates": [
    ],
  • "resourceUpdates": [
    ],
  • "dependencies": [
    ],
  • "events": [
    ],
  • "configurations": [
    ],
  • "expressionDependencies": {
    },
  • "detailMessages": [
    ],
  • "isRecurrent": true,
  • "features": [
    ],
  • "currentStep": "string",
  • "jobGroup": 0,
  • "startMachineId": 0,
  • "startOffset": 0.1,
  • "startAbsoluteRelative": "string",
  • "lateToStartTime": 0.1,
  • "lateToStartAbsoluteRelative": "string",
  • "start": 0.1,
  • "termination": 0.1,
  • "estimatedRunTime": 0,
  • "lastUpdate": 0.1,
  • "maxMinutes": 0,
  • "originalJobName": "string",
  • "shortName": "string",
  • "calculatedStartTime": 0.1,
  • "startTimeIsEstimated": true,
  • "calculatedEndTime": 0.1,
  • "endTimeIsEstimated": true,
  • "calculatedDuration": 0,
  • "durationIsEstimated": true,
  • "subScheduleDailyName": "string",
  • "subScheduleDailyPath": "string",
  • "subScheduleDailyInstance": 0,
  • "subScheduleDailyId": 0,
  • "subScheduleDailyDate": 0,
  • "subScheduleMasterName": "string",
  • "subScheduleMasterId": 0
}

Response samples

Content type
No sample

Gets a count of Daily Jobs matching the optional criteria specified

Sample request (returns a count of daily jobs with a job name starting with SMA):

GET /api/dailyJobs/count?jobName=SMA*
Authorizations:
Token
query Parameters
Uids
string

A comma-separated list of Daily Job Unique Ids (1, 2, etc.)

IncludeDocumentation
boolean

Flag to include a list of Documentation associated with the Daily Job

IncludeThresholdResourceDependencies
boolean

Flag to include a list of Threshold and Resource Dependencies associated with the Daily Job

IncludeThresholdResourceUpdates
boolean

Flag to include a list of Threshold and Resource Updates associated with the Daily Job

IncludeExpressionDependencies
boolean

Flag to include a list of Expression Dependencies associated with the Daily Job

IncludeDependencies
boolean

Flag to include a list of Job Dependencies associated with the Daily Job

IncludeConfigurations
boolean

Flag to include configurations associated with the Daily Job

IncludeCount
boolean

Flag to include a total count of Daily Jobs in the response header

IncludeDetails
boolean

Flag to include details of Daily Job

IncludeEvents
boolean

Flag to include a list of Events associated with the Daily Job

TerminationDescription
string

The Termination Description of the Daily Job

JobName
string

The Job Name of the Daily Job (Can accept ? and * wildcards)

Machine
string

The primary Machine Name assigned to run the Daily Job

StartMachine
string

The Machine Name on which the Daily Job is running

PrimaryMachine
string

The primary Machine Name assigned to run the Daily Job

AlternateMachine
string

The first alternate Machine Name assigned to run the Daily Job

AlternateMachine2
string

The second alternate Machine Name assigned to run the Daily Job

AlternateMachine3
string

The third alternate Machine Name assigned to run the Daily Job

Reason
string

The Daily Job Reason

ScheduleDates
Array of integers <int32> [ items <int32 > ]

Comma-separated list of dates the Daily Job is scheduled to run

SortOrders
Array of strings
JobStatus
string

The Status of the Daily Job

JobStatusCategories
Array of strings

Comma-separated list of Daily Job Statuses

JobType
string

The Daily Job Job Type

PriorityValue
integer <int32>

The Daily Job Priority

ScheduleStatus
string

The Daily Job Schedule Status

ScheduleName
string

The Daily Job Schedule Name

Path
string

The Daily Job Path

TagList
Array of strings

Comma separated list of Daily Job Tags

LimitValue
integer <int32>

Limits the results being fetched

OffsetValue
integer <int32>

Retrieves records beginning at this record number

DepartmentList
Array of integers <int32> [ items <int32 > ]

Comma-separated list of Department Ids

AccessCodeList
Array of integers <int32> [ items <int32 > ]

Comma-separated list of Access Code Ids

JobNumber
integer <int32>
Ids
string

Comma-separated list of Daily Job Ids

ScheduleIds
string
Name
string
Dates
string
Status
string
SortBy
string

Option to sort Daily Jobs by Id (in ascending (default) or descending (:desc) order), Name, Status, Date, Path, Duration (Calculated Duration), Start (Calculated Start Time), End (Calculated End Time), State (Job State), Machine (on which the Daily Job is running), JobType, Priority (Job Priority), TermDesc (Termination Description), and ScheduleStatus (Schedule Status)

Priority
string
AccessCodeIds
string
Limit
string
Offset
string
Tags
string
Categories
string
DepartmentIds
string

Responses

Response samples

Content type
No sample

Gets a count of Daily Jobs matching the optional criteria specified and grouped by Job Status

Sample request:

GET /api/dailyJobs/count_by_status?jobName=SMA*
Authorizations:
Token
query Parameters
Uids
string

A comma-separated list of Daily Job Unique Ids (1, 2, etc.)

IncludeDocumentation
boolean

Flag to include a list of Documentation associated with the Daily Job

IncludeThresholdResourceDependencies
boolean

Flag to include a list of Threshold and Resource Dependencies associated with the Daily Job

IncludeThresholdResourceUpdates
boolean

Flag to include a list of Threshold and Resource Updates associated with the Daily Job

IncludeExpressionDependencies
boolean

Flag to include a list of Expression Dependencies associated with the Daily Job

IncludeDependencies
boolean

Flag to include a list of Job Dependencies associated with the Daily Job

IncludeConfigurations
boolean

Flag to include configurations associated with the Daily Job

IncludeCount
boolean

Flag to include a total count of Daily Jobs in the response header

IncludeDetails
boolean

Flag to include details of Daily Job

IncludeEvents
boolean

Flag to include a list of Events associated with the Daily Job

TerminationDescription
string

The Termination Description of the Daily Job

JobName
string

The Job Name of the Daily Job (Can accept ? and * wildcards)

Machine
string

The primary Machine Name assigned to run the Daily Job

StartMachine
string

The Machine Name on which the Daily Job is running

PrimaryMachine
string

The primary Machine Name assigned to run the Daily Job

AlternateMachine
string

The first alternate Machine Name assigned to run the Daily Job

AlternateMachine2
string

The second alternate Machine Name assigned to run the Daily Job

AlternateMachine3
string

The third alternate Machine Name assigned to run the Daily Job

Reason
string

The Daily Job Reason

ScheduleDates
Array of integers <int32> [ items <int32 > ]

Comma-separated list of dates the Daily Job is scheduled to run

SortOrders
Array of strings
JobStatus
string

The Status of the Daily Job

JobStatusCategories
Array of strings

Comma-separated list of Daily Job Statuses

JobType
string

The Daily Job Job Type

PriorityValue
integer <int32>

The Daily Job Priority

ScheduleStatus
string

The Daily Job Schedule Status

ScheduleName
string

The Daily Job Schedule Name

Path
string

The Daily Job Path

TagList
Array of strings

Comma separated list of Daily Job Tags

LimitValue
integer <int32>

Limits the results being fetched

OffsetValue
integer <int32>

Retrieves records beginning at this record number

DepartmentList
Array of integers <int32> [ items <int32 > ]

Comma-separated list of Department Ids

AccessCodeList
Array of integers <int32> [ items <int32 > ]

Comma-separated list of Access Code Ids

JobNumber
integer <int32>
Ids
string

Comma-separated list of Daily Job Ids

ScheduleIds
string
Name
string
Dates
string
Status
string
SortBy
string

Option to sort Daily Jobs by Id (in ascending (default) or descending (:desc) order), Name, Status, Date, Path, Duration (Calculated Duration), Start (Calculated Start Time), End (Calculated End Time), State (Job State), Machine (on which the Daily Job is running), JobType, Priority (Job Priority), TermDesc (Termination Description), and ScheduleStatus (Schedule Status)

Priority
string
AccessCodeIds
string
Limit
string
Offset
string
Tags
string
Categories
string
DepartmentIds
string

Responses

Response samples

Content type
No sample

Gets a list of Documentation for the Daily Job with the specified daily job Id

Sample request:

GET /api/dailyJobs/documentation/20231106|1|1|SMA Check Identity Limit
Authorizations:
Token
path Parameters
rawId
required
string

Responses

Response samples

Content type
No sample

Creates Documentation for the Daily Job with the specified daily job Id

Sample request:

POST /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/documentation

{ "frequency": "Daily", "job": "Check Identity Limit" }

Authorizations:
Token
path Parameters
rawId
required
string

Daily job id

Request Body schema:

Documentation

id
integer or null <int32>
frequency
string or null
job
string or null

Responses

Request samples

Content type
{
  • "id": 0,
  • "frequency": "string",
  • "job": "string"
}

Response samples

Content type
No sample

Gets the Documentation with the specified documentation Id for the Daily Job with the specified daily job Id

Sample request:

GET /api/dailyJobs/documentation/20231106|1|1|SMA Check Identity Limit/1
Authorizations:
Token
path Parameters
rawId
required
string
documentationId
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates Documentation with the specified documentation Id for the Daily Job with the specified daily job Id

Sample request:

PUT /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/documentation/1

{
    "frequency": "Daily",
    "job": "Check Identity Limit"
}
Authorizations:
Token
path Parameters
rawId
required
string
documentationId
required
integer <int32>
Request Body schema:
id
integer or null <int32>
frequency
string or null
job
string or null

Responses

Request samples

Content type
{
  • "id": 0,
  • "frequency": "string",
  • "job": "string"
}

Response samples

Content type
No sample

Deletes the Documentation with the specified documentation Id for the Daily Job with the specified daily job Id

Sample request:

DELETE /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/documentation/1
Authorizations:
Token
path Parameters
rawId
required
string
documentationId
required
integer <int32>

Responses

Gets the Status of the Daily Job with the specified daily job Id

Sample request:

GET /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/status
Authorizations:
Token
path Parameters
jobId
required
string

Responses

Response samples

Content type
No sample

Gets a list of Instance Properties for the Daily Job with the specified daily job Id

Sample request:

GET /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/properties
Authorizations:
Token
path Parameters
rawId
required
string

Responses

Response samples

Content type
No sample

Creates an Instance Property for the Daily Job with the specified daily job Id

Sample request:

POST /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/properties

{ "key": "instance2", "value": "value2" }

Authorizations:
Token
path Parameters
rawId
required
string
Request Body schema:
key
string or null
value
string or null

Responses

Request samples

Content type
{
  • "key": "string",
  • "value": "string"
}

Response samples

Content type
No sample

Gets the Instance Property with the specified Name for the Daily Job with the specified daily job Id

Sample request:

GET /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/properties/instance1
Authorizations:
Token
path Parameters
rawId
required
string
name
required
string

Responses

Response samples

Content type
No sample

Updates the Instance Property with the specified property Name for the Daily Job with the specified daily job Id

Sample request:

PUT /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/properties/instance1

{
    "key": "instance1",
    "value": "value1"    
}
Authorizations:
Token
path Parameters
rawId
required
string
name
required
string
Request Body schema:
key
string or null
value
string or null

Responses

Request samples

Content type
{
  • "key": "string",
  • "value": "string"
}

Response samples

Content type
No sample

Deletes the Instance Property with the specified instance Name for the Daily Job with the specified daily job Id

Sample request:

DELETE /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/properties/instance1
Authorizations:
Token
path Parameters
rawId
required
string
name
required
string

Responses

Copies the Daily Job definition to the Master Job

Sample request:

PUT /api/dailyJobs/copyToMasterJob/20231106|1|1|Job Name
Authorizations:
Token
path Parameters
jobId
required
string

Responses

Gets a list of Events for the Daily Job with the specified Id

Sample request:

GET /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/events
Authorizations:
Token
path Parameters
rawId
required
string

Responses

Response samples

Content type
No sample

Gets the Event with the specified Id for the Daily Job with the specified Id

Sample request:

GET /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/events/1
Authorizations:
Token
path Parameters
rawId
required
string
eventId
required
integer <int32>

Responses

Response samples

Content type
No sample

Gets a list of Daily Job Expression Dependencies

Sample request (this returns a list of Expression Dependencies in ascending order):

GET /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/expressionDependencies
Authorizations:
Token
path Parameters
rawId
required
string

Responses

Response samples

Content type
No sample

Creates an Expression Dependency for the Daily Job with the specified Job Id

Sample request:

    POST /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/expressionDependencies/

    {
        "expression1": "someExpression",
        "expression2": "expressionTwo"
    }
Authorizations:
Token
path Parameters
rawId
required
string
Request Body schema:
id
integer or null <int32>

The expression dependecy unique identifier

expression1
string or null

The string value for the expression.

expression2
string or null

The string value for the expression.

Responses

Request samples

Content type
{
  • "id": 0,
  • "expression1": "string",
  • "expression2": "string"
}

Response samples

Content type
No sample

Gets a Daily Job Expression Dependency with the specified Id

Sample request (this returns a Expression Dependency in ascending order):

GET /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/expressionDependencies/1
Authorizations:
Token
path Parameters
rawId
required
string
expressionId
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Expression Dependency specified by the Id for the Daily Job with the specified Job Id

Sample request:

    PUT /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/expressionDependencies/1

    {
        "id": 1,
        "expression1": "someExpression",
        "expression2": "expressionTwo"
    }
Authorizations:
Token
path Parameters
rawId
required
string
expressionId
required
integer <int32>
Request Body schema:
id
integer or null <int32>

The expression dependecy unique identifier

expression1
string or null

The string value for the expression.

expression2
string or null

The string value for the expression.

Responses

Request samples

Content type
{
  • "id": 0,
  • "expression1": "string",
  • "expression2": "string"
}

Response samples

Content type
No sample

Deletes an Expression Dependency with the specified Id for the Daily Job with the specified Job Id

Sample request):

    DELETE /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/expressionDependencies/1
Authorizations:
Token
path Parameters
rawId
required
string
expressionId
required
integer <int32>
Request Body schema:
id
integer or null <int32>

The expression dependecy unique identifier

expression1
string or null

The string value for the expression.

expression2
string or null

The string value for the expression.

Responses

Request samples

Content type
{
  • "id": 0,
  • "expression1": "string",
  • "expression2": "string"
}

Gets a list of Resource Dependencies for the Daily Job with the specified Id

Sample request:

GET /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/resourceDependencies
Authorizations:
Token
path Parameters
rawId
required
string

Responses

Response samples

Content type
No sample

Creates a Resource Dependency for the Daily Job with the specified Id

Sample request:

POST /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/resourceDependencies
Authorizations:
Token
path Parameters
rawId
required
string
Request Body schema:
id
integer or null <int32>
object (OpCon.Api.Data.Services.Resources.Resource)
requires
integer or null <int32>
requiresAll
boolean or null
object (OpCon.Api.Data.Entities.Frequency)

A frequency

Responses

Request samples

Content type
{
  • "id": 0,
  • "resource": {
    },
  • "requires": 0,
  • "requiresAll": true,
  • "frequency": {
    }
}

Response samples

Content type
No sample

Gets the Resource Dependency with the specified Id for the Daily Job with the specified Id

Sample request:

GET /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/resourceDependencies/1
Authorizations:
Token
path Parameters
rawId
required
string
resourceId
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Resource Dependency with the specified Id for the Daily Job with the specified Id

Sample request:

PUT /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/resourceDependencies/1
Authorizations:
Token
path Parameters
rawId
required
string
resourceId
required
integer <int32>
Request Body schema:
id
integer or null <int32>
object (OpCon.Api.Data.Services.Resources.Resource)
requires
integer or null <int32>
requiresAll
boolean or null
object (OpCon.Api.Data.Entities.Frequency)

A frequency

Responses

Request samples

Content type
{
  • "id": 0,
  • "resource": {
    },
  • "requires": 0,
  • "requiresAll": true,
  • "frequency": {
    }
}

Response samples

Content type
No sample

Deletes the Resource Dependency with the specified Id for the Daily Job with the specified Id

Sample request:

DELETE /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/resourceDependencies/1
Authorizations:
Token
path Parameters
rawId
required
string
resourceId
required
integer <int32>

Responses

Gets a list of Threshold Dependencies for the Daily Job with the specified Id

Sample request:

GET /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/thresholdDependencies
Authorizations:
Token
path Parameters
rawId
required
string

Responses

Response samples

Content type
No sample

Creates a Threshold Dependency for the Daily Job with the specified Id

Sample request:

POST /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/thresholdDependencies
Authorizations:
Token
path Parameters
rawId
required
string
Request Body schema:
id
integer or null <int32>
object (OpCon.Api.Data.Services.Thresholds.Threshold)
value
integer <int32>
operator
string or null
object (OpCon.Api.Data.Entities.Frequency)

A frequency

Responses

Request samples

Content type
{
  • "id": 0,
  • "threshold": {
    },
  • "value": 0,
  • "operator": "string",
  • "frequency": {
    }
}

Response samples

Content type
No sample

Gets the Threshold Dependency with the specified Id for the Daily Job with the specified Id

Sample request:

GET /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/thresholdDependencies/1
Authorizations:
Token
path Parameters
rawId
required
string
thresholdId
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Threshold Dependency with the specified Id for the Daily Job with the specified Id

Sample request:

PUT /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/thresholdDependencies/1
Authorizations:
Token
path Parameters
rawId
required
string
thresholdId
required
integer <int32>
Request Body schema:
id
integer or null <int32>
object (OpCon.Api.Data.Services.Thresholds.Threshold)
value
integer <int32>
operator
string or null
object (OpCon.Api.Data.Entities.Frequency)

A frequency

Responses

Request samples

Content type
{
  • "id": 0,
  • "threshold": {
    },
  • "value": 0,
  • "operator": "string",
  • "frequency": {
    }
}

Response samples

Content type
No sample

Deletes the Threshold Dependency with the specified Id for the Daily Job with the specified Id

Sample request:

DELETE /api/dailyJobs/20231106|1|1|SMA Check Identity Limit/thresholdDependencies/1
Authorizations:
Token
path Parameters
rawId
required
string
thresholdId
required
integer <int32>

Responses

Gets a list of Incident Tickets for the Daily Job with the specified Unique Id

Sample request:

GET /api/dailyJobs/111/incidentTickets
Authorizations:
Token
path Parameters
uniqueId
required
integer <int64>

Responses

Response samples

Content type
No sample

Creates an Incident Ticket for the Daily Job with the specified unique Id

Sample request:

POST /api/dailyJobs/111/incidentTickets

{
    "ticketId": "123456",
    "ticketUrl": "https://mycompany.com/tickets/123456"
}
Authorizations:
Token
path Parameters
uniqueId
required
integer <int64>
Request Body schema:
id
integer <int32>
ticketId
string or null
ticketUrl
string or null

Responses

Request samples

Content type
{
  • "id": 0,
  • "ticketId": "string",
  • "ticketUrl": "string"
}

Response samples

Content type
No sample

Updates the Incident Ticket with the specified ticket Id for the Daily Job with the specified unique Id

Sample request:

PUT /api/dailyJobs/111/incidentTickets/1

{
    "id": "1",
    "ticketId": "123456",
    "ticketUrl": "https://mycompany.com/tickets/123456"
}
Authorizations:
Token
path Parameters
uniqueJobId
required
integer <int64>
ticketIdInUrl
required
string
Request Body schema:
id
integer <int32>
ticketId
string or null
ticketUrl
string or null

Responses

Request samples

Content type
{
  • "id": 0,
  • "ticketId": "string",
  • "ticketUrl": "string"
}

Response samples

Content type
No sample

Deletes the Incident Ticket with the specified ticket Id for the Daily Job with the specified unique Id

Sample request:

DELETE /api/dailyJobs/111/incidentTickets/1
Authorizations:
Token
path Parameters
uniqueJobId
required
integer <int64>
ticketId
required
string

Responses

DailyJobsDependencies

Gets a list of Job Dependencies for the Daily Job with the specified Id

Sample request:

GET /api/dailyJobs/20210101|15|1|Job1/dependencies
Authorizations:
Token
path Parameters
jobId
required
string

Responses

Response samples

Content type
No sample

Updates the Job Dependencies for the Daily Job with the specified daily job Id

Sample request:

PUT /api/dailyJobs/20210101|15|1|Job1/dependencies

[
    {
        "type": {
            "name": "After",
            "condition": "Failed",
            "offset": 0
        },
        "predecessor": {
            "schedule": {
                "name": "SimpleSchedule"
            },
            "name": "SimpleJob1"
        }
    }
]
Authorizations:
Token
path Parameters
jobId
required
string
Request Body schema:
Array
scheduleId
integer <int32>
scheduleInstanceNumber
integer <int32>
jobName
string or null
id
integer <int64>

The id of the job dependency

object (OpCon.Api.Data.Entities.Frequency)

A frequency

object (OpCon.Api.Data.Entities.DailyJobDependencyType)

A job dependency type

object (OpCon.Api.Data.JobDependencyPredecessor)

A job dependency predecessor

scheduleDate
integer <int32>
isSatisfied
boolean

The status of the daily job dependency

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
No sample

Creates a new Job Dependency for the Daily Job with the specified daily job Id

Sample request:

POST /api/dailyJobs/20210101|15|1|Job1/dependencies

{
    "type": {
        "name": "After",
        "condition": "Failed",
        "offset": 0
    },
    "predecessor": {
        "schedule": {
            "name": "SimpleSchedule"
        },
        "name": "SimpleJob1"
    }
}
Authorizations:
Token
path Parameters
jobId
required
string
Request Body schema:
scheduleId
integer <int32>
scheduleInstanceNumber
integer <int32>
jobName
string or null
id
integer <int64>

The id of the job dependency

object (OpCon.Api.Data.Entities.Frequency)

A frequency

object (OpCon.Api.Data.Entities.DailyJobDependencyType)

A job dependency type

object (OpCon.Api.Data.JobDependencyPredecessor)

A job dependency predecessor

scheduleDate
integer <int32>
isSatisfied
boolean

The status of the daily job dependency

Responses

Request samples

Content type
{
  • "scheduleId": 0,
  • "scheduleInstanceNumber": 0,
  • "jobName": "string",
  • "id": 0,
  • "frequency": {
    },
  • "type": {
    },
  • "predecessor": {
    },
  • "scheduleDate": 0,
  • "isSatisfied": true
}

Response samples

Content type
No sample

Gets the Job Dependency with the specified Id for the Daily Job with the specified daily job Id

Sample request:

GET /api/dailyJobs/20210101|15|1|Job1/dependencies/2
Authorizations:
Token
path Parameters
jobId
required
string
id
required
integer <int64>

Responses

Response samples

Content type
No sample

Updates the Job Dependency with the specified dependency Id for the Daily Job with the specified daily job Id

Sample request:

PUT /api/dailyjobs/20210101|15|1|Job1/dependencies/2

{
    "type": {
        "name": "Conflict",
        "jobNameLike": "Simple",
        "offset": -1
    },
    "predecessor": {
        "schedule": {
            "name": "SimpleSchedule"
        },
        "name": "SimpleJob1"
}
Authorizations:
Token
path Parameters
jobId
required
string
id
required
integer <int64>
Request Body schema:
scheduleId
integer <int32>
scheduleInstanceNumber
integer <int32>
jobName
string or null
id
integer <int64>

The id of the job dependency

object (OpCon.Api.Data.Entities.Frequency)

A frequency

object (OpCon.Api.Data.Entities.DailyJobDependencyType)

A job dependency type

object (OpCon.Api.Data.JobDependencyPredecessor)

A job dependency predecessor

scheduleDate
integer <int32>
isSatisfied
boolean

The status of the daily job dependency

Responses

Request samples

Content type
{
  • "scheduleId": 0,
  • "scheduleInstanceNumber": 0,
  • "jobName": "string",
  • "id": 0,
  • "frequency": {
    },
  • "type": {
    },
  • "predecessor": {
    },
  • "scheduleDate": 0,
  • "isSatisfied": true
}

Response samples

Content type
No sample

Deletes the Job Dependency with the specified dependency Id for the Daily Job with the specified daily job Id

Sample request:

DELETE /api/dailyJobs/20210101|15|1|Job1/dependencies/2
Authorizations:
Token
path Parameters
jobId
required
string
id
required
integer <int64>

Responses

Response samples

Content type
No sample

DailySchedules

Gets the total count of Daily Schedules based on optional criteria specified

Sample request: 

GET /api/dailySchedules/count_by_status
Authorizations:
Token
query Parameters
IncludeAll
boolean

Flag to include all Schedule details

IncludeProperties
boolean

Flag to include Properties associated with the Daily Schedule

IncludeDetails
boolean

Flag to include details of the Daily Schedule

IncludeEvents
boolean

Flag to include Events associated with the Daily Schedule

uids
string
SortOrders
Array of strings
ScheduleDates
Array of integers <int32> [ items <int32 > ]

Daily Schedule dates to include

ScheduleCategories
Array of strings

Daily Schedule categories to include

Ids
string

Comma-separated list of Daily Schedule Ids

Name
string

The schedule name (Can accept ? and * wildcards)

Status
string

The schedule status

Categories
string
FailedJobs
boolean

Flag to include Daily Schedules with Failed Jobs

Offset
integer <int32>

Retrieves records beginning at this record number

Limit
integer <int32>

Limits the results being fetched

Path
string

Daily Schedule Path (Can accept ? and * wildcards)

SortBy
string

Options to sort Daily Schedule by (Id, Status, Name, Date, Path, Duration, Failed Jobs, StartTime, EndTime)

Dates
string

Comman-separated list of Daily Schedule dates to include

Responses

Response samples

Content type
No sample

Gets a list of dates on which the Daily Schedules built based on optional criteria provided

Sample request: 

GET /api/dailySchedules/dates?name=SMA Utility
Authorizations:
Token
query Parameters
IncludeAll
boolean

Flag to include all Schedule details

IncludeProperties
boolean

Flag to include Properties associated with the Daily Schedule

IncludeDetails
boolean

Flag to include details of the Daily Schedule

IncludeEvents
boolean

Flag to include Events associated with the Daily Schedule

uids
string
SortOrders
Array of strings
ScheduleDates
Array of integers <int32> [ items <int32 > ]

Daily Schedule dates to include

ScheduleCategories
Array of strings

Daily Schedule categories to include

Ids
string

Comma-separated list of Daily Schedule Ids

Name
string

The schedule name (Can accept ? and * wildcards)

Status
string

The schedule status

Categories
string
FailedJobs
boolean

Flag to include Daily Schedules with Failed Jobs

Offset
integer <int32>

Retrieves records beginning at this record number

Limit
integer <int32>

Limits the results being fetched

Path
string

Daily Schedule Path (Can accept ? and * wildcards)

SortBy
string

Options to sort Daily Schedule by (Id, Status, Name, Date, Path, Duration, Failed Jobs, StartTime, EndTime)

Dates
string

Comman-separated list of Daily Schedule dates to include

Responses

Response samples

Content type
No sample

Gets the details for the Daily Schedules with the specified Id

Sample request: 

GET /api/dailySchedules/20221228|1|1/details
Authorizations:
Token
path Parameters
id
required
string

Responses

Response samples

Content type
No sample

Gets the Daily Schedule with the specified Id

Sample request: 

GET /api/dailySchedules/20221228|1|1
Authorizations:
Token
path Parameters
id
required
string

Responses

Response samples

Content type
No sample

Updates the Daily Schedule with the specified Id

Sample request:

PUT /api/dailySchedules/20221228|1|1

[
  {
    "id": "20221228|1|1",
    "definedStartTime": "2022-12-28T00:00:00.0000000-06:00",
    "name": "SMAUtility",
    "instance": 1,
    "date": "2022-12-28T00:00:00.0000000-06:00",
    "path": "SMAUtility",
    "workWeek": 5
  }
]
Authorizations:
Token
path Parameters
id
required
string
Request Body schema:
uid
integer or null <int64>

The unique id

Array of objects or null (OpCon.Api.Data.Entities.InstanceProperty)

List of instance properties

dateAsInteger
integer <int32>
id
string or null

The daily schedule id

masterId
integer <int32>

The schedule id

object (OpCon.Api.Data.Entities.DailyScheduleDetails)
object (OpCon.Api.Data.Entities.Jobs.ComputedTime)
definedStartTime
string or null

The defined start time

endTime
string or null

The end time

name
string or null

The schedule name

object (OpCon.Api.Data.Entities.ScheduleStatus)
instance
integer or null <int32>

The schedule instance number

duration
integer or null <int64>

The duration in seconds

date
string or null

The schedule build date

path
string or null

The schedule path

containerJobId
string or null
workWeek
integer <int32>

The number of workweek days

Array of objects or null (OpCon.Api.Data.Services.DailyJobEvents.Models.ScheduleJobEventModel)

The daily schedule events

Responses

Request samples

Content type
{
  • "uid": 0,
  • "instanceProperties": [
    ],
  • "dateAsInteger": 0,
  • "id": "string",
  • "masterId": 0,
  • "details": {
    },
  • "computedStartTime": {
    },
  • "definedStartTime": "string",
  • "endTime": "string",
  • "name": "string",
  • "status": {
    },
  • "instance": 0,
  • "duration": 0,
  • "date": "string",
  • "path": "string",
  • "containerJobId": "string",
  • "workWeek": 0,
  • "events": [
    ]
}

Response samples

Content type
No sample

Gets the Daily Schedules based on optional criteria provided

Sample request: 

GET /api/dailyschedules?name=SMA Utility
Authorizations:
Token
query Parameters
IncludeAll
boolean

Flag to include all Schedule details

IncludeProperties
boolean

Flag to include Properties associated with the Daily Schedule

IncludeDetails
boolean

Flag to include details of the Daily Schedule

IncludeEvents
boolean

Flag to include Events associated with the Daily Schedule

uids
string
SortOrders
Array of strings
ScheduleDates
Array of integers <int32> [ items <int32 > ]

Daily Schedule dates to include

ScheduleCategories
Array of strings

Daily Schedule categories to include

Ids
string

Comma-separated list of Daily Schedule Ids

Name
string

The schedule name (Can accept ? and * wildcards)

Status
string

The schedule status

Categories
string
FailedJobs
boolean

Flag to include Daily Schedules with Failed Jobs

Offset
integer <int32>

Retrieves records beginning at this record number

Limit
integer <int32>

Limits the results being fetched

Path
string

Daily Schedule Path (Can accept ? and * wildcards)

SortBy
string

Options to sort Daily Schedule by (Id, Status, Name, Date, Path, Duration, Failed Jobs, StartTime, EndTime)

Dates
string

Comman-separated list of Daily Schedule dates to include

Responses

Response samples

Content type
No sample

Gets the Instance Properties for the Daily Schedule with the specified Id

Sample request: 

GET /api/dailySchedules/20221228|1|1/properties
Authorizations:
Token
path Parameters
scheduleId
required
string

Responses

Response samples

Content type
No sample

Gets the Instance Property with the specified property Id for the Daily Schedule with the specified daily schedule Id

Sample request:

GET /api/dailySchedules/20221228|1|1/properties/prop1
Authorizations:
Token
path Parameters
scheduleId
required
string
propertyKey
required
string

Responses

Response samples

Content type
No sample

Deletes the Instance Property with the specified Name for the Daily Schedule with the specified Id

Sample request:

DELETE /api/dailySchedules/20221228|1|1/properties/prop1
Authorizations:
Token
path Parameters
scheduleId
required
string
propertyKey
required
string

Responses

Creates a new Instance Property for the Daily Schedule with the specified Id

Sample request:

POST /api/dailySchedules/20221228|1|1/properties

{  
    "key": "NewProperty",  
    "value": "NewValue"  
}
Authorizations:
Token
path Parameters
id
required
string
Request Body schema:
key
string or null
value
string or null

Responses

Request samples

Content type
{
  • "key": "string",
  • "value": "string"
}

Response samples

Content type
No sample

Updates the Instance Property with the specified Name for the Daily Schedule with the specified Id

Sample request:

PUT /api/dailySchedules/20221228|1|1/properties/prop1

{  
    "key": "prop1",  
    "value": "updatedValue"  
}
Authorizations:
Token
path Parameters
id
required
string
name
required
string
Request Body schema:
key
string or null
value
string or null

Responses

Request samples

Content type
{
  • "key": "string",
  • "value": "string"
}

Response samples

Content type
No sample

DailyVisionWorkspaces

Gets the Daily Vision Workspaces based on optional criteria specified

Sample request: 

GET /api/dailyVisionWorkspaces
Authorizations:
Token
query Parameters
DayOffset
integer <int32>

Offset in days from today

IncludeCardsWithoutStatus
boolean

Flag to include cards without status

Responses

Response samples

Content type
No sample

Gets the Daily Vision Workspace with the specified Id. Currently, Id must be 1.

Sample request: 

GET /api/dailyVisionWorkspaces/1
Authorizations:
Token
path Parameters
id
required
integer <int32>
query Parameters
DayOffset
integer <int32>

Offset in days from today

IncludeCardsWithoutStatus
boolean

Flag to include cards without status

Responses

Response samples

Content type
No sample

DeleteActions

Deletes a collection of Jobs based on a given job Id, schedule Id, or date range.

Sample request:

POST /api/deleteActions
Authorizations:
Token
Request Body schema:

The request containing one or more request items.

required
Array of objects (OpCon.Api.Data.Services.QueuedDelete.QueuedDeleteRequestItem)

Responses

Request samples

Content type
{
  • "items": [
    ]
}

Response samples

Content type
No sample

Departments

Gets the Department with the specified Id

Sample request (this returns the Department with Id = 1):

GET /api/departments/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Department with the specified Id

Sample request (this updates the Department with Id = 1):

PUT /api/departments/1
        
{
    "id": 1,
    "name": "Marketing"
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer <int32>
name
string or null

The name of the department

documentation
string or null
object (OpCon.Api.Data.Services.Departments.Models.DepartmentAssociations)
scheduleId
integer or null <int32>
scheduleName
string or null
jobName
string or null
dailyScheduleId
integer <int32>
dailyScheduleName
string or null
dailyJobName
string or null
dailyJobDate
integer <int32>
role
string or null

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "documentation": "string",
  • "associations": {
    },
  • "scheduleId": 0,
  • "scheduleName": "string",
  • "jobName": "string",
  • "dailyScheduleId": 0,
  • "dailyScheduleName": "string",
  • "dailyJobName": "string",
  • "dailyJobDate": 0,
  • "role": "string"
}

Response samples

Content type
No sample

Deletes the Department with the specified Id

Sample request (this deletes the Department with Id = 1):

DELETE /api/departments/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Gets a list of Departments based on optional criteria specified

Sample request (this returns a list of Departments by Name in descending order):

GET /api/departments?sortBy=name:desc
Authorizations:
Token
query Parameters
Name
string

The Department Name (Can accept ? and * wildcards)

Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

Ids
string

Comma-separated list of Department Ids

SortOrders
Array of strings
BasicDetails
boolean

Flag to indicate to only return name and id data for the departments

AccessibleDepartments
Array of integers <int32> [ items <int32 > ]
SortBy
string

Option to sort Departments by Name in ascending (default) or descending (:desc) order

Responses

Response samples

Content type
No sample

Creates a new Department and returns it with its Id, if successful

Sample request:

POST /api/departments
        
{
    "name": "Sales"
}
Authorizations:
Token
Request Body schema:
id
integer <int32>
name
string or null

The name of the department

documentation
string or null
object (OpCon.Api.Data.Services.Departments.Models.DepartmentAssociations)
scheduleId
integer or null <int32>
scheduleName
string or null
jobName
string or null
dailyScheduleId
integer <int32>
dailyScheduleName
string or null
dailyJobName
string or null
dailyJobDate
integer <int32>
role
string or null

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "documentation": "string",
  • "associations": {
    },
  • "scheduleId": 0,
  • "scheduleName": "string",
  • "jobName": "string",
  • "dailyScheduleId": 0,
  • "dailyScheduleName": "string",
  • "dailyJobName": "string",
  • "dailyJobDate": 0,
  • "role": "string"
}

Response samples

Content type
No sample

Escalation

Gets a list of Escalations tied to the current user

Sample request:

GET /api/escalations
Authorizations:
Token
path Parameters
userId
required
integer <int32>

Responses

Response samples

Content type
No sample

Acknowledges Escalations in bulk

Sample request:

PUT /api/users/0/escalations/

[
    {  
        "escalationId": 1,  
        "acknowledged": true
    },
    {  
        "escalationId": 2,  
        "acknowledged": true
    }
]
Authorizations:
Token
path Parameters
userId
required
integer <int32>
Request Body schema:
Array
escalationId
integer <int32>

The unique identifier of the escalation

escalationRuleId
integer <int32>

The unique rule identifier

escalationSequence
integer <int32>

The escalation sequence level

status
string or null

The status assigned to the escalation

escalationStatus
integer <int32>
attempts
integer or null <int32>

The amont of attempts

timeMessageSent
string or null

Time stamp for last message sent

lastMessageSent
string or null <date-time>
actionMessage
string or null
object (OpCon.Api.Data.Entities.EscalationNotification)
triggerName
string or null
acknowledgedBy
string or null

User who acknowledged the escalation

acknowledgeTime
string or null <date-time>

The time the escalation was acknowledged

acknowledgeHostName
string or null

The host name that acknowledged the notification

acknowledged
boolean

Flag describing whether the notification was acknowledged

actionIncludeId
string or null
scheduleDate
string or null
scheduleName
string or null
instanceNumber
integer <int32>
jobName
string or null
machineName
string or null
actionId
integer <int32>
actionName
string or null
groupOfId
integer <int32>
notifyDelimiter
string or null
actionType
integer or null <int32>
matchEscalation
object (OpCon.Api.Data.Entities.Escalation) Recursive

Responses

Request samples

Content type
[
  • {
    }
]

Response samples

Content type
No sample

Gets an Escalation with the specified escalation Id for the user with the specified user Id

Sample request (this returns the Escalation with Id = 1 for the User with Id = 0):

GET /api/users/0/escalation/1
Authorizations:
Token
path Parameters
userId
required
integer <int32>
escalationId
required
integer <int32>

Responses

Response samples

Content type
No sample

Acknowledges the Escalation with the specified Id

Sample request:

PUT /api/users/0/escalations/1

{  
    "escalationId": 1,  
    "acknowledged": true
}
Authorizations:
Token
path Parameters
userId
required
integer <int32>
escalationId
required
integer <int32>
Request Body schema:
escalationId
integer <int32>

The unique identifier of the escalation

escalationRuleId
integer <int32>

The unique rule identifier

escalationSequence
integer <int32>

The escalation sequence level

status
string or null

The status assigned to the escalation

escalationStatus
integer <int32>
attempts
integer or null <int32>

The amont of attempts

timeMessageSent
string or null

Time stamp for last message sent

lastMessageSent
string or null <date-time>
actionMessage
string or null
object (OpCon.Api.Data.Entities.EscalationNotification)
triggerName
string or null
acknowledgedBy
string or null

User who acknowledged the escalation

acknowledgeTime
string or null <date-time>

The time the escalation was acknowledged

acknowledgeHostName
string or null

The host name that acknowledged the notification

acknowledged
boolean

Flag describing whether the notification was acknowledged

actionIncludeId
string or null
scheduleDate
string or null
scheduleName
string or null
instanceNumber
integer <int32>
jobName
string or null
machineName
string or null
actionId
integer <int32>
actionName
string or null
groupOfId
integer <int32>
notifyDelimiter
string or null
actionType
integer or null <int32>
matchEscalation
object (OpCon.Api.Data.Entities.Escalation) Recursive

Responses

Request samples

Content type
{
  • "escalationId": 0,
  • "escalationRuleId": 0,
  • "escalationSequence": 0,
  • "status": "string",
  • "escalationStatus": 0,
  • "attempts": 0,
  • "timeMessageSent": "string",
  • "lastMessageSent": "2019-08-24T14:15:22Z",
  • "actionMessage": "string",
  • "notification": {
    },
  • "triggerName": "string",
  • "acknowledgedBy": "string",
  • "acknowledgeTime": "2019-08-24T14:15:22Z",
  • "acknowledgeHostName": "string",
  • "acknowledged": true,
  • "actionIncludeId": "string",
  • "scheduleDate": "string",
  • "scheduleName": "string",
  • "instanceNumber": 0,
  • "jobName": "string",
  • "machineName": "string",
  • "actionId": 0,
  • "actionName": "string",
  • "groupOfId": 0,
  • "notifyDelimiter": "string",
  • "actionType": 0,
  • "matchEscalation": { }
}

Response samples

Content type
No sample

EscalationGroups

Gets a list of Escalation Groups based on optional criteria specified

Sample request:

GET /api/escalationGroups?name=*Test?
Authorizations:
Token
query Parameters
Name
string
Ids
Array of integers <int32> [ items <int32 > ]

Responses

Response samples

Content type
No sample

Creates a new Escalation Group and returns it with its Id, if successful

Sample request:

POST /api/escalationGroups

{ "Name": "Testing", "Users": [ { "UserId": 0, "UserSignon": "ocadm" }, { "UserId": -1, "UserSignon": "[[Token]]" } ] }

Authorizations:
Token
Request Body schema:
name
required
string non-empty
required
Array of objects (SMAOpConRestApi.Controllers.Models.Escalation.EscalationGroupUserModel) non-empty

Responses

Request samples

Content type
{
  • "name": "string",
  • "users": [
    ]
}

Response samples

Content type
No sample

Gets the Escalation Group with the specified Id

Sample request:

GET /api/escalationGroups/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Deletes the Escalation Group with the specified Id

Sample request:

DELETE /api/escalationGroups/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Gets a list of available Users that can be assigned to an Escalation Group

Sample request:

GET /api/escalationGroups/users
Authorizations:
Token

Responses

Response samples

Content type
No sample

Updates the Escalation Group with the specified Id

Sample request:

PUT /api/escalationGroups/1

{ "Name": "Testing", "Users": [ { "UserId": 0, "UserSignon": "ocadm" }, { "UserId": -1, "UserSignon": "[[UserToken]]" } ] }

Authorizations:
Token
path Parameters
groupId
required
integer <int32>
Request Body schema:
name
required
string non-empty
required
Array of objects (SMAOpConRestApi.Controllers.Models.Escalation.EscalationGroupUserModel) non-empty

Responses

Request samples

Content type
{
  • "name": "string",
  • "users": [
    ]
}

Response samples

Content type
No sample

EscalationRules

Gets a list of Escalation Rules based on optional criteria specified

Sample request:

    GET /api/escalationRules?name=*Test?
Authorizations:
Token
query Parameters
Name
string
Ids
Array of integers <int32> [ items <int32 > ]

Responses

Response samples

Content type
No sample

Creates a new Escalation Rule and returns it with its Id, if successful

Sample request:

POST: api/escalationRules

{
    "name": "escrule", // name is required
    "sequences": [ // at least one sequence is required
        {
            "sequence": 1, // all fields are required for a sequence
            "attempts": 1,
            "interval": 1,
            "group": {
            "id": 1 // group name is not required but an id is
            }
        }
}
Authorizations:
Token
Request Body schema:
name
required
string non-empty
required
Array of objects (SMAOpConRestApi.Controllers.Models.Escalation.EscalationSequenceModel) non-empty

Responses

Request samples

Content type
{
  • "name": "string",
  • "sequences": [
    ]
}

Response samples

Content type
No sample

Gets an Escalation Rule with the specified Id

Sample request:

GET /api/escalationRules/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Deletes the Escalation Rule with the specified Id

Sample request:

DELETE /api/escalationRules/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Updates the Escalation Rule with the specified Id

Sample request:

PUT /api/escalationRules/1

{
    "id": 3,
    "name": "escrule", 
    "sequences": [
        {
            "sequence": 1,
            "attempts": 1,
            "interval": 1,
            "group": {
            "id": 1,
            "name": "group1"
            }
        }
    ]   
}
Authorizations:
Token
path Parameters
ruleId
required
integer <int32>
Request Body schema:
name
required
string non-empty
required
Array of objects (SMAOpConRestApi.Controllers.Models.Escalation.EscalationSequenceModel) non-empty

Responses

Request samples

Content type
{
  • "name": "string",
  • "sequences": [
    ]
}

Response samples

Content type
No sample

ExternalToken

Creates an External Token for use by the user submitting the request

The token is stored encrypted in the database and must be copied for use by the user. When length is provided, the generated token can only be used for external events. When length is not provided, the generated token can be used to interact with the API and for external events. To receive the token in the response, the user's isExternalTokenDisabled property must be false.

Sample request (this creates a new External Token with 20 characters):

POST /api/externaltoken

{  
    "length": 20  
}
Authorizations:
Token
Request Body schema:
token
string or null
length
integer or null <int32>

Responses

Request samples

Content type
{
  • "token": "string",
  • "length": 0
}

Response samples

Content type
No sample

Features

Gets a list of Features based on the optional criteria specified

Sample request:

GET /api/features
Authorizations:
Token
query Parameters
object (OpCon.Api.Data.Criteria.FeatureCriteria)

Responses

Response samples

Content type
No sample

Feedback

Gets a list of Feedback values based on optional criteria specified

Sample request (this returns a list of Feedback values with a JobType = 6):

 GET /api/feedback?jobType=6
Authorizations:
Token
query Parameters
JobTypeId
integer <int32>
Name
string

Responses

Response samples

Content type
No sample

Frequencies

Gets a list of Frequencies based on optional criteria specified

Sample request: 

GET /api/frequencies
Authorizations:
Token
query Parameters
Name
string

The Frequency Name

Skdid
integer <int32>

The Schedule Id

Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

SortOrders
Array of strings

Option to sort Frequencies by Name, AOBN, CalendarName and InUse in ascending (default) or descending (:desc) order

Aobn
string

The Frequency AOBN (AfterDate, BeforeDate, OnDate, NotSchedule)

Calendar
string

The Frequency Calendar Name

InUse
integer <int32>

The number of times the Frequency is used

IgnoreCase
boolean

Flag for case insensitive search

IncludeAssociations
boolean

Flag to include a list of Daily and Master Jobs to which the Frequency is assigned

DuplicateFrequencyCodes
boolean

Flag to return only Frequencies having duplicate settings

BasicDetails
boolean

Flag to return basic Frequency details only

SortBy
string

Option to sort Frequencies by Name, Calendar, AOBN or InUse in ascending (default) or descending (:desc) order

Responses

Response samples

Content type
No sample

Creates a new Frequency

Sample request: 

POST /api/frequencies

{
    "name": "",
    "settings": {
        "dayOffset": 0,
        "aobn": "OnDate",
        "frequencyType": "BegOfPeriod",
        "period": "Week",
        "dayType": "Working",
        "calendar": "<None>"
    }
}
Authorizations:
Token
Request Body schema:
name
string or null

The name of the frequency

frequencyCode
integer <int32>

The frequency code

jobBuildStatus
string or null

The job build status of the frequency will always be "Unknown" as this property is not used

inUse
integer or null <int32>

The quantity of schedules and/or jobs using the frequency

object (OpCon.Api.Data.Entities.FrequencySettings)

Frequency settings

Responses

Request samples

Content type
{
  • "name": "string",
  • "frequencyCode": 0,
  • "jobBuildStatus": "string",
  • "inUse": 0,
  • "settings": {
    }
}

Response samples

Content type
No sample

Gets a Frequency by Name

Sample request:

GET /api/frequencies/frequencyName
Authorizations:
Token
path Parameters
name
required
string

Responses

Response samples

Content type
No sample

Updates the Frequency with the specified Name

Sample request: 

PUT /api/frequencies/frequencyName/settings
        
{
    "name": "frequencyName",
    "settings": {
        "dayOffset": 0,
        "aobn": "OnDate",
        "frequencyType": "AnnualPlan",
        "calendar": {
          "name": "Master Holiday"
        }
    }
}
Authorizations:
Token
path Parameters
name
required
string
Request Body schema:
name
string or null

The name of the frequency

frequencyCode
integer <int32>

The frequency code

jobBuildStatus
string or null

The job build status of the frequency will always be "Unknown" as this property is not used

inUse
integer or null <int32>

The quantity of schedules and/or jobs using the frequency

object (OpCon.Api.Data.Entities.FrequencySettings)

Frequency settings

Responses

Request samples

Content type
{
  • "name": "string",
  • "frequencyCode": 0,
  • "jobBuildStatus": "string",
  • "inUse": 0,
  • "settings": {
    }
}

Response samples

Content type
No sample

Gets a Frequency Forecast based on the request provided

Sample request: 

POST /api/frequencies/forecast

{
    "year": 2023,
    "scheduleId": 1,
    "forecastType": "Job",
    "frequencies": [
    {
        "frequencyName": "",
        "frequencyType": "OnOccurrence",
        "priority": 0,
        "settings": {
            "dayOffset": 0,
            "aobn": "OnDate",
            "frequencyType": "BegOfPeriod",
            "period": "Week",
            "dayType": "Working",
            "calendar": "<None>"
        },
        "advancedFrequencySettings": {
            "includeInScheduleOn": "03-16-2023"
        }
    }]
}
Authorizations:
Token
Request Body schema:
year
required
integer <int32>

The year to forecast.

scheduleId
integer <int32>

The schedule id to forecast. Required when forecast type is 'Schedule' or 'Job'.

forecastType
required
integer <int32> (OpCon.Api.Data.Entities.ForecastTypes)
Enum: 0 1 2 3
required
Array of objects (OpCon.Api.Data.Entities.ForecastRequestFrequency)

The list of frequencies to include in the forecast.

Responses

Request samples

Content type
{
  • "year": 0,
  • "scheduleId": 0,
  • "forecastType": 0,
  • "frequencies": [
    ]
}

Response samples

Content type
No sample

FrequencyNames

Gets a list of Frequency Names

Sample request: 

GET /api/frequencyNames
Authorizations:
Token
query Parameters
Name
string

The Frequency Name

Skdid
integer <int32>

The Schedule Id

Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

SortOrders
Array of strings

Option to sort Frequencies by Name, AOBN, CalendarName and InUse in ascending (default) or descending (:desc) order

Aobn
string

The Frequency AOBN (AfterDate, BeforeDate, OnDate, NotSchedule)

Calendar
string

The Frequency Calendar Name

InUse
integer <int32>

The number of times the Frequency is used

IgnoreCase
boolean

Flag for case insensitive search

IncludeAssociations
boolean

Flag to include a list of Daily and Master Jobs to which the Frequency is assigned

DuplicateFrequencyCodes
boolean

Flag to return only Frequencies having duplicate settings

BasicDetails
boolean

Flag to return basic Frequency details only

SortBy
string

Option to sort Frequencies by Name, Calendar, AOBN or InUse in ascending (default) or descending (:desc) order

Responses

Response samples

Content type
No sample

GlobalProperties

Gets a list of Global Properties based on optional criteria specified

Sample request (this returns a list of Global Properties by Name in descending order):

GET /api/globalProperties?sortBy=name:desc
Authorizations:
Token
query Parameters
Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

Name
string

The Global Property Name (Can accept ? and * wildcards)

Encrypted
string

Include encrypted Global Properties only (true or false (default))

Ids
string

Comma-separated list of Global Property Ids

Value
string

The Global Property Value (Can accept ? and * wildcards)

NameOrValue
string

The Global Property Name or Value (Can accept ? and * wildcards)

NoPatternValue
boolean

Flag to include Global Properties without pattern Values

SortOrder.SortBy
string
SortOrder.IdColumns
Array of strings
SortOrder.ValidSortOrders
Array of strings
SortOrder.ColumnList
Array of strings
SortOrder.SortTypeList
Array of strings
SortBy
string

Option to sort Global Properties by Id, Name or Value

Responses

Response samples

Content type
No sample

Creates a new Global Property and return it with its Id, if successful

Sample request:

POST /api/globalProperties

{
    "name": "GP1",
    "value": "GP Value"
}
Authorizations:
Token
Request Body schema:
id
integer or null <int32>

Id for the global property

name
string or null

Name for the global property

value
string or null

Text value for the global property

documentation
string or null

Documentation for the global property

encrypted
boolean

Specifies if the global property is encrypted

fullName
string or null

Full Name of the global property

category
string or null

Category for the global property (GI, MI, SI, JI)

isPatternValue
boolean

Specifies whether the global property's values is a pattern

type
string or null

Global property type (System, User)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "value": "string",
  • "documentation": "string",
  • "encrypted": true,
  • "fullName": "string",
  • "category": "string",
  • "isPatternValue": true,
  • "type": "string"
}

Response samples

Content type
No sample

Gets the Global Property with specified Id

Sample request:

GET /api/globalProperties/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates of the Global Property with the specified Id

Sample request:

POST /api/globalProperties/1

{
    "id": 1,
    "name": "GP1",
    "value": "GP Value"
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer or null <int32>

Id for the global property

name
string or null

Name for the global property

value
string or null

Text value for the global property

documentation
string or null

Documentation for the global property

encrypted
boolean

Specifies if the global property is encrypted

fullName
string or null

Full Name of the global property

category
string or null

Category for the global property (GI, MI, SI, JI)

isPatternValue
boolean

Specifies whether the global property's values is a pattern

type
string or null

Global property type (System, User)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "value": "string",
  • "documentation": "string",
  • "encrypted": true,
  • "fullName": "string",
  • "category": "string",
  • "isPatternValue": true,
  • "type": "string"
}

Response samples

Content type
No sample

Deletes the Global Property with the specified Id

Sample request:

DELETE /api/globalProperties/22
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

HistoryJob

Gets a list of Job Histories based on optional criteria specified

Sample request:

GET /api/jobHistories?from=03-15-2021&to=03-17-2021
Authorizations:
Token
query Parameters
From
string

The date to start the search from

To
string

The date to end the search

JobName
string

The Job Name

Duration
integer <int32>

The Job Duration

JobStatusIds
string

The Job Status Ids

RunDate
string

The Job Run Date

MachineName
string

The Machine Name

Offset
integer <int32>

Retrieves records beginning at this record number

Limit
integer <int32>

Limits the results being fetched

IncludeSummary
boolean

Flag to include Job Summary

PermissionIds
string

Comma-separated list of Permission Ids

UniqueId
string

The Job Unique Id

JobInstanceNumber
integer <int32>

The Job Instance Number

ScheduleId
integer <int32>

The Schedule Id

UniqueJobIds
string

Responses

Response samples

Content type
No sample

Gets a list of Job Histories for a job with the given master job id

Sample request:

GET /api/jobHistories/scheduleName|JobName?from=03-15-2021&to=03-17-2021
Authorizations:
Token
path Parameters
id
required
string
query Parameters
From
string

The date to start the search from

To
string

The date to end the search

JobName
string

The Job Name

Duration
integer <int32>

The Job Duration

JobStatusIds
string

The Job Status Ids

RunDate
string

The Job Run Date

MachineName
string

The Machine Name

Offset
integer <int32>

Retrieves records beginning at this record number

Limit
integer <int32>

Limits the results being fetched

IncludeSummary
boolean

Flag to include Job Summary

PermissionIds
string

Comma-separated list of Permission Ids

UniqueId
string

The Job Unique Id

JobInstanceNumber
integer <int32>

The Job Instance Number

ScheduleId
integer <int32>

The Schedule Id

UniqueJobIds
string

Responses

Response samples

Content type
No sample

Gets a list of Job History Notes for the given daily job Id

Sample request:

GET /api/jobHistories/2021|03|16|someJob/notes
Authorizations:
Token
path Parameters
id
required
string

Responses

Response samples

Content type
No sample

Updates a list of Job History Notes for the given daily job Id

Sample request:

PUT /api/jobHistories/2021|03|16|jobName/notes
Authorizations:
Token
path Parameters
id
required
string
Request Body schema:
jobId
string or null
Array of objects or null (OpCon.Api.Data.Entities.Note)

Responses

Request samples

Content type
{
  • "jobId": "string",
  • "notes": [
    ]
}

Response samples

Content type
No sample

Hostname

Gets the Hostname for the API Host Machine

Sample request:

GET /api/hostname
Authorizations:
Token

Responses

Response samples

Content type
No sample

ImpEx

Gets a list of Master Schedules based on optional criteria specified

Sample request (this returns a list of Master Schedules by Name in descending order):

GET /api/impEx/schedules?sortBy=name:desc
Authorizations:
Token
query Parameters
Ids
Array of integers <int32> [ items <int32 > ]
Name
string
Offset
integer <int32>

Retrieves records beginning at this record number

Limit
integer <int32>

Limits the results being fetched

AutoBuild
boolean

Flag to include AutoBuild Schedules only

MultiInstance
boolean

Flag to include Multi-Instance Schedules only

SubSchedule
boolean

Flag to include Sub-Schedules only

SortBy
string

Option to sort Schedules Name in ascending (default) or descending (:desc) order

IncludeDetails
boolean

Flag to include Schedule details

IncludeScheduleHierachy
boolean

Flag to include Schedule hierachy

CaseSensitive
boolean

Flag to use case sensitive search

BasicDetails
boolean

Flag to return only the basic details of the Schedule

IncludeDailySchedules
boolean

Flag to include Daily Schedules

IncludeMasterJobDetails
boolean

Flag to include Master Job details

Responses

Response samples

Content type
No sample

Creates a new Master Schedule and returns it with its Id, if successful

Sample request:

POST /api/impEx/schedules
        
{
    "name":"NewSchedule",
    "isMultiInstance":false,
    "isSubSchedule":false,
    "weekDays": {
        "monday":true,
        "tuesday":true,
        "wednesday":true,
        "thursday":true,
        "friday":true,
        "saturday":false,
        "sunday":false
    },
    "useMasterHoliday":true,
}
Authorizations:
Token
Request Body schema:
id
integer <int32>
name
string or null
documentation
string or null
isMultiInstance
boolean
isSubSchedule
boolean
containSubSchedule
boolean
Array of objects or null (OpCon.Api.Data.Entities.ImpEx.ImpExSubSchedule)
hasJobLevelFrequencies
boolean
object (OpCon.Api.Data.Entities.ImpEx.WeekDays)
object (OpCon.Api.Data.Entities.ImpEx.StartOffset)
useMasterHoliday
boolean
object (OpCon.Api.Data.Services.Calendars.Calendar)

A calendar with id, type, Schedule, Dates and name fields

conflictsWithOtherDays
boolean
object (OpCon.Api.Data.Entities.ImpEx.AutoBuildSettings)
object (OpCon.Api.Data.Entities.ImpEx.SingleInstanceProperties)
object (OpCon.Api.Data.Entities.ImpEx.MultiInstanceProperties)
object (OpCon.Api.Data.Entities.ImpEx.CrossReference)
object (OpCon.Api.Data.Services.ImpEx.ImpExScheduleDeployInformation)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "documentation": "string",
  • "isMultiInstance": true,
  • "isSubSchedule": true,
  • "containSubSchedule": true,
  • "parent": [
    ],
  • "hasJobLevelFrequencies": true,
  • "weekDays": {
    },
  • "startOffset": {
    },
  • "useMasterHoliday": true,
  • "additionalHolidays": {
    },
  • "conflictsWithOtherDays": true,
  • "autoBuildSettings": {
    },
  • "singleInstanceProperties": {
    },
  • "multiInstanceProperties": {
    },
  • "associations": {
    },
  • "deployInformation": {
    }
}

Response samples

Content type
No sample

Gets the Master Schedule with the specified Id

Sample request:

GET /api/impEx/schedules/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Master Schedule with the specified Id

Sample request:

PUT /api/impEx/schedules/10
        
{
    "id":10,
    "name":"UpdatedSchedule",
    "isMultiInstance":false,
    "isSubSchedule":false,
    "weekDays": {
        "monday":true,
        "tuesday":true,
        "wednesday":true,
        "thursday":true,
        "friday":true,
        "saturday":false,
        "sunday":false
    },
    "useMasterHoliday":true,
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer <int32>
name
string or null
documentation
string or null
isMultiInstance
boolean
isSubSchedule
boolean
containSubSchedule
boolean
Array of objects or null (OpCon.Api.Data.Entities.ImpEx.ImpExSubSchedule)
hasJobLevelFrequencies
boolean
object (OpCon.Api.Data.Entities.ImpEx.WeekDays)
object (OpCon.Api.Data.Entities.ImpEx.StartOffset)
useMasterHoliday
boolean
object (OpCon.Api.Data.Services.Calendars.Calendar)

A calendar with id, type, Schedule, Dates and name fields

conflictsWithOtherDays
boolean
object (OpCon.Api.Data.Entities.ImpEx.AutoBuildSettings)
object (OpCon.Api.Data.Entities.ImpEx.SingleInstanceProperties)
object (OpCon.Api.Data.Entities.ImpEx.MultiInstanceProperties)
object (OpCon.Api.Data.Entities.ImpEx.CrossReference)
object (OpCon.Api.Data.Services.ImpEx.ImpExScheduleDeployInformation)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "documentation": "string",
  • "isMultiInstance": true,
  • "isSubSchedule": true,
  • "containSubSchedule": true,
  • "parent": [
    ],
  • "hasJobLevelFrequencies": true,
  • "weekDays": {
    },
  • "startOffset": {
    },
  • "useMasterHoliday": true,
  • "additionalHolidays": {
    },
  • "conflictsWithOtherDays": true,
  • "autoBuildSettings": {
    },
  • "singleInstanceProperties": {
    },
  • "multiInstanceProperties": {
    },
  • "associations": {
    },
  • "deployInformation": {
    }
}

Response samples

Content type
No sample

Deletes the Master Schedule with the specified Id

Sample request:

DELETE /api/impEx/schedules/1
Authorizations:
Token
path Parameters
id
required
integer <int32>
query Parameters
forceDelete
boolean

Responses

Gets a list of Daily Schedules, Daily Jobs, and Master Jobs referenced by the Master Schedules with the specified Id

Sample request:

GET /api/impEx/schedules/1/crossReferences
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

ImpExCopy

Copies a Master Schedule. If copyJobs is false, the jobs will not be copied. If copySchedulePrivileges is false, only OCADM and All Function Privilege users will be added.

Sample request:

POST /api/impex/schedules/copy/1

{
    "name": "SMAUtility2",
    "copyJobs": true,
    "copySchedulePrivileges": false
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
name
string or null
copyJobs
boolean
copySchedulePrivileges
boolean

Responses

Request samples

Content type
{
  • "name": "string",
  • "copyJobs": true,
  • "copySchedulePrivileges": true
}

Response samples

Content type
No sample

JobActions

Gets a list of responses for the Job Action with the specified Id

Sample request:

GET /api/jobActions/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Submits a new Job Action and returns it with its Id, if successful

Sample request:

POST /api/jobActions
        
{
    "action": "restart",
    "jobs":[
        {
            "id":"20231127|1|1|Utility Folder Log Cleanup",
            "rebuildOnRestartIfContainer":false
        }
    ]
}
Authorizations:
Token
Request Body schema:
id
integer <int32>
action
string or null
reason
string or null
result
string or null
Array of objects or null (OpCon.Api.Data.Entities.JobStatusItem)
expiryTime
string <date-time>

Responses

Request samples

Content type
{
  • "id": 0,
  • "action": "string",
  • "reason": "string",
  • "result": "string",
  • "jobs": [
    ],
  • "expiryTime": "2019-08-24T14:15:22Z"
}

Response samples

Content type
No sample

JobInstanceActions

Gets the Job Instance Action with the specified Id

Sample request:

GET /api/jobInstanceActions/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Submits a Job Instance Action and returns it with its Id, if successful

Sample request:

POST /api/jobInstanceActions
Authorizations:
Token
Request Body schema:
id
integer <int32>
action
string or null
actionType
integer <int32> (OpCon.Api.Data.Entities.Actions.ActionType)
Enum: 0 1 2
result
string or null
message
string or null
Array of objects or null (OpCon.Api.Data.Entities.Actions.JobInstanceActionItem)
expiryTime
string <date-time>
requestIds
Array of integers or null <int64> [ items <int64 > ]
userId
integer <int32>

Responses

Request samples

Content type
{
  • "id": 0,
  • "action": "string",
  • "actionType": 0,
  • "result": "string",
  • "message": "string",
  • "jobInstanceActionItems": [
    ],
  • "expiryTime": "2019-08-24T14:15:22Z",
  • "requestIds": [
    ],
  • "userId": 0
}

Response samples

Content type
No sample

JobSubTypes

Gets a list of Job Sub-types

Sample request

GET /api/jobSubTypes
Authorizations:
Token
query Parameters
PlatformId
integer <int32>

OpCon platform id.

Name
string

Job sub type name. (Search will ignore case and apply wildcard)

Responses

Gets the Job Sub-type with the specified Id

Sample request (this returns a single Job Sub-type with Id = 1):

GET /api/jobSubTypes/1
Authorizations:
Token
path Parameters
jobSubTypeId
required
integer <int32>

Responses

JobTags

Gets a list of Tags based on optional criteria specified

Sample request:

GET api/jobTags?sortBy=name:asc&limit=2&offset=2
Authorizations:
Token
query Parameters
RemoteInstance
string
Name
string

The Tag Name (Can accept ? and * wildcards)

Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

SortOrders
Array of strings
MasterOnly
boolean
SortBy
string

Option to sort Tags by Name in ascending (default) or descending (:desc) order

Responses

Response samples

Content type
No sample

Creates a new Tag and returns it with its details, if successful

Sample request: 

POST /api/jobTags
        
{
    "Name": "TagName""
    "TagAssociations":
    [
        {
            "ScheduleName": "Schedule Name",
            "JobName":      "Job Name",
            "FrequencyName":"Frequency name"
        }
    ]
}
Authorizations:
Token
Request Body schema:
name
string or null

The tag name.

Array of objects or null (OpCon.Api.Data.Services.Tags.TagAssociation)

A list of jobs and frequencies associated with the tag. This property is returned only at api/jobTags/{tagName}.

Responses

Request samples

Content type
{
  • "name": "string",
  • "tagAssociations": [
    ]
}

Response samples

Content type
No sample

Updates the Tag and returns it with its details, if successful

Sample request: 

PUT /api/jobTags
        
{
    "Name": "TagName""
    "TagAssociations":
    [
        {
            "ScheduleName": "Schedule Name",
            "JobName":      "Job Name",
            "FrequencyName":"Frequency name"
        }
    ]
}
Authorizations:
Token
Request Body schema:
name
string or null

The tag name.

Array of objects or null (OpCon.Api.Data.Services.Tags.TagAssociation)

A list of jobs and frequencies associated with the tag. This property is returned only at api/jobTags/{tagName}.

Responses

Request samples

Content type
{
  • "name": "string",
  • "tagAssociations": [
    ]
}

Response samples

Content type
No sample

Gets a list of Tags based on the specified Name

Sample request:

GET /api/jobTags/?name=testTag
Authorizations:
Token
path Parameters
name
required
string

Responses

Response samples

Content type
No sample

Deletes the Tag with the specified Name

Sample request: 

DELETE /api/jobTags/TagName
Authorizations:
Token
path Parameters
name
required
string

Responses

LicenseSupportInfo

Gets license and support information

Sample request:

GET /api/licenseSupportInfo
Authorizations:
Token

Responses

Response samples

Content type
No sample

LicenseTaskCount

Gets a License Task Count based on optional criteria specified

Sample request:

GET /api/licenseTaskCount
Authorizations:
Token
query Parameters
From
string
To
string
JobTypeIds
string
DepartmentIds
string

Responses

Response samples

Content type
No sample

LinuxPlatform

Gets the platform type - either Windows or UNIX

Sample request:

GET api/platform
Authorizations:
Token
query Parameters
FileName
string

The name of the Log

Application
string

The Application associated with the Log

UserId
integer <int32>

The User Id

SessionId
integer <int64>

The Session Id

Size
string

The size of the Log

Archive
boolean

Flag to include Logs within archive folders only

ScheduleBuild
boolean
StartDate
string <date-time>

The Start Date of date range search

EndDate
string <date-time>

The End Date of date range search

SortBy
string

Option to sort Logs separated by a colon

Offset
integer <int32>

Retrieves records beginning at this record number

Limit
integer <int32>

Limits the results being fetched

Responses

Response samples

Content type
No sample

Logs

Archives a Log file

Sample request:

POST /api/logs
Authorizations:
Token
Request Body schema:
sessionId
integer or null <int64>
application
string or null
message
Array of strings or null
id
string or null
fileDir
string or null
fileName
string or null
object (OpCon.Api.Data.Entities.SessionLogUser)
fileSize
integer or null <int64>
fileAge
string or null <date-time>

Responses

Request samples

Content type
{
  • "sessionId": 0,
  • "application": "string",
  • "message": [
    ],
  • "id": "string",
  • "fileDir": "string",
  • "fileName": "string",
  • "user": {
    },
  • "fileSize": 0,
  • "fileAge": "2019-08-24T14:15:22Z"
}

Response samples

Content type
No sample

/api/logs

Authorizations:
Token
query Parameters
FileName
string

The name of the Log

Application
string

The Application associated with the Log

UserId
integer <int32>

The User Id

SessionId
integer <int64>

The Session Id

Size
string

The size of the Log

Archive
boolean

Flag to include Logs within archive folders only

ScheduleBuild
boolean
StartDate
string <date-time>

The Start Date of date range search

EndDate
string <date-time>

The End Date of date range search

SortBy
string

Option to sort Logs separated by a colon

Offset
integer <int32>

Retrieves records beginning at this record number

Limit
integer <int32>

Limits the results being fetched

Responses

/api/logs/download

Authorizations:
Token
query Parameters
filePaths
Array of strings non-empty

Responses

Gets the Log file at the specified file path

Sample request:

GET /api/logs/{filePath}
Authorizations:
Token
path Parameters
filePath
required
string
query Parameters
From
integer <int32>
To
integer <int32>
Tail
integer <int32>

Responses

MachineActions

Gets the Machine Action result for the specified action Id

Sample request:

GET api/machineActions/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Creates a new Machine Action

Sample request:

POST api/machineActions
Authorizations:
Token
Request Body schema:
id
integer <int32>
action
string or null
result
string or null
message
string or null
expiryTime
string <date-time>
requestIds
Array of integers or null <int64> [ items <int64 > ]
userId
integer <int32>
Array of objects or null (OpCon.Api.Data.Entities.Actions.MachineActionItem)

A list of Machine action items

Responses

Request samples

Content type
{
  • "id": 0,
  • "action": "string",
  • "result": "string",
  • "message": "string",
  • "expiryTime": "2019-08-24T14:15:22Z",
  • "requestIds": [
    ],
  • "userId": 0,
  • "machines": [
    ]
}

Response samples

Content type
No sample

MachineGroups

Gets a list of Machine Groups based on optional criteria specified

Sample request:

GET /api/machineGroups?sortBy=name:desc
Authorizations:
Token
query Parameters
IncludeAssignedMasterJobs
boolean

Flag to include a list of Master Jobs to which the Machine Group is assigned

IncludeAssignedDailyJobs
boolean

Flag to include a list of Daily Jobs to which the Machine Group is assigned

MachineGroupNamesOnly
boolean

Flag to return Machine Group Names only

Offset
integer <int32>

Retrieves records beginning at this record number

Limit
integer <int32>

Limits the results being fetched

Name
string

The Machine Group Name (Can accept ? and * wildcards)

Type
string

The Machine Group Type (Can accept ? and * wildcards)

Ids
string

Comma-separated list of Machine Group Ids

TypeIds
string

Comma-separated list of Machine Group Type Ids

IncludeMachines
boolean

Flag to include Machines assigned to the Machine Group

AccessibleMachineGroups
Array of integers <int32> [ items <int32 > ]
SortBy
string

Option to sort Machine Groups by Id, Name or Type in ascending (default) or descending (:desc) order

SortOrders
Array of strings

Responses

Response samples

Content type
No sample

Creates a new Machine Group and return it with its Id, if successful

Sample request

POST /api/machineGroups

{
    "name": "Operator"
}
Authorizations:
Token
Request Body schema:
id
integer or null <int32>
documentation
string or null
name
string or null
object (OpCon.Api.Data.Entities.MachineGroupType)
Array of objects or null (OpCon.Api.Data.Entities.Machine)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceMasterJob)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceDailyJob)
acsApplication
string or null

Responses

Request samples

Content type
{
  • "id": 0,
  • "documentation": "string",
  • "name": "string",
  • "type": {
    },
  • "machines": [
    ],
  • "assignedMasterJobs": [
    ],
  • "assignedDailyJobs": [
    ],
  • "acsApplication": "string"
}

Response samples

Content type
No sample

Gets the Machine Group with the specified Id

Sample request:

GET /api/machineGroups/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Machine Group with the specified Id

Sample request:

PUT /api/machineGroups/1

{
    "id": 1,
    "name": "MachineGroupName"
    "type: {
        "id": 6
    }
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer or null <int32>
documentation
string or null
name
string or null
object (OpCon.Api.Data.Entities.MachineGroupType)
Array of objects or null (OpCon.Api.Data.Entities.Machine)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceMasterJob)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceDailyJob)
acsApplication
string or null

Responses

Request samples

Content type
{
  • "id": 0,
  • "documentation": "string",
  • "name": "string",
  • "type": {
    },
  • "machines": [
    ],
  • "assignedMasterJobs": [
    ],
  • "assignedDailyJobs": [
    ],
  • "acsApplication": "string"
}

Response samples

Content type
No sample

Deletes the Machine Group with the specified Id

Sample request:

DELETE /api/machineGroups/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Machines

Gets a list of Machines based on optional criteria specified

Sample request:

GET /api/machines?sortBy=name:desc
Authorizations:
Token
query Parameters
ResourceName
string
Offset
integer <int32>

Retrieve records beginning at this record number

Limit
integer <int32>

Limits the results being fetched

includeDocumentation
boolean

Flag to include Documentation

IncludeAssignedMasterJobs
boolean

Flag to include a list of Master Jobs to which the Machine is assigned

IncludeAssignedDailyJobs
boolean

Flag to include a list of Daily Jobs to which the Machine is assigned

Ids
string

Comma-separated list of Machine Ids

Name
string

The Machine Name (Can accept ? and * wildcards)

Type
string

The Machine Type (Operating System)

Typeids
string

A comma-separated list of Machine Type Ids

GroupName
string

The Machine Group Name the Machine belongs to

GroupIds
string

A comma-separated list of Machine Group Ids

States
string

A comma-separated list of Machine States

Version
string

The Machine Version

FileTransferRole
string

The Machine File Transfer Role

Sockets
string
Tls
boolean

Flag to include Machines with (true) or without (false) TLS enabled

SortBy
string

Option to sort Machines by Id, Name, Type, Running Jobs, Last Update, State, Socket, Version, or UseTLS

IncludeDetails
boolean

Flag to include Details associated with the Machine

ExcludeNullMachine
boolean
SortOrders
Array of strings
ExtendedProperties
boolean

Flag to include Extended Properties associated with the Machine

Array of objects (OpCon.Api.Data.Errors.ApiError)
Array of objects (OpCon.Api.Data.Entities.AuxillaryProperty)

Responses

Response samples

Content type
No sample

Creates a new Machine

Sample request:

POST /api/machines

{
    "name": "new-machine",
    "socket": 4100,
    "type": {
        "id": 12,
        "description": "UNIX"
    }
}
Authorizations:
Token
Request Body schema:
_acsApplication
string or null

The ACS Integration Application Name

acsApplication
string or null
_acsConfiguration
string or null

The ACS Integration configuration - serialized JSON

acsConfiguration
string or null
_acsStorage
string or null

Arbitrary data used exclusively by the external ACS integration

acsStorage
string or null
_acsConfigVersion
string or null

The self-reported version of the Integration which produced this machine configuration

acsConfigVersion
string or null
_guidewireAgentType
string or null

The Guidewire Agent application type (Claims Center, Billing Center, Policy Center)

guidewireAgentType
string or null
_guidewireAgentBatchProcesses
string or null

The Guidewire batch processes which the Agent supports

guidewireAgentBatchProcesses
string or null
_guidewireAgentClientSecret
string or null

The OAuth Client Secret used to authenticate against the Guidewire API

guidewireAgentClientSecret
string or null
_guidewireAgentOAuthUrl
string or null

The OAuth Authority Server URL used to authenticate against the Guidewire API

guidewireAgentOAuthUrl
string or null
_guidewireAgentOAuthAppId
string or null

The OAuth Application Id used to authenticate against the Guidewire API

guidewireAgentOAuthAppId
string or null
_guidewireAgentOAuthScopes
string or null

The OAuth scopes to be granted within the Guidewire API

guidewireAgentOAuthScopes
string or null
id
integer or null <int32>
name
string or null
currentJobs
integer or null <int32>
gatewayId
integer or null <int32>
Array of objects or null (OpCon.Api.Data.Entities.MachineGroup)
lastUpdateDateTime
string or null
lastUpdate
number or null <double>
maximumJobs
integer or null <int32>
opConMaximumJobs
integer or null <int32>
socket
integer or null <int32>
object (OpCon.Api.Data.Entities.MachineStatus)
object (OpCon.Api.Data.Entities.LsamType)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceMasterJob)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceDailyJob)
acceptMessagesfromIp
string or null
agentAuthToken
string or null
agentCheckCrc
boolean or null
agentFileTransferPortNumberForTls
string or null
agentName
string or null
_agentSmaCommunicationsProtocol
string or null
agentSocket
string or null
agentSpecialFeatures
string or null
agentSupportNonTlsForSmaftAgent
string or null
agentSupportNonTlsForSmaftServer
string or null
agentSupportTlsForSmaftAgent
string or null
agentSupportTlsForSmaftServer
string or null
_allowKillJob
boolean or null
allowKillJob
boolean or null
Array of objects or null (OpCon.Api.Data.Entities.InstanceProperty) [ items ]
_checkCertificateRevocationList
boolean or null
checkCertificateRevocationList
boolean or null
checkCrc
string or null
checkMachineStatusInterval
integer or null <int32>
closeSocket
string or null
closeSocketDuringSynchronization
boolean or null
connectionAttemptTimeout
integer or null <int32>
consecutiveSendSleepTimeMilliseconds
integer or null <int32>
cpuCount
string or null
cpuId
string or null
cpuModel
string or null
cpuType
string or null
documentation
string or null
fileTransferFeature
string or null
fileTransferIpAddress
string or null
_fileTransferPortNumberForNonTls
integer or null <int32>
fileTransferPortNumberForNonTls
integer or null <int32>
_fileTransferPortNumberForTls
integer or null <int32>
fileTransferPortNumberForTls
integer or null <int32>
_fileTransferRole
string or null
fileTransferRole
string or null
fullFileTransferSupport
boolean or null
fullyQualifiedDomainName
string or null
gatewayName
string or null
hostname
string or null
jorsFeature
string or null
_jorsPortNumber
integer or null <int32>
jorsPortNumber
integer or null <int32>
jorsSocket
string or null
lsamTime
number or null <double>
lsamTimeDeltafromSam
integer or null <int32>
machineMaximumJobs
string or null
maxBytesReadPerMessage
integer or null <int32>
maxBytesSentPerMessage
integer or null <int32>
maxConsecutiveSendMessages
integer or null <int32>
noBufferRetryCount
integer or null <int32>
noBufferSleepTime
integer or null <int32>
osType
string or null
osVersion
string or null
pollInterval
integer or null <int32>
receiveBufferCount
integer or null <int32>
_requiresXmlEscape
boolean or null
requiresXmlEscape
boolean or null
resourceMonitorFeature
string or null
responseTimeoutInSeconds
integer or null <int32>
sendBufferCount
integer or null <int32>
smaCommunicationsProtocol
string or null
smaftAgentPort
string or null
smaftServerPortForNonTls
string or null
smaNetComIdentifier
string or null
smaNetComSocket
string or null
supportedAgentCapability
Array of strings or null
_supportNonTlsForSmaftAgent
boolean or null
supportNonTLSForSMAFTAgent
boolean or null
_supportNonTlsForSmaftServer
boolean or null
supportNonTLSForSMAFTServer
boolean or null
_supportTLSForSMAFTAgent
boolean or null
supportTLSForSMAFTAgent
boolean or null
_supportTLSForSMAFTServer
boolean or null
supportTLSForSMAFTServer
boolean or null
supportsHandshake
string or null
tcpIpAddress
string or null
timeOffsetfromSamInHours
number or null <double>
timeOffsetfromUtcInHours
number or null <double>
timeSent
string or null
timeZoneName
string or null
tlsCertificateDistinguishedName
string or null
_tlsCertificateSerialNumber
string or null
tlsCertificateSerialNumber
string or null
traceAllMessages
boolean or null
_useTLSforSchedulingCommunications
boolean or null
useTLSforSchedulingCommunications
boolean or null
agentVersion
string or null
hpNonStopIpAddress
string or null
hpNonStopSocketNumber
integer or null <int32>
_opconMftServerEnabled
boolean or null
opConMFTServerEnabled
boolean or null

Whether or not the MFT Agent (if this machine is one) has the Server functionality enabled.

_opconMftServerEventsWebhook
string or null
opConMFTServerEventsWebhook
string or null

The URI for the MFT Server's web hook (if this machine is an MFT Agent with enabled Server functionality).

_sapBwClientId
integer or null <int32>
sapBwClientId
integer or null <int32>
_sapBwGateway
string or null
sapBwGateway
string or null
_sapBwGroup
string or null
sapBwGroup
string or null
_sapBwName
string or null
sapBwName
string or null
_sapBwQueryListenerPort
integer or null <int32>
sapBwQueryListenerPort
integer or null <int32>
_sapBwSystemNumber
integer or null <int32>
sapBwSystemNumber
integer or null <int32>
_sapBwRfcTrace
integer or null <int32>
sapBwRfcTrace
string or null
_sapR3andCrmAuditLevel
integer or null <int32>
sapR3andCrmAuditLevel
string or null
_sapR3andCrmClientId
integer or null <int32>
sapR3andCrmClientId
integer or null <int32>
_sapEvents
Array of strings or null
sapEvents
Array of strings or null
_sapR3andCrmGateway
string or null
sapR3andCrmGateway
string or null
_sapR3andCrmGroup
string or null
sapR3andCrmGroup
string or null
_sapR3andCrmName
string or null
sapR3andCrmName
string or null
_sapR3andCrmQueryListenerPort
integer or null <int32>
sapR3andCrmQueryListenerPort
integer or null <int32>
_sapR3andCrmSystemNumber
integer or null <int32>
sapR3andCrmSystemNumber
integer or null <int32>
_sapR3andCrmRfcTrace
integer or null <int32>
sapR3andCrmRfcTrace
string or null

Responses

Request samples

Content type
{
  • "_acsApplication": "string",
  • "acsApplication": "string",
  • "_acsConfiguration": "string",
  • "acsConfiguration": "string",
  • "_acsStorage": "string",
  • "acsStorage": "string",
  • "_acsConfigVersion": "string",
  • "acsConfigVersion": "string",
  • "_guidewireAgentType": "string",
  • "guidewireAgentType": "string",
  • "_guidewireAgentBatchProcesses": "string",
  • "guidewireAgentBatchProcesses": "string",
  • "_guidewireAgentClientSecret": "string",
  • "guidewireAgentClientSecret": "string",
  • "_guidewireAgentOAuthUrl": "string",
  • "guidewireAgentOAuthUrl": "string",
  • "_guidewireAgentOAuthAppId": "string",
  • "guidewireAgentOAuthAppId": "string",
  • "_guidewireAgentOAuthScopes": "string",
  • "guidewireAgentOAuthScopes": "string",
  • "id": 0,
  • "name": "string",
  • "currentJobs": 0,
  • "gatewayId": 0,
  • "groups": [
    ],
  • "lastUpdateDateTime": "string",
  • "lastUpdate": 0.1,
  • "maximumJobs": 0,
  • "opConMaximumJobs": 0,
  • "socket": 0,
  • "state": {
    },
  • "type": {
    },
  • "assignedMasterJobs": [
    ],
  • "assignedDailyJobs": [
    ],
  • "acceptMessagesfromIp": "string",
  • "agentAuthToken": "string",
  • "agentCheckCrc": true,
  • "agentFileTransferPortNumberForTls": "string",
  • "agentName": "string",
  • "_agentSmaCommunicationsProtocol": "string",
  • "agentSocket": "string",
  • "agentSpecialFeatures": "string",
  • "agentSupportNonTlsForSmaftAgent": "string",
  • "agentSupportNonTlsForSmaftServer": "string",
  • "agentSupportTlsForSmaftAgent": "string",
  • "agentSupportTlsForSmaftServer": "string",
  • "_allowKillJob": true,
  • "allowKillJob": true,
  • "availableProperties": [
    ],
  • "_checkCertificateRevocationList": true,
  • "checkCertificateRevocationList": true,
  • "checkCrc": "string",
  • "checkMachineStatusInterval": 0,
  • "closeSocket": "string",
  • "closeSocketDuringSynchronization": true,
  • "connectionAttemptTimeout": 0,
  • "consecutiveSendSleepTimeMilliseconds": 0,
  • "cpuCount": "string",
  • "cpuId": "string",
  • "cpuModel": "string",
  • "cpuType": "string",
  • "documentation": "string",
  • "fileTransferFeature": "string",
  • "fileTransferIpAddress": "string",
  • "_fileTransferPortNumberForNonTls": 0,
  • "fileTransferPortNumberForNonTls": 0,
  • "_fileTransferPortNumberForTls": 0,
  • "fileTransferPortNumberForTls": 0,
  • "_fileTransferRole": "string",
  • "fileTransferRole": "string",
  • "fullFileTransferSupport": true,
  • "fullyQualifiedDomainName": "string",
  • "gatewayName": "string",
  • "hostname": "string",
  • "jorsFeature": "string",
  • "_jorsPortNumber": 0,
  • "jorsPortNumber": 0,
  • "jorsSocket": "string",
  • "lsamTime": 0.1,
  • "lsamTimeDeltafromSam": 0,
  • "machineMaximumJobs": "string",
  • "maxBytesReadPerMessage": 0,
  • "maxBytesSentPerMessage": 0,
  • "maxConsecutiveSendMessages": 0,
  • "noBufferRetryCount": 0,
  • "noBufferSleepTime": 0,
  • "osType": "string",
  • "osVersion": "string",
  • "pollInterval": 0,
  • "receiveBufferCount": 0,
  • "_requiresXmlEscape": true,
  • "requiresXmlEscape": true,
  • "resourceMonitorFeature": "string",
  • "responseTimeoutInSeconds": 0,
  • "sendBufferCount": 0,
  • "smaCommunicationsProtocol": "string",
  • "smaftAgentPort": "string",
  • "smaftServerPortForNonTls": "string",
  • "smaNetComIdentifier": "string",
  • "smaNetComSocket": "string",
  • "supportedAgentCapability": [
    ],
  • "_supportNonTlsForSmaftAgent": true,
  • "supportNonTLSForSMAFTAgent": true,
  • "_supportNonTlsForSmaftServer": true,
  • "supportNonTLSForSMAFTServer": true,
  • "_supportTLSForSMAFTAgent": true,
  • "supportTLSForSMAFTAgent": true,
  • "_supportTLSForSMAFTServer": true,
  • "supportTLSForSMAFTServer": true,
  • "supportsHandshake": "string",
  • "tcpIpAddress": "string",
  • "timeOffsetfromSamInHours": 0.1,
  • "timeOffsetfromUtcInHours": 0.1,
  • "timeSent": "string",
  • "timeZoneName": "string",
  • "tlsCertificateDistinguishedName": "string",
  • "_tlsCertificateSerialNumber": "string",
  • "tlsCertificateSerialNumber": "string",
  • "traceAllMessages": true,
  • "_useTLSforSchedulingCommunications": true,
  • "useTLSforSchedulingCommunications": true,
  • "agentVersion": "string",
  • "hpNonStopIpAddress": "string",
  • "hpNonStopSocketNumber": 0,
  • "_opconMftServerEnabled": true,
  • "opConMFTServerEnabled": true,
  • "_opconMftServerEventsWebhook": "string",
  • "opConMFTServerEventsWebhook": "string",
  • "_sapBwClientId": 0,
  • "sapBwClientId": 0,
  • "_sapBwGateway": "string",
  • "sapBwGateway": "string",
  • "_sapBwGroup": "string",
  • "sapBwGroup": "string",
  • "_sapBwName": "string",
  • "sapBwName": "string",
  • "_sapBwQueryListenerPort": 0,
  • "sapBwQueryListenerPort": 0,
  • "_sapBwSystemNumber": 0,
  • "sapBwSystemNumber": 0,
  • "_sapBwRfcTrace": 0,
  • "sapBwRfcTrace": "string",
  • "_sapR3andCrmAuditLevel": 0,
  • "sapR3andCrmAuditLevel": "string",
  • "_sapR3andCrmClientId": 0,
  • "sapR3andCrmClientId": 0,
  • "_sapEvents": [
    ],
  • "sapEvents": [
    ],
  • "_sapR3andCrmGateway": "string",
  • "sapR3andCrmGateway": "string",
  • "_sapR3andCrmGroup": "string",
  • "sapR3andCrmGroup": "string",
  • "_sapR3andCrmName": "string",
  • "sapR3andCrmName": "string",
  • "_sapR3andCrmQueryListenerPort": 0,
  • "sapR3andCrmQueryListenerPort": 0,
  • "_sapR3andCrmSystemNumber": 0,
  • "sapR3andCrmSystemNumber": 0,
  • "_sapR3andCrmRfcTrace": 0,
  • "sapR3andCrmRfcTrace": "string"
}

Response samples

Content type
No sample

Gets a count of Machines based on optional criteria specified and grouped by the following statuses: Up, Down, Error, Waiting, Limited

Sample request: GET /api/machines/count_by_status

Authorizations:
Token
query Parameters
ResourceName
string
Offset
integer <int32>

Retrieve records beginning at this record number

Limit
integer <int32>

Limits the results being fetched

includeDocumentation
boolean

Flag to include Documentation

IncludeAssignedMasterJobs
boolean

Flag to include a list of Master Jobs to which the Machine is assigned

IncludeAssignedDailyJobs
boolean

Flag to include a list of Daily Jobs to which the Machine is assigned

Ids
string

Comma-separated list of Machine Ids

Name
string

The Machine Name (Can accept ? and * wildcards)

Type
string

The Machine Type (Operating System)

Typeids
string

A comma-separated list of Machine Type Ids

GroupName
string

The Machine Group Name the Machine belongs to

GroupIds
string

A comma-separated list of Machine Group Ids

States
string

A comma-separated list of Machine States

Version
string

The Machine Version

FileTransferRole
string

The Machine File Transfer Role

Sockets
string
Tls
boolean

Flag to include Machines with (true) or without (false) TLS enabled

SortBy
string

Option to sort Machines by Id, Name, Type, Running Jobs, Last Update, State, Socket, Version, or UseTLS

IncludeDetails
boolean

Flag to include Details associated with the Machine

ExcludeNullMachine
boolean
SortOrders
Array of strings
ExtendedProperties
boolean

Flag to include Extended Properties associated with the Machine

Array of objects (OpCon.Api.Data.Errors.ApiError)
Array of objects (OpCon.Api.Data.Entities.AuxillaryProperty)

Responses

Response samples

Content type
No sample

Gets a list of Machine Types based on optional criteria specified

Sample request:

GET /api/machines/types
Authorizations:
Token
query Parameters
All
boolean

Flag to indicate if all types should be returned

ForScriptRunnerOnly
boolean

Flag to indicate if only types that are available to run scripts should be returned

ResourceName
string
Array of objects (OpCon.Api.Data.Errors.ApiError)
Array of objects (OpCon.Api.Data.Entities.AuxillaryProperty)

Responses

Response samples

Content type
No sample

Gets the Instance Properties for the Machine with the specified machine Id

Sample request: GET /api/machines/1/properties

Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Creates a new Instance Property for the Machine with the specified Id

Sample request:

POST /api/machines/1/properties

{
    "key": "property2",
    "value": "value2",
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
key
string or null
value
string or null

Responses

Request samples

Content type
{
  • "key": "string",
  • "value": "string"
}

Response samples

Content type
No sample

Gets the Instance Property with the specified property Name for the Machine with the specified id

Sample request:

GET /api/machines/1/properties/property1
Authorizations:
Token
path Parameters
id
required
integer <int32>
name
required
string

Responses

Response samples

Content type
No sample

Deletes the Instance Property with the specified property Name for the Machine with the specified machine Id

Sample request:

DELETE /api/machines/1/properties/property1
Authorizations:
Token
path Parameters
id
required
integer <int32>
name
required
string

Responses

Updates the Instance Property with the specified property Name for the Machine having the specified machine Id

Sample request:

PUT /api/machines/1/properties/property1

{
    "key": "property21,
    "value": "new-value",
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
name
required
string
Request Body schema:
key
string or null
value
string or null

Responses

Request samples

Content type
{
  • "key": "string",
  • "value": "string"
}

Response samples

Content type
No sample

Gets the Machine with the specified Id

Sample request:

GET /api/machines/3
Authorizations:
Token
path Parameters
machineId
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Machine with the specified Id

Sample request:

PUT /api/machines/1

{
    "id": 1,
    "name": "updated-machine",
    "socket": 4100,
    "type": {
        "id": 12,
        "description": "UNIX"
    }
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
_acsApplication
string or null

The ACS Integration Application Name

acsApplication
string or null
_acsConfiguration
string or null

The ACS Integration configuration - serialized JSON

acsConfiguration
string or null
_acsStorage
string or null

Arbitrary data used exclusively by the external ACS integration

acsStorage
string or null
_acsConfigVersion
string or null

The self-reported version of the Integration which produced this machine configuration

acsConfigVersion
string or null
_guidewireAgentType
string or null

The Guidewire Agent application type (Claims Center, Billing Center, Policy Center)

guidewireAgentType
string or null
_guidewireAgentBatchProcesses
string or null

The Guidewire batch processes which the Agent supports

guidewireAgentBatchProcesses
string or null
_guidewireAgentClientSecret
string or null

The OAuth Client Secret used to authenticate against the Guidewire API

guidewireAgentClientSecret
string or null
_guidewireAgentOAuthUrl
string or null

The OAuth Authority Server URL used to authenticate against the Guidewire API

guidewireAgentOAuthUrl
string or null
_guidewireAgentOAuthAppId
string or null

The OAuth Application Id used to authenticate against the Guidewire API

guidewireAgentOAuthAppId
string or null
_guidewireAgentOAuthScopes
string or null

The OAuth scopes to be granted within the Guidewire API

guidewireAgentOAuthScopes
string or null
id
integer or null <int32>
name
string or null
currentJobs
integer or null <int32>
gatewayId
integer or null <int32>
Array of objects or null (OpCon.Api.Data.Entities.MachineGroup)
lastUpdateDateTime
string or null
lastUpdate
number or null <double>
maximumJobs
integer or null <int32>
opConMaximumJobs
integer or null <int32>
socket
integer or null <int32>
object (OpCon.Api.Data.Entities.MachineStatus)
object (OpCon.Api.Data.Entities.LsamType)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceMasterJob)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceDailyJob)
acceptMessagesfromIp
string or null
agentAuthToken
string or null
agentCheckCrc
boolean or null
agentFileTransferPortNumberForTls
string or null
agentName
string or null
_agentSmaCommunicationsProtocol
string or null
agentSocket
string or null
agentSpecialFeatures
string or null
agentSupportNonTlsForSmaftAgent
string or null
agentSupportNonTlsForSmaftServer
string or null
agentSupportTlsForSmaftAgent
string or null
agentSupportTlsForSmaftServer
string or null
_allowKillJob
boolean or null
allowKillJob
boolean or null
Array of objects or null (OpCon.Api.Data.Entities.InstanceProperty) [ items ]
_checkCertificateRevocationList
boolean or null
checkCertificateRevocationList
boolean or null
checkCrc
string or null
checkMachineStatusInterval
integer or null <int32>
closeSocket
string or null
closeSocketDuringSynchronization
boolean or null
connectionAttemptTimeout
integer or null <int32>
consecutiveSendSleepTimeMilliseconds
integer or null <int32>
cpuCount
string or null
cpuId
string or null
cpuModel
string or null
cpuType
string or null
documentation
string or null
fileTransferFeature
string or null
fileTransferIpAddress
string or null
_fileTransferPortNumberForNonTls
integer or null <int32>
fileTransferPortNumberForNonTls
integer or null <int32>
_fileTransferPortNumberForTls
integer or null <int32>
fileTransferPortNumberForTls
integer or null <int32>
_fileTransferRole
string or null
fileTransferRole
string or null
fullFileTransferSupport
boolean or null
fullyQualifiedDomainName
string or null
gatewayName
string or null
hostname
string or null
jorsFeature
string or null
_jorsPortNumber
integer or null <int32>
jorsPortNumber
integer or null <int32>
jorsSocket
string or null
lsamTime
number or null <double>
lsamTimeDeltafromSam
integer or null <int32>
machineMaximumJobs
string or null
maxBytesReadPerMessage
integer or null <int32>
maxBytesSentPerMessage
integer or null <int32>
maxConsecutiveSendMessages
integer or null <int32>
noBufferRetryCount
integer or null <int32>
noBufferSleepTime
integer or null <int32>
osType
string or null
osVersion
string or null
pollInterval
integer or null <int32>
receiveBufferCount
integer or null <int32>
_requiresXmlEscape
boolean or null
requiresXmlEscape
boolean or null
resourceMonitorFeature
string or null
responseTimeoutInSeconds
integer or null <int32>
sendBufferCount
integer or null <int32>
smaCommunicationsProtocol
string or null
smaftAgentPort
string or null
smaftServerPortForNonTls
string or null
smaNetComIdentifier
string or null
smaNetComSocket
string or null
supportedAgentCapability
Array of strings or null
_supportNonTlsForSmaftAgent
boolean or null
supportNonTLSForSMAFTAgent
boolean or null
_supportNonTlsForSmaftServer
boolean or null
supportNonTLSForSMAFTServer
boolean or null
_supportTLSForSMAFTAgent
boolean or null
supportTLSForSMAFTAgent
boolean or null
_supportTLSForSMAFTServer
boolean or null
supportTLSForSMAFTServer
boolean or null
supportsHandshake
string or null
tcpIpAddress
string or null
timeOffsetfromSamInHours
number or null <double>
timeOffsetfromUtcInHours
number or null <double>
timeSent
string or null
timeZoneName
string or null
tlsCertificateDistinguishedName
string or null
_tlsCertificateSerialNumber
string or null
tlsCertificateSerialNumber
string or null
traceAllMessages
boolean or null
_useTLSforSchedulingCommunications
boolean or null
useTLSforSchedulingCommunications
boolean or null
agentVersion
string or null
hpNonStopIpAddress
string or null
hpNonStopSocketNumber
integer or null <int32>
_opconMftServerEnabled
boolean or null
opConMFTServerEnabled
boolean or null

Whether or not the MFT Agent (if this machine is one) has the Server functionality enabled.

_opconMftServerEventsWebhook
string or null
opConMFTServerEventsWebhook
string or null

The URI for the MFT Server's web hook (if this machine is an MFT Agent with enabled Server functionality).

_sapBwClientId
integer or null <int32>
sapBwClientId
integer or null <int32>
_sapBwGateway
string or null
sapBwGateway
string or null
_sapBwGroup
string or null
sapBwGroup
string or null
_sapBwName
string or null
sapBwName
string or null
_sapBwQueryListenerPort
integer or null <int32>
sapBwQueryListenerPort
integer or null <int32>
_sapBwSystemNumber
integer or null <int32>
sapBwSystemNumber
integer or null <int32>
_sapBwRfcTrace
integer or null <int32>
sapBwRfcTrace
string or null
_sapR3andCrmAuditLevel
integer or null <int32>
sapR3andCrmAuditLevel
string or null
_sapR3andCrmClientId
integer or null <int32>
sapR3andCrmClientId
integer or null <int32>
_sapEvents
Array of strings or null
sapEvents
Array of strings or null
_sapR3andCrmGateway
string or null
sapR3andCrmGateway
string or null
_sapR3andCrmGroup
string or null
sapR3andCrmGroup
string or null
_sapR3andCrmName
string or null
sapR3andCrmName
string or null
_sapR3andCrmQueryListenerPort
integer or null <int32>
sapR3andCrmQueryListenerPort
integer or null <int32>
_sapR3andCrmSystemNumber
integer or null <int32>
sapR3andCrmSystemNumber
integer or null <int32>
_sapR3andCrmRfcTrace
integer or null <int32>
sapR3andCrmRfcTrace
string or null

Responses

Request samples

Content type
{
  • "_acsApplication": "string",
  • "acsApplication": "string",
  • "_acsConfiguration": "string",
  • "acsConfiguration": "string",
  • "_acsStorage": "string",
  • "acsStorage": "string",
  • "_acsConfigVersion": "string",
  • "acsConfigVersion": "string",
  • "_guidewireAgentType": "string",
  • "guidewireAgentType": "string",
  • "_guidewireAgentBatchProcesses": "string",
  • "guidewireAgentBatchProcesses": "string",
  • "_guidewireAgentClientSecret": "string",
  • "guidewireAgentClientSecret": "string",
  • "_guidewireAgentOAuthUrl": "string",
  • "guidewireAgentOAuthUrl": "string",
  • "_guidewireAgentOAuthAppId": "string",
  • "guidewireAgentOAuthAppId": "string",
  • "_guidewireAgentOAuthScopes": "string",
  • "guidewireAgentOAuthScopes": "string",
  • "id": 0,
  • "name": "string",
  • "currentJobs": 0,
  • "gatewayId": 0,
  • "groups": [
    ],
  • "lastUpdateDateTime": "string",
  • "lastUpdate": 0.1,
  • "maximumJobs": 0,
  • "opConMaximumJobs": 0,
  • "socket": 0,
  • "state": {
    },
  • "type": {
    },
  • "assignedMasterJobs": [
    ],
  • "assignedDailyJobs": [
    ],
  • "acceptMessagesfromIp": "string",
  • "agentAuthToken": "string",
  • "agentCheckCrc": true,
  • "agentFileTransferPortNumberForTls": "string",
  • "agentName": "string",
  • "_agentSmaCommunicationsProtocol": "string",
  • "agentSocket": "string",
  • "agentSpecialFeatures": "string",
  • "agentSupportNonTlsForSmaftAgent": "string",
  • "agentSupportNonTlsForSmaftServer": "string",
  • "agentSupportTlsForSmaftAgent": "string",
  • "agentSupportTlsForSmaftServer": "string",
  • "_allowKillJob": true,
  • "allowKillJob": true,
  • "availableProperties": [
    ],
  • "_checkCertificateRevocationList": true,
  • "checkCertificateRevocationList": true,
  • "checkCrc": "string",
  • "checkMachineStatusInterval": 0,
  • "closeSocket": "string",
  • "closeSocketDuringSynchronization": true,
  • "connectionAttemptTimeout": 0,
  • "consecutiveSendSleepTimeMilliseconds": 0,
  • "cpuCount": "string",
  • "cpuId": "string",
  • "cpuModel": "string",
  • "cpuType": "string",
  • "documentation": "string",
  • "fileTransferFeature": "string",
  • "fileTransferIpAddress": "string",
  • "_fileTransferPortNumberForNonTls": 0,
  • "fileTransferPortNumberForNonTls": 0,
  • "_fileTransferPortNumberForTls": 0,
  • "fileTransferPortNumberForTls": 0,
  • "_fileTransferRole": "string",
  • "fileTransferRole": "string",
  • "fullFileTransferSupport": true,
  • "fullyQualifiedDomainName": "string",
  • "gatewayName": "string",
  • "hostname": "string",
  • "jorsFeature": "string",
  • "_jorsPortNumber": 0,
  • "jorsPortNumber": 0,
  • "jorsSocket": "string",
  • "lsamTime": 0.1,
  • "lsamTimeDeltafromSam": 0,
  • "machineMaximumJobs": "string",
  • "maxBytesReadPerMessage": 0,
  • "maxBytesSentPerMessage": 0,
  • "maxConsecutiveSendMessages": 0,
  • "noBufferRetryCount": 0,
  • "noBufferSleepTime": 0,
  • "osType": "string",
  • "osVersion": "string",
  • "pollInterval": 0,
  • "receiveBufferCount": 0,
  • "_requiresXmlEscape": true,
  • "requiresXmlEscape": true,
  • "resourceMonitorFeature": "string",
  • "responseTimeoutInSeconds": 0,
  • "sendBufferCount": 0,
  • "smaCommunicationsProtocol": "string",
  • "smaftAgentPort": "string",
  • "smaftServerPortForNonTls": "string",
  • "smaNetComIdentifier": "string",
  • "smaNetComSocket": "string",
  • "supportedAgentCapability": [
    ],
  • "_supportNonTlsForSmaftAgent": true,
  • "supportNonTLSForSMAFTAgent": true,
  • "_supportNonTlsForSmaftServer": true,
  • "supportNonTLSForSMAFTServer": true,
  • "_supportTLSForSMAFTAgent": true,
  • "supportTLSForSMAFTAgent": true,
  • "_supportTLSForSMAFTServer": true,
  • "supportTLSForSMAFTServer": true,
  • "supportsHandshake": "string",
  • "tcpIpAddress": "string",
  • "timeOffsetfromSamInHours": 0.1,
  • "timeOffsetfromUtcInHours": 0.1,
  • "timeSent": "string",
  • "timeZoneName": "string",
  • "tlsCertificateDistinguishedName": "string",
  • "_tlsCertificateSerialNumber": "string",
  • "tlsCertificateSerialNumber": "string",
  • "traceAllMessages": true,
  • "_useTLSforSchedulingCommunications": true,
  • "useTLSforSchedulingCommunications": true,
  • "agentVersion": "string",
  • "hpNonStopIpAddress": "string",
  • "hpNonStopSocketNumber": 0,
  • "_opconMftServerEnabled": true,
  • "opConMFTServerEnabled": true,
  • "_opconMftServerEventsWebhook": "string",
  • "opConMFTServerEventsWebhook": "string",
  • "_sapBwClientId": 0,
  • "sapBwClientId": 0,
  • "_sapBwGateway": "string",
  • "sapBwGateway": "string",
  • "_sapBwGroup": "string",
  • "sapBwGroup": "string",
  • "_sapBwName": "string",
  • "sapBwName": "string",
  • "_sapBwQueryListenerPort": 0,
  • "sapBwQueryListenerPort": 0,
  • "_sapBwSystemNumber": 0,
  • "sapBwSystemNumber": 0,
  • "_sapBwRfcTrace": 0,
  • "sapBwRfcTrace": "string",
  • "_sapR3andCrmAuditLevel": 0,
  • "sapR3andCrmAuditLevel": "string",
  • "_sapR3andCrmClientId": 0,
  • "sapR3andCrmClientId": 0,
  • "_sapEvents": [
    ],
  • "sapEvents": [
    ],
  • "_sapR3andCrmGateway": "string",
  • "sapR3andCrmGateway": "string",
  • "_sapR3andCrmGroup": "string",
  • "sapR3andCrmGroup": "string",
  • "_sapR3andCrmName": "string",
  • "sapR3andCrmName": "string",
  • "_sapR3andCrmQueryListenerPort": 0,
  • "sapR3andCrmQueryListenerPort": 0,
  • "_sapR3andCrmSystemNumber": 0,
  • "sapR3andCrmSystemNumber": 0,
  • "_sapR3andCrmRfcTrace": 0,
  • "sapR3andCrmRfcTrace": "string"
}

Response samples

Content type
No sample

Deletes the Machine with the specified Id

Sample request:

DELETE /api/machines/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Re-synchronizes running jobs on the Machine with the specified Id

Sample request:

POST /api/syncRunningJobs

{
"machine": {
    "id": 1
}
Authorizations:
Token
Request Body schema:
object (OpCon.Api.Data.Entities.MachineToSync)
runningJobsCount
integer <int32>

Responses

Request samples

Content type
{
  • "machine": {
    },
  • "runningJobsCount": 0
}

Response samples

Content type
No sample

Maintenance

Gets the Status of the API service

Sample request:

GET /api/serviceStatus
Authorizations:
Token

Responses

Response samples

Content type
No sample

MasterInstances

Gets the Master Instance based on optional criteria specified

Sample request:

GET /api/masterInstances
Authorizations:
Token
query Parameters
Ids
string

Comma-separated list of Master Instance Ids

Responses

Response samples

Content type
No sample

Creates a Master Instance

Sample request:

POST /api/masterInstances
        
{
    "tags": [
        "tag1",
        "tag2"
    ]
}
Authorizations:
Token
Request Body schema:
id
integer <int32>

The Master Instance Id

tags
Array of strings or null

A list of Tags

Responses

Request samples

Content type
{
  • "id": 0,
  • "tags": [
    ]
}

Response samples

Content type
No sample

Gets the Master Instance with the specified Id

Sample request:

GET /api/masterInstances/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Master Instance with the specified Id

Sample request:

PUT /api/masterInstances/1
        
{
    "tags": [
        "tag1"
    ]
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer <int32>

The Master Instance Id

tags
Array of strings or null

A list of Tags

Responses

Request samples

Content type
{
  • "id": 0,
  • "tags": [
    ]
}

Response samples

Content type
No sample

MasterJobs

Deletes the Master Job with the specified Id

Sample request:

DELETE /api/masterJobs/v2/1|Audit History Purge
Authorizations:
Token
path Parameters
required
object (OpCon.Api.Data.Models.MasterJobKey)

Responses

Gets a list of Master Jobs based on optional criteria specified

Sample request:

GET /api/masterJobs/v2?sortBy=jobName
Authorizations:
Token
query Parameters
object (OpCon.Api.Data.Models.MasterJobKey)

Job key in the format ScheduleId|JobName

SelectedIds
string

List of job ids (1|job, etc)

ScheduleId
integer <int32>

The Schedule Id

ScheduleName
string

The Schedule Name (Can accept ? and * wildcards)

JobName
string

The Job Name (Can accept ? and * wildcards)

JobTypeId
integer <int32>

The Job Type Id (-1, 3, 6, etc.)

JobTypeName
string

The Job Type Name

IncludeDetails
boolean

Flag to include all Master Job details

IncludeCount
boolean

Flag to include total count of accessible Master Jobs

IncludeCrossReferences
boolean

Flag to include a list of Master Jobs dependent on the Master Job

Limit
integer <int32> [ 0 .. 2147483647 ]

Limits the results being fetched

Offset
integer <int32> [ 0 .. 2147483647 ]

Retrieves records beginning at this record number

SortBy
string

Option to sort Master Jobs by ScheduleName, JobName, JobTypeId or JobId (default) in ascending (default) or descending (:desc) order

IgnoreCase
boolean

Flag to use case-insensitive search criteria

ACSApplication
string

In the case where JobTypeId is equal to the ACS JobTypeId, use this application to limit results

Responses

Response samples

Content type
No sample

Creates a new Master Job and returns the new job Id, if successful

Sample request:

POST /api/masterJobs/v2
        
{
    "name": "job",
    "jobType": {
        "id": -1,
    },
    "schedule: {
        "id": 1
    },
    "accessCode": {
        "id": 1
    },
    "department": {
        "id": 1
    },
    "machineSelection": {
        "machineSelectionType": "None",
        "machineGroupId": 0,
        "machineIds": {
            "primary": 0,
            "alt1": 0,
            "alt2": 0,
            "alt3": 0
    },
    "isMultiInstance": false,
    "disableBuild": false
}
Authorizations:
Token
Request Body schema:
object (OpCon.Api.Data.Services.AccessCodes.Models.AccessCode)

An access code with id and name fields

object (OpCon.Api.Data.Services.Departments.Models.Department)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceMasterJob)

List of cross-references

details
any or null

Job details

disableBuild
boolean

Flag to indicate if job build is disabled

object (OpCon.Api.Data.Services.MasterJobs.MasterJobsDocumentation)
Array of objects or null (OpCon.Api.Data.Services.MasterJobs.MasterJobsEvent)

List of events

object (OpCon.Api.Data.Services.MasterJobs.MasterJobsExpressionDependency)
Array of objects or null (OpCon.Api.Data.Services.MasterJobs.MasterJobFrequency)

List of frequencies

frequencyType
string (OpCon.Api.Data.Services.MasterJobs.FrequencyTypes)
Enum: "Unknown" "Inherited" "Defined"
id
string or null

Job id in the format ScheduleId|JobName

isMultiInstance
boolean

Flag to indicate if job is multi-instance

Array of objects or null (OpCon.Api.Data.Services.MasterJobs.MasterJobsDependency)

List of job dependencies

object (OpCon.Api.Data.Entities.LsamType)
object (OpCon.Api.Data.Services.MasterJobs.MasterJobsMachineSelection)
name
string or null

Job name

Array of objects or null (OpCon.Api.Data.Entities.InstanceProperty) [ items ]

List of instance property sets

object (OpCon.Api.Data.Entities.MasterSchedule)
object (OpCon.Api.Data.Services.MasterJobs.MasterJobsTag)
Array of objects or null (OpCon.Api.Data.Services.MasterJobs.MasterJobsThresholdResourceDependency)

List of threshold and resource dependencies

Array of objects or null (OpCon.Api.Data.Services.MasterJobs.MasterJobsThresholdResourceUpdate)

List of threshold and resource updates

Array of objects or null (OpCon.Api.Data.Entities.MasterJobProperty)

Used by the MasterJobV2Builder to store JMASTER_AUX values

Responses

Request samples

Content type
{
  • "accessCode": {
    },
  • "department": {
    },
  • "dependentMasterJobs": [
    ],
  • "details": null,
  • "disableBuild": true,
  • "documentation": {
    },
  • "events": [
    ],
  • "expressionDependencies": {
    },
  • "frequencies": [
    ],
  • "frequencyType": "Unknown",
  • "id": "string",
  • "isMultiInstance": true,
  • "jobDependencies": [
    ],
  • "jobType": {
    },
  • "machineSelection": {
    },
  • "name": "string",
  • "properties": [
    ],
  • "schedule": {
    },
  • "tags": {
    },
  • "thresholdResourceDependencies": [
    ],
  • "thresholdResourceUpdates": [
    ],
  • "auxProperties": [
    ]
}

Response samples

Content type
No sample

Get the Master Job having the specified Id

Sample request:

GET /api/masterJobs/v2/1|Audit History Purge
Authorizations:
Token
path Parameters
required
object (OpCon.Api.Data.Models.MasterJobKey)

Responses

Response samples

Content type
No sample

Updates the Master Job with the specified Id

Sample request:

PUT /api/masterJobs/v2/3|job1
        
{
    "id": "3|job1",
    "name": "job1-updated",
    "jobType": {
    "id": -1
    },
    "schedule": {
    "id": 3,
    "name": "skd",
    "subSchedule": false
    },
    "accessCode": {
    "id": 0
    },
    "department": {
    "id": 1
    },
    "machineSelection": {
    "machineSelectionType": "None",
    "machineGroupId": 0,
    "machineIds": {
        "primary": 0,
        "alt1": 0,
        "alt2": 0,
        "alt3": 0
    }
    },
    "isMultiInstance": false,
    "disableBuild": false
 }
Authorizations:
Token
path Parameters
required
object (OpCon.Api.Data.Models.MasterJobKey)
Request Body schema:
object (OpCon.Api.Data.Services.AccessCodes.Models.AccessCode)

An access code with id and name fields

object (OpCon.Api.Data.Services.Departments.Models.Department)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceMasterJob)

List of cross-references

details
any or null

Job details

disableBuild
boolean

Flag to indicate if job build is disabled

object (OpCon.Api.Data.Services.MasterJobs.MasterJobsDocumentation)
Array of objects or null (OpCon.Api.Data.Services.MasterJobs.MasterJobsEvent)

List of events

object (OpCon.Api.Data.Services.MasterJobs.MasterJobsExpressionDependency)
Array of objects or null (OpCon.Api.Data.Services.MasterJobs.MasterJobFrequency)

List of frequencies

frequencyType
string (OpCon.Api.Data.Services.MasterJobs.FrequencyTypes)
Enum: "Unknown" "Inherited" "Defined"
id
string or null

Job id in the format ScheduleId|JobName

isMultiInstance
boolean

Flag to indicate if job is multi-instance

Array of objects or null (OpCon.Api.Data.Services.MasterJobs.MasterJobsDependency)

List of job dependencies

object (OpCon.Api.Data.Entities.LsamType)
object (OpCon.Api.Data.Services.MasterJobs.MasterJobsMachineSelection)
name
string or null

Job name

Array of objects or null (OpCon.Api.Data.Entities.InstanceProperty) [ items ]

List of instance property sets

object (OpCon.Api.Data.Entities.MasterSchedule)
object (OpCon.Api.Data.Services.MasterJobs.MasterJobsTag)
Array of objects or null (OpCon.Api.Data.Services.MasterJobs.MasterJobsThresholdResourceDependency)

List of threshold and resource dependencies

Array of objects or null (OpCon.Api.Data.Services.MasterJobs.MasterJobsThresholdResourceUpdate)

List of threshold and resource updates

Array of objects or null (OpCon.Api.Data.Entities.MasterJobProperty)

Used by the MasterJobV2Builder to store JMASTER_AUX values

Responses

Request samples

Content type
{
  • "accessCode": {
    },
  • "department": {
    },
  • "dependentMasterJobs": [
    ],
  • "details": null,
  • "disableBuild": true,
  • "documentation": {
    },
  • "events": [
    ],
  • "expressionDependencies": {
    },
  • "frequencies": [
    ],
  • "frequencyType": "Unknown",
  • "id": "string",
  • "isMultiInstance": true,
  • "jobDependencies": [
    ],
  • "jobType": {
    },
  • "machineSelection": {
    },
  • "name": "string",
  • "properties": [
    ],
  • "schedule": {
    },
  • "tags": {
    },
  • "thresholdResourceDependencies": [
    ],
  • "thresholdResourceUpdates": [
    ],
  • "auxProperties": [
    ]
}

Copies an existing Master Job to a new Master Job and returns the new job Id, if successful

Sample request:

POST /api/masterJobs/v2/copy
{
    "id": "1|job",
    "name": "job-copy",
    "schedule: {
        "id": 1,
        "name": "SMAUtility"
    }
}
Authorizations:
Token
Request Body schema:
id
required
string non-empty

The source job id.

name
required
string non-empty

The target job name.

required
object (SMAOpConRestApi.Controllers.Models.MasterJobs.CopyMasterJobMasterSchedule)

Responses

Request samples

Content type
{
  • "id": "string",
  • "name": "string",
  • "schedule": {
    }
}

Response samples

Content type
No sample

Moves an existing Master Job to another Master Schedule and returns the new job Id, if successful

Sample request:

POST /api/masterJobs/v2/move/3|Null Job

{
    "name": "Null Job",
    "schedule: {
        "id": 1,
        "name": "SMAUtility"
    },
}
Authorizations:
Token
path Parameters
required
object (OpCon.Api.Data.Models.MasterJobKey)
Request Body schema:
name
required
string non-empty

The destination job name. Must be the same as the source job name in the url.

required
object (SMAOpConRestApi.Controllers.Models.MasterJobs.MoveMasterJobMasterSchedule)

Responses

Request samples

Content type
{
  • "name": "string",
  • "schedule": {
    }
}

Response samples

Content type
No sample

Resets the Job Type of an existing Master Job to Null and returns the updated job, if successful

Sample request:

PUT /api/masterJobs/v2/reset/1|Audit History Purge
Authorizations:
Token
path Parameters
required
object (OpCon.Api.Data.Models.MasterJobKey)

Responses

Response samples

Content type
No sample

Legacy method, no longer supported

Authorizations:
Token
path Parameters
rawId
required
string

Responses

Legacy method, no longer supported

Authorizations:
Token
query Parameters
Ids
string
ScheduleIds
string
JobIds
string
TagList
Array of strings
LimitValue
integer <int32>
OffsetValue
integer <int32>
ScheduleName
string
JobName
string
FrequencyName
string
SortOrders
Array of strings
JobType
string
DepartmentList
Array of integers <int32> [ items <int32 > ]
AccessCodeList
Array of integers <int32> [ items <int32 > ]
Name
string
SortBy
string
AccessCodes
string
Limit
string
Offset
string
Tags
string
Departments
string

Responses

Legacy method, no longer supported

Authorizations:
Token
query Parameters
Ids
string
ScheduleIds
string
JobIds
string
TagList
Array of strings
LimitValue
integer <int32>
OffsetValue
integer <int32>
ScheduleName
string
JobName
string
FrequencyName
string
SortOrders
Array of strings
JobType
string
DepartmentList
Array of integers <int32> [ items <int32 > ]
AccessCodeList
Array of integers <int32> [ items <int32 > ]
Name
string
SortBy
string
AccessCodes
string
Limit
string
Offset
string
Tags
string
Departments
string

Responses

MasterSchedules

Gets a list of Master Schedules based on optional criteria specified

Sample request:

GET /api/masterSchedules?name=SMA*
Authorizations:
Token
query Parameters
Name
string

The Master Schedule Name

Ids
string

A comma-separated list of Master Schedule Ids

Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

SortOrders
Array of strings
CheckSubSchedule
boolean

Flag to include a list of each Master Schedule's Sub-Schedules

SubSchedule
boolean

Flag to include/exclude Sub-Schedules only

MultiInstance
boolean

Flag to include/exclude Multi-Instance Master Schedules only

AutoBuild
boolean

Flag to include/exclude Auto-Build Master Schedules only

IncludeDetails
boolean

Flag to include all Master Schedule properties

IgnoreCase
boolean

Flag to indicate a case-insensitive search

BasicDetails
boolean

Gets the basic details of a Master Schedule

Sortby
string

Responses

Response samples

Content type
No sample

Gets the Master Schedule with the specified Id

Sample request:

GET /api/masterSchedules/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Gets a count of the Master Schedule based on the optional criteria specified

Sample request:

GET /api/masterSchedules/count?name=SMA*
Authorizations:
Token
query Parameters
Name
string

The Master Schedule Name

Ids
string

A comma-separated list of Master Schedule Ids

Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

SortOrders
Array of strings
CheckSubSchedule
boolean

Flag to include a list of each Master Schedule's Sub-Schedules

SubSchedule
boolean

Flag to include/exclude Sub-Schedules only

MultiInstance
boolean

Flag to include/exclude Multi-Instance Master Schedules only

AutoBuild
boolean

Flag to include/exclude Auto-Build Master Schedules only

IncludeDetails
boolean

Flag to include all Master Schedule properties

IgnoreCase
boolean

Flag to indicate a case-insensitive search

BasicDetails
boolean

Gets the basic details of a Master Schedule

Sortby
string

Responses

Response samples

Content type
No sample

Gets a list of workflow nodes for the Master Schedule with the specified Id

Sample request:

GET /api/masterSchedules/1/workflow
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Creates a new list of workflow nodes for the Master Schedule with the specified Id

Sample request:

POST /api/masterSchedules/1/workflow

{
     "nodes": [
        {
            "nodeType": "Job",
            "nodeId": 1,
            "scheduleName": "WorkflowSchedule",
            "id": 6001,
            "name": "JavaJob1",
            "coordinates": {
                "x": 300.0,
                "y": 110.0
         
            "details": {}
        },
        {
            "nodeType": "Resource",
            "nodeId": 2,    
            "id": 1,
            "name": "Resource1"
         },
    ]
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
locationSaved
boolean
Array of objects or null (OpCon.Api.Data.Services.Workflow.Models.WorkflowNode)
Array of objects or null (OpCon.Api.Data.Services.Workflow.Models.WorkflowEdge)

Responses

Request samples

Content type
{
  • "locationSaved": true,
  • "nodes": [
    ],
  • "edges": [
    ]
}

Response samples

Content type
No sample

Updates the workflow nodes based on the node type and name for the Master Schedule with the specified Id

Sample request (this updates the workflow node of type 'Job', with the name 'Job1' on Schedule with id 1):

PUT /api/masterSchedules/1/workflow

{
    "nodeType": "Job",
    "nodeId": 2,
    "scheduleName": "WorkflowSchedule",
    "id": 6001,
    "name": "Job1",
    "coordinates": {
        "x": 300.0,
        "y": 110.0
        "details": {}
    }
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
nodeType
string (OpCon.Api.Data.Services.Workflow.Models.WorkflowNodeType)
Enum: "Null" "Job" "Threshold" "Resource" "Expression" "JobNameLike"
nodeId
integer <int32>
scheduleName
string or null
id
integer <int32>
name
string or null
object (OpCon.Api.Data.Services.Workflow.Models.WorkflowNodeCoordinates)
object (OpCon.Api.Data.Services.Workflow.Models.WorkflowNodeDetails)

Responses

Request samples

Content type
{
  • "nodeType": "Null",
  • "nodeId": 0,
  • "scheduleName": "string",
  • "id": 0,
  • "name": "string",
  • "coordinates": {
    },
  • "details": {
    }
}

Response samples

Content type
No sample

MasterVisionWorkspaces

Gets a list of Master Vision Workspaces based on optional criteria specified

Sample request:

GET /api/masterVisionWorkspaces?name=SMA
Authorizations:
Token
query Parameters
Ids
string

Comma-separated list of Master Vision Workspace Ids

Name
string

The Master Vision Workspace Name (Can accept ? and * wildcards)

Responses

Response samples

Content type
No sample

Creates a new Master Vision Workspace and returns it with its Id, if successful

Sample request:

POST /api/masterVisionWorkspaces
        
{
    "name": "workspace2",
    "description": "The second workspace"
}
Authorizations:
Token
Request Body schema:
id
integer <int32>

The Master Vision Workspace Id

name
string or null

The Master Vision Workspace Name

description
string or null

The Master Vision Workspace Description

Array of objects or null (OpCon.Api.Data.Entities.MasterVisionCard)

A list of Master Vision Cards

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "masterVisionCards": [
    ]
}

Response samples

Content type
No sample

Gets the Master Vision Workspaces with the specified Id

Sample request:

GET /api/masterVisionWorkspaces/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Master Vision Workspace and returns it with its Id, if successful

Sample request:

PUT /api/masterVisionWorkspaces
        
{
    "name": "workspace2",
    "description": "The second workspace updated"
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer <int32>

The Master Vision Workspace Id

name
string or null

The Master Vision Workspace Name

description
string or null

The Master Vision Workspace Description

Array of objects or null (OpCon.Api.Data.Entities.MasterVisionCard)

A list of Master Vision Cards

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "masterVisionCards": [
    ]
}

Response samples

Content type
No sample

MftMachines

Gets a list of endpoints available on the MFT Agent with the specified Id

Sample request:

GET /api/machines/mft/1/endpoints
Authorizations:
Token
path Parameters
mftId
required
integer <int32>

Responses

Response samples

Content type
No sample

Gets the private PGP signing keys available to the MFT Agent with the specified Id

Sample request:

GET /api/machines/mft/1/pgpSigningKeys
Authorizations:
Token
path Parameters
mftId
required
integer <int32>

Responses

Response samples

Content type
No sample

Gets the public PGP encrypting keys available to the MFT Agent with the specified Id

Sample request:

GET /api/machines/mft/1/pgpEncryptingKeys
Authorizations:
Token
path Parameters
mftId
required
integer <int32>

Responses

Response samples

Content type
No sample

Attempts to update the authorization token OpCon uses to communicate with an OpConMFT Agent

Sample request:

POST /api/machines/mft/1/refreshBearerAuthToken
Authorizations:
Token
path Parameters
mftId
required
integer <int32>

Responses

Registers the Webhook for the OpCon MFT Agent with the specified Id

Sample request:

POST /api/machines/mft/1/registerWebhook
Authorizations:
Token
path Parameters
mftId
required
integer <int32>
query Parameters
url
string

Responses

Response samples

Content type
No sample

Gets a list of Machines based on optional criteria specified

Sample request:

GET /api/machines?sortBy=name:desc
Authorizations:
Token
query Parameters
ResourceName
string
Offset
integer <int32>

Retrieve records beginning at this record number

Limit
integer <int32>

Limits the results being fetched

includeDocumentation
boolean

Flag to include Documentation

IncludeAssignedMasterJobs
boolean

Flag to include a list of Master Jobs to which the Machine is assigned

IncludeAssignedDailyJobs
boolean

Flag to include a list of Daily Jobs to which the Machine is assigned

Ids
string

Comma-separated list of Machine Ids

Name
string

The Machine Name (Can accept ? and * wildcards)

Type
string

The Machine Type (Operating System)

Typeids
string

A comma-separated list of Machine Type Ids

GroupName
string

The Machine Group Name the Machine belongs to

GroupIds
string

A comma-separated list of Machine Group Ids

States
string

A comma-separated list of Machine States

Version
string

The Machine Version

FileTransferRole
string

The Machine File Transfer Role

Sockets
string
Tls
boolean

Flag to include Machines with (true) or without (false) TLS enabled

SortBy
string

Option to sort Machines by Id, Name, Type, Running Jobs, Last Update, State, Socket, Version, or UseTLS

IncludeDetails
boolean

Flag to include Details associated with the Machine

ExcludeNullMachine
boolean
SortOrders
Array of strings
ExtendedProperties
boolean

Flag to include Extended Properties associated with the Machine

Array of objects (OpCon.Api.Data.Errors.ApiError)
Array of objects (OpCon.Api.Data.Entities.AuxillaryProperty)

Responses

Response samples

Content type
No sample

Creates a new Machine

Sample request:

POST /api/machines

{
    "name": "new-machine",
    "socket": 4100,
    "type": {
        "id": 12,
        "description": "UNIX"
    }
}
Authorizations:
Token
Request Body schema:
_acsApplication
string or null

The ACS Integration Application Name

acsApplication
string or null
_acsConfiguration
string or null

The ACS Integration configuration - serialized JSON

acsConfiguration
string or null
_acsStorage
string or null

Arbitrary data used exclusively by the external ACS integration

acsStorage
string or null
_acsConfigVersion
string or null

The self-reported version of the Integration which produced this machine configuration

acsConfigVersion
string or null
_guidewireAgentType
string or null

The Guidewire Agent application type (Claims Center, Billing Center, Policy Center)

guidewireAgentType
string or null
_guidewireAgentBatchProcesses
string or null

The Guidewire batch processes which the Agent supports

guidewireAgentBatchProcesses
string or null
_guidewireAgentClientSecret
string or null

The OAuth Client Secret used to authenticate against the Guidewire API

guidewireAgentClientSecret
string or null
_guidewireAgentOAuthUrl
string or null

The OAuth Authority Server URL used to authenticate against the Guidewire API

guidewireAgentOAuthUrl
string or null
_guidewireAgentOAuthAppId
string or null

The OAuth Application Id used to authenticate against the Guidewire API

guidewireAgentOAuthAppId
string or null
_guidewireAgentOAuthScopes
string or null

The OAuth scopes to be granted within the Guidewire API

guidewireAgentOAuthScopes
string or null
id
integer or null <int32>
name
string or null
currentJobs
integer or null <int32>
gatewayId
integer or null <int32>
Array of objects or null (OpCon.Api.Data.Entities.MachineGroup)
lastUpdateDateTime
string or null
lastUpdate
number or null <double>
maximumJobs
integer or null <int32>
opConMaximumJobs
integer or null <int32>
socket
integer or null <int32>
object (OpCon.Api.Data.Entities.MachineStatus)
object (OpCon.Api.Data.Entities.LsamType)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceMasterJob)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceDailyJob)
acceptMessagesfromIp
string or null
agentAuthToken
string or null
agentCheckCrc
boolean or null
agentFileTransferPortNumberForTls
string or null
agentName
string or null
_agentSmaCommunicationsProtocol
string or null
agentSocket
string or null
agentSpecialFeatures
string or null
agentSupportNonTlsForSmaftAgent
string or null
agentSupportNonTlsForSmaftServer
string or null
agentSupportTlsForSmaftAgent
string or null
agentSupportTlsForSmaftServer
string or null
_allowKillJob
boolean or null
allowKillJob
boolean or null
Array of objects or null (OpCon.Api.Data.Entities.InstanceProperty) [ items ]
_checkCertificateRevocationList
boolean or null
checkCertificateRevocationList
boolean or null
checkCrc
string or null
checkMachineStatusInterval
integer or null <int32>
closeSocket
string or null
closeSocketDuringSynchronization
boolean or null
connectionAttemptTimeout
integer or null <int32>
consecutiveSendSleepTimeMilliseconds
integer or null <int32>
cpuCount
string or null
cpuId
string or null
cpuModel
string or null
cpuType
string or null
documentation
string or null
fileTransferFeature
string or null
fileTransferIpAddress
string or null
_fileTransferPortNumberForNonTls
integer or null <int32>
fileTransferPortNumberForNonTls
integer or null <int32>
_fileTransferPortNumberForTls
integer or null <int32>
fileTransferPortNumberForTls
integer or null <int32>
_fileTransferRole
string or null
fileTransferRole
string or null
fullFileTransferSupport
boolean or null
fullyQualifiedDomainName
string or null
gatewayName
string or null
hostname
string or null
jorsFeature
string or null
_jorsPortNumber
integer or null <int32>
jorsPortNumber
integer or null <int32>
jorsSocket
string or null
lsamTime
number or null <double>
lsamTimeDeltafromSam
integer or null <int32>
machineMaximumJobs
string or null
maxBytesReadPerMessage
integer or null <int32>
maxBytesSentPerMessage
integer or null <int32>
maxConsecutiveSendMessages
integer or null <int32>
noBufferRetryCount
integer or null <int32>
noBufferSleepTime
integer or null <int32>
osType
string or null
osVersion
string or null
pollInterval
integer or null <int32>
receiveBufferCount
integer or null <int32>
_requiresXmlEscape
boolean or null
requiresXmlEscape
boolean or null
resourceMonitorFeature
string or null
responseTimeoutInSeconds
integer or null <int32>
sendBufferCount
integer or null <int32>
smaCommunicationsProtocol
string or null
smaftAgentPort
string or null
smaftServerPortForNonTls
string or null
smaNetComIdentifier
string or null
smaNetComSocket
string or null
supportedAgentCapability
Array of strings or null
_supportNonTlsForSmaftAgent
boolean or null
supportNonTLSForSMAFTAgent
boolean or null
_supportNonTlsForSmaftServer
boolean or null
supportNonTLSForSMAFTServer
boolean or null
_supportTLSForSMAFTAgent
boolean or null
supportTLSForSMAFTAgent
boolean or null
_supportTLSForSMAFTServer
boolean or null
supportTLSForSMAFTServer
boolean or null
supportsHandshake
string or null
tcpIpAddress
string or null
timeOffsetfromSamInHours
number or null <double>
timeOffsetfromUtcInHours
number or null <double>
timeSent
string or null
timeZoneName
string or null
tlsCertificateDistinguishedName
string or null
_tlsCertificateSerialNumber
string or null
tlsCertificateSerialNumber
string or null
traceAllMessages
boolean or null
_useTLSforSchedulingCommunications
boolean or null
useTLSforSchedulingCommunications
boolean or null
agentVersion
string or null
hpNonStopIpAddress
string or null
hpNonStopSocketNumber
integer or null <int32>
_opconMftServerEnabled
boolean or null
opConMFTServerEnabled
boolean or null

Whether or not the MFT Agent (if this machine is one) has the Server functionality enabled.

_opconMftServerEventsWebhook
string or null
opConMFTServerEventsWebhook
string or null

The URI for the MFT Server's web hook (if this machine is an MFT Agent with enabled Server functionality).

_sapBwClientId
integer or null <int32>
sapBwClientId
integer or null <int32>
_sapBwGateway
string or null
sapBwGateway
string or null
_sapBwGroup
string or null
sapBwGroup
string or null
_sapBwName
string or null
sapBwName
string or null
_sapBwQueryListenerPort
integer or null <int32>
sapBwQueryListenerPort
integer or null <int32>
_sapBwSystemNumber
integer or null <int32>
sapBwSystemNumber
integer or null <int32>
_sapBwRfcTrace
integer or null <int32>
sapBwRfcTrace
string or null
_sapR3andCrmAuditLevel
integer or null <int32>
sapR3andCrmAuditLevel
string or null
_sapR3andCrmClientId
integer or null <int32>
sapR3andCrmClientId
integer or null <int32>
_sapEvents
Array of strings or null
sapEvents
Array of strings or null
_sapR3andCrmGateway
string or null
sapR3andCrmGateway
string or null
_sapR3andCrmGroup
string or null
sapR3andCrmGroup
string or null
_sapR3andCrmName
string or null
sapR3andCrmName
string or null
_sapR3andCrmQueryListenerPort
integer or null <int32>
sapR3andCrmQueryListenerPort
integer or null <int32>
_sapR3andCrmSystemNumber
integer or null <int32>
sapR3andCrmSystemNumber
integer or null <int32>
_sapR3andCrmRfcTrace
integer or null <int32>
sapR3andCrmRfcTrace
string or null

Responses

Request samples

Content type
{
  • "_acsApplication": "string",
  • "acsApplication": "string",
  • "_acsConfiguration": "string",
  • "acsConfiguration": "string",
  • "_acsStorage": "string",
  • "acsStorage": "string",
  • "_acsConfigVersion": "string",
  • "acsConfigVersion": "string",
  • "_guidewireAgentType": "string",
  • "guidewireAgentType": "string",
  • "_guidewireAgentBatchProcesses": "string",
  • "guidewireAgentBatchProcesses": "string",
  • "_guidewireAgentClientSecret": "string",
  • "guidewireAgentClientSecret": "string",
  • "_guidewireAgentOAuthUrl": "string",
  • "guidewireAgentOAuthUrl": "string",
  • "_guidewireAgentOAuthAppId": "string",
  • "guidewireAgentOAuthAppId": "string",
  • "_guidewireAgentOAuthScopes": "string",
  • "guidewireAgentOAuthScopes": "string",
  • "id": 0,
  • "name": "string",
  • "currentJobs": 0,
  • "gatewayId": 0,
  • "groups": [
    ],
  • "lastUpdateDateTime": "string",
  • "lastUpdate": 0.1,
  • "maximumJobs": 0,
  • "opConMaximumJobs": 0,
  • "socket": 0,
  • "state": {
    },
  • "type": {
    },
  • "assignedMasterJobs": [
    ],
  • "assignedDailyJobs": [
    ],
  • "acceptMessagesfromIp": "string",
  • "agentAuthToken": "string",
  • "agentCheckCrc": true,
  • "agentFileTransferPortNumberForTls": "string",
  • "agentName": "string",
  • "_agentSmaCommunicationsProtocol": "string",
  • "agentSocket": "string",
  • "agentSpecialFeatures": "string",
  • "agentSupportNonTlsForSmaftAgent": "string",
  • "agentSupportNonTlsForSmaftServer": "string",
  • "agentSupportTlsForSmaftAgent": "string",
  • "agentSupportTlsForSmaftServer": "string",
  • "_allowKillJob": true,
  • "allowKillJob": true,
  • "availableProperties": [
    ],
  • "_checkCertificateRevocationList": true,
  • "checkCertificateRevocationList": true,
  • "checkCrc": "string",
  • "checkMachineStatusInterval": 0,
  • "closeSocket": "string",
  • "closeSocketDuringSynchronization": true,
  • "connectionAttemptTimeout": 0,
  • "consecutiveSendSleepTimeMilliseconds": 0,
  • "cpuCount": "string",
  • "cpuId": "string",
  • "cpuModel": "string",
  • "cpuType": "string",
  • "documentation": "string",
  • "fileTransferFeature": "string",
  • "fileTransferIpAddress": "string",
  • "_fileTransferPortNumberForNonTls": 0,
  • "fileTransferPortNumberForNonTls": 0,
  • "_fileTransferPortNumberForTls": 0,
  • "fileTransferPortNumberForTls": 0,
  • "_fileTransferRole": "string",
  • "fileTransferRole": "string",
  • "fullFileTransferSupport": true,
  • "fullyQualifiedDomainName": "string",
  • "gatewayName": "string",
  • "hostname": "string",
  • "jorsFeature": "string",
  • "_jorsPortNumber": 0,
  • "jorsPortNumber": 0,
  • "jorsSocket": "string",
  • "lsamTime": 0.1,
  • "lsamTimeDeltafromSam": 0,
  • "machineMaximumJobs": "string",
  • "maxBytesReadPerMessage": 0,
  • "maxBytesSentPerMessage": 0,
  • "maxConsecutiveSendMessages": 0,
  • "noBufferRetryCount": 0,
  • "noBufferSleepTime": 0,
  • "osType": "string",
  • "osVersion": "string",
  • "pollInterval": 0,
  • "receiveBufferCount": 0,
  • "_requiresXmlEscape": true,
  • "requiresXmlEscape": true,
  • "resourceMonitorFeature": "string",
  • "responseTimeoutInSeconds": 0,
  • "sendBufferCount": 0,
  • "smaCommunicationsProtocol": "string",
  • "smaftAgentPort": "string",
  • "smaftServerPortForNonTls": "string",
  • "smaNetComIdentifier": "string",
  • "smaNetComSocket": "string",
  • "supportedAgentCapability": [
    ],
  • "_supportNonTlsForSmaftAgent": true,
  • "supportNonTLSForSMAFTAgent": true,
  • "_supportNonTlsForSmaftServer": true,
  • "supportNonTLSForSMAFTServer": true,
  • "_supportTLSForSMAFTAgent": true,
  • "supportTLSForSMAFTAgent": true,
  • "_supportTLSForSMAFTServer": true,
  • "supportTLSForSMAFTServer": true,
  • "supportsHandshake": "string",
  • "tcpIpAddress": "string",
  • "timeOffsetfromSamInHours": 0.1,
  • "timeOffsetfromUtcInHours": 0.1,
  • "timeSent": "string",
  • "timeZoneName": "string",
  • "tlsCertificateDistinguishedName": "string",
  • "_tlsCertificateSerialNumber": "string",
  • "tlsCertificateSerialNumber": "string",
  • "traceAllMessages": true,
  • "_useTLSforSchedulingCommunications": true,
  • "useTLSforSchedulingCommunications": true,
  • "agentVersion": "string",
  • "hpNonStopIpAddress": "string",
  • "hpNonStopSocketNumber": 0,
  • "_opconMftServerEnabled": true,
  • "opConMFTServerEnabled": true,
  • "_opconMftServerEventsWebhook": "string",
  • "opConMFTServerEventsWebhook": "string",
  • "_sapBwClientId": 0,
  • "sapBwClientId": 0,
  • "_sapBwGateway": "string",
  • "sapBwGateway": "string",
  • "_sapBwGroup": "string",
  • "sapBwGroup": "string",
  • "_sapBwName": "string",
  • "sapBwName": "string",
  • "_sapBwQueryListenerPort": 0,
  • "sapBwQueryListenerPort": 0,
  • "_sapBwSystemNumber": 0,
  • "sapBwSystemNumber": 0,
  • "_sapBwRfcTrace": 0,
  • "sapBwRfcTrace": "string",
  • "_sapR3andCrmAuditLevel": 0,
  • "sapR3andCrmAuditLevel": "string",
  • "_sapR3andCrmClientId": 0,
  • "sapR3andCrmClientId": 0,
  • "_sapEvents": [
    ],
  • "sapEvents": [
    ],
  • "_sapR3andCrmGateway": "string",
  • "sapR3andCrmGateway": "string",
  • "_sapR3andCrmGroup": "string",
  • "sapR3andCrmGroup": "string",
  • "_sapR3andCrmName": "string",
  • "sapR3andCrmName": "string",
  • "_sapR3andCrmQueryListenerPort": 0,
  • "sapR3andCrmQueryListenerPort": 0,
  • "_sapR3andCrmSystemNumber": 0,
  • "sapR3andCrmSystemNumber": 0,
  • "_sapR3andCrmRfcTrace": 0,
  • "sapR3andCrmRfcTrace": "string"
}

Response samples

Content type
No sample

Gets a count of Machines based on optional criteria specified and grouped by the following statuses: Up, Down, Error, Waiting, Limited

Sample request: GET /api/machines/count_by_status

Authorizations:
Token
query Parameters
ResourceName
string
Offset
integer <int32>

Retrieve records beginning at this record number

Limit
integer <int32>

Limits the results being fetched

includeDocumentation
boolean

Flag to include Documentation

IncludeAssignedMasterJobs
boolean

Flag to include a list of Master Jobs to which the Machine is assigned

IncludeAssignedDailyJobs
boolean

Flag to include a list of Daily Jobs to which the Machine is assigned

Ids
string

Comma-separated list of Machine Ids

Name
string

The Machine Name (Can accept ? and * wildcards)

Type
string

The Machine Type (Operating System)

Typeids
string

A comma-separated list of Machine Type Ids

GroupName
string

The Machine Group Name the Machine belongs to

GroupIds
string

A comma-separated list of Machine Group Ids

States
string

A comma-separated list of Machine States

Version
string

The Machine Version

FileTransferRole
string

The Machine File Transfer Role

Sockets
string
Tls
boolean

Flag to include Machines with (true) or without (false) TLS enabled

SortBy
string

Option to sort Machines by Id, Name, Type, Running Jobs, Last Update, State, Socket, Version, or UseTLS

IncludeDetails
boolean

Flag to include Details associated with the Machine

ExcludeNullMachine
boolean
SortOrders
Array of strings
ExtendedProperties
boolean

Flag to include Extended Properties associated with the Machine

Array of objects (OpCon.Api.Data.Errors.ApiError)
Array of objects (OpCon.Api.Data.Entities.AuxillaryProperty)

Responses

Response samples

Content type
No sample

Gets a list of Machine Types based on optional criteria specified

Sample request:

GET /api/machines/types
Authorizations:
Token
query Parameters
All
boolean

Flag to indicate if all types should be returned

ForScriptRunnerOnly
boolean

Flag to indicate if only types that are available to run scripts should be returned

ResourceName
string
Array of objects (OpCon.Api.Data.Errors.ApiError)
Array of objects (OpCon.Api.Data.Entities.AuxillaryProperty)

Responses

Response samples

Content type
No sample

Gets the Instance Properties for the Machine with the specified machine Id

Sample request: GET /api/machines/1/properties

Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Creates a new Instance Property for the Machine with the specified Id

Sample request:

POST /api/machines/1/properties

{
    "key": "property2",
    "value": "value2",
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
key
string or null
value
string or null

Responses

Request samples

Content type
{
  • "key": "string",
  • "value": "string"
}

Response samples

Content type
No sample

Gets the Instance Property with the specified property Name for the Machine with the specified id

Sample request:

GET /api/machines/1/properties/property1
Authorizations:
Token
path Parameters
id
required
integer <int32>
name
required
string

Responses

Response samples

Content type
No sample

Deletes the Instance Property with the specified property Name for the Machine with the specified machine Id

Sample request:

DELETE /api/machines/1/properties/property1
Authorizations:
Token
path Parameters
id
required
integer <int32>
name
required
string

Responses

Updates the Instance Property with the specified property Name for the Machine having the specified machine Id

Sample request:

PUT /api/machines/1/properties/property1

{
    "key": "property21,
    "value": "new-value",
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
name
required
string
Request Body schema:
key
string or null
value
string or null

Responses

Request samples

Content type
{
  • "key": "string",
  • "value": "string"
}

Response samples

Content type
No sample

Gets the Machine with the specified Id

Sample request:

GET /api/machines/3
Authorizations:
Token
path Parameters
machineId
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Machine with the specified Id

Sample request:

PUT /api/machines/1

{
    "id": 1,
    "name": "updated-machine",
    "socket": 4100,
    "type": {
        "id": 12,
        "description": "UNIX"
    }
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
_acsApplication
string or null

The ACS Integration Application Name

acsApplication
string or null
_acsConfiguration
string or null

The ACS Integration configuration - serialized JSON

acsConfiguration
string or null
_acsStorage
string or null

Arbitrary data used exclusively by the external ACS integration

acsStorage
string or null
_acsConfigVersion
string or null

The self-reported version of the Integration which produced this machine configuration

acsConfigVersion
string or null
_guidewireAgentType
string or null

The Guidewire Agent application type (Claims Center, Billing Center, Policy Center)

guidewireAgentType
string or null
_guidewireAgentBatchProcesses
string or null

The Guidewire batch processes which the Agent supports

guidewireAgentBatchProcesses
string or null
_guidewireAgentClientSecret
string or null

The OAuth Client Secret used to authenticate against the Guidewire API

guidewireAgentClientSecret
string or null
_guidewireAgentOAuthUrl
string or null

The OAuth Authority Server URL used to authenticate against the Guidewire API

guidewireAgentOAuthUrl
string or null
_guidewireAgentOAuthAppId
string or null

The OAuth Application Id used to authenticate against the Guidewire API

guidewireAgentOAuthAppId
string or null
_guidewireAgentOAuthScopes
string or null

The OAuth scopes to be granted within the Guidewire API

guidewireAgentOAuthScopes
string or null
id
integer or null <int32>
name
string or null
currentJobs
integer or null <int32>
gatewayId
integer or null <int32>
Array of objects or null (OpCon.Api.Data.Entities.MachineGroup)
lastUpdateDateTime
string or null
lastUpdate
number or null <double>
maximumJobs
integer or null <int32>
opConMaximumJobs
integer or null <int32>
socket
integer or null <int32>
object (OpCon.Api.Data.Entities.MachineStatus)
object (OpCon.Api.Data.Entities.LsamType)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceMasterJob)
Array of objects or null (OpCon.Api.Data.Entities.CrossReference.CrossReferenceDailyJob)
acceptMessagesfromIp
string or null
agentAuthToken
string or null
agentCheckCrc
boolean or null
agentFileTransferPortNumberForTls
string or null
agentName
string or null
_agentSmaCommunicationsProtocol
string or null
agentSocket
string or null
agentSpecialFeatures
string or null
agentSupportNonTlsForSmaftAgent
string or null
agentSupportNonTlsForSmaftServer
string or null
agentSupportTlsForSmaftAgent
string or null
agentSupportTlsForSmaftServer
string or null
_allowKillJob
boolean or null
allowKillJob
boolean or null
Array of objects or null (OpCon.Api.Data.Entities.InstanceProperty) [ items ]
_checkCertificateRevocationList
boolean or null
checkCertificateRevocationList
boolean or null
checkCrc
string or null
checkMachineStatusInterval
integer or null <int32>
closeSocket
string or null
closeSocketDuringSynchronization
boolean or null
connectionAttemptTimeout
integer or null <int32>
consecutiveSendSleepTimeMilliseconds
integer or null <int32>
cpuCount
string or null
cpuId
string or null
cpuModel
string or null
cpuType
string or null
documentation
string or null
fileTransferFeature
string or null
fileTransferIpAddress
string or null
_fileTransferPortNumberForNonTls
integer or null <int32>
fileTransferPortNumberForNonTls
integer or null <int32>
_fileTransferPortNumberForTls
integer or null <int32>
fileTransferPortNumberForTls
integer or null <int32>
_fileTransferRole
string or null
fileTransferRole
string or null
fullFileTransferSupport
boolean or null
fullyQualifiedDomainName
string or null
gatewayName
string or null
hostname
string or null
jorsFeature
string or null
_jorsPortNumber
integer or null <int32>
jorsPortNumber
integer or null <int32>
jorsSocket
string or null
lsamTime
number or null <double>
lsamTimeDeltafromSam
integer or null <int32>
machineMaximumJobs
string or null
maxBytesReadPerMessage
integer or null <int32>
maxBytesSentPerMessage
integer or null <int32>
maxConsecutiveSendMessages
integer or null <int32>
noBufferRetryCount
integer or null <int32>
noBufferSleepTime
integer or null <int32>
osType
string or null
osVersion
string or null
pollInterval
integer or null <int32>
receiveBufferCount
integer or null <int32>
_requiresXmlEscape
boolean or null
requiresXmlEscape
boolean or null
resourceMonitorFeature
string or null
responseTimeoutInSeconds
integer or null <int32>
sendBufferCount
integer or null <int32>
smaCommunicationsProtocol
string or null
smaftAgentPort
string or null
smaftServerPortForNonTls
string or null
smaNetComIdentifier
string or null
smaNetComSocket
string or null
supportedAgentCapability
Array of strings or null
_supportNonTlsForSmaftAgent
boolean or null
supportNonTLSForSMAFTAgent
boolean or null
_supportNonTlsForSmaftServer
boolean or null
supportNonTLSForSMAFTServer
boolean or null
_supportTLSForSMAFTAgent
boolean or null
supportTLSForSMAFTAgent
boolean or null
_supportTLSForSMAFTServer
boolean or null
supportTLSForSMAFTServer
boolean or null
supportsHandshake
string or null
tcpIpAddress
string or null
timeOffsetfromSamInHours
number or null <double>
timeOffsetfromUtcInHours
number or null <double>
timeSent
string or null
timeZoneName
string or null
tlsCertificateDistinguishedName
string or null
_tlsCertificateSerialNumber
string or null
tlsCertificateSerialNumber
string or null
traceAllMessages
boolean or null
_useTLSforSchedulingCommunications
boolean or null
useTLSforSchedulingCommunications
boolean or null
agentVersion
string or null
hpNonStopIpAddress
string or null
hpNonStopSocketNumber
integer or null <int32>
_opconMftServerEnabled
boolean or null
opConMFTServerEnabled
boolean or null

Whether or not the MFT Agent (if this machine is one) has the Server functionality enabled.

_opconMftServerEventsWebhook
string or null
opConMFTServerEventsWebhook
string or null

The URI for the MFT Server's web hook (if this machine is an MFT Agent with enabled Server functionality).

_sapBwClientId
integer or null <int32>
sapBwClientId
integer or null <int32>
_sapBwGateway
string or null
sapBwGateway
string or null
_sapBwGroup
string or null
sapBwGroup
string or null
_sapBwName
string or null
sapBwName
string or null
_sapBwQueryListenerPort
integer or null <int32>
sapBwQueryListenerPort
integer or null <int32>
_sapBwSystemNumber
integer or null <int32>
sapBwSystemNumber
integer or null <int32>
_sapBwRfcTrace
integer or null <int32>
sapBwRfcTrace
string or null
_sapR3andCrmAuditLevel
integer or null <int32>
sapR3andCrmAuditLevel
string or null
_sapR3andCrmClientId
integer or null <int32>
sapR3andCrmClientId
integer or null <int32>
_sapEvents
Array of strings or null
sapEvents
Array of strings or null
_sapR3andCrmGateway
string or null
sapR3andCrmGateway
string or null
_sapR3andCrmGroup
string or null
sapR3andCrmGroup
string or null
_sapR3andCrmName
string or null
sapR3andCrmName
string or null
_sapR3andCrmQueryListenerPort
integer or null <int32>
sapR3andCrmQueryListenerPort
integer or null <int32>
_sapR3andCrmSystemNumber
integer or null <int32>
sapR3andCrmSystemNumber
integer or null <int32>
_sapR3andCrmRfcTrace
integer or null <int32>
sapR3andCrmRfcTrace
string or null

Responses

Request samples

Content type
{
  • "_acsApplication": "string",
  • "acsApplication": "string",
  • "_acsConfiguration": "string",
  • "acsConfiguration": "string",
  • "_acsStorage": "string",
  • "acsStorage": "string",
  • "_acsConfigVersion": "string",
  • "acsConfigVersion": "string",
  • "_guidewireAgentType": "string",
  • "guidewireAgentType": "string",
  • "_guidewireAgentBatchProcesses": "string",
  • "guidewireAgentBatchProcesses": "string",
  • "_guidewireAgentClientSecret": "string",
  • "guidewireAgentClientSecret": "string",
  • "_guidewireAgentOAuthUrl": "string",
  • "guidewireAgentOAuthUrl": "string",
  • "_guidewireAgentOAuthAppId": "string",
  • "guidewireAgentOAuthAppId": "string",
  • "_guidewireAgentOAuthScopes": "string",
  • "guidewireAgentOAuthScopes": "string",
  • "id": 0,
  • "name": "string",
  • "currentJobs": 0,
  • "gatewayId": 0,
  • "groups": [
    ],
  • "lastUpdateDateTime": "string",
  • "lastUpdate": 0.1,
  • "maximumJobs": 0,
  • "opConMaximumJobs": 0,
  • "socket": 0,
  • "state": {
    },
  • "type": {
    },
  • "assignedMasterJobs": [
    ],
  • "assignedDailyJobs": [
    ],
  • "acceptMessagesfromIp": "string",
  • "agentAuthToken": "string",
  • "agentCheckCrc": true,
  • "agentFileTransferPortNumberForTls": "string",
  • "agentName": "string",
  • "_agentSmaCommunicationsProtocol": "string",
  • "agentSocket": "string",
  • "agentSpecialFeatures": "string",
  • "agentSupportNonTlsForSmaftAgent": "string",
  • "agentSupportNonTlsForSmaftServer": "string",
  • "agentSupportTlsForSmaftAgent": "string",
  • "agentSupportTlsForSmaftServer": "string",
  • "_allowKillJob": true,
  • "allowKillJob": true,
  • "availableProperties": [
    ],
  • "_checkCertificateRevocationList": true,
  • "checkCertificateRevocationList": true,
  • "checkCrc": "string",
  • "checkMachineStatusInterval": 0,
  • "closeSocket": "string",
  • "closeSocketDuringSynchronization": true,
  • "connectionAttemptTimeout": 0,
  • "consecutiveSendSleepTimeMilliseconds": 0,
  • "cpuCount": "string",
  • "cpuId": "string",
  • "cpuModel": "string",
  • "cpuType": "string",
  • "documentation": "string",
  • "fileTransferFeature": "string",
  • "fileTransferIpAddress": "string",
  • "_fileTransferPortNumberForNonTls": 0,
  • "fileTransferPortNumberForNonTls": 0,
  • "_fileTransferPortNumberForTls": 0,
  • "fileTransferPortNumberForTls": 0,
  • "_fileTransferRole": "string",
  • "fileTransferRole": "string",
  • "fullFileTransferSupport": true,
  • "fullyQualifiedDomainName": "string",
  • "gatewayName": "string",
  • "hostname": "string",
  • "jorsFeature": "string",
  • "_jorsPortNumber": 0,
  • "jorsPortNumber": 0,
  • "jorsSocket": "string",
  • "lsamTime": 0.1,
  • "lsamTimeDeltafromSam": 0,
  • "machineMaximumJobs": "string",
  • "maxBytesReadPerMessage": 0,
  • "maxBytesSentPerMessage": 0,
  • "maxConsecutiveSendMessages": 0,
  • "noBufferRetryCount": 0,
  • "noBufferSleepTime": 0,
  • "osType": "string",
  • "osVersion": "string",
  • "pollInterval": 0,
  • "receiveBufferCount": 0,
  • "_requiresXmlEscape": true,
  • "requiresXmlEscape": true,
  • "resourceMonitorFeature": "string",
  • "responseTimeoutInSeconds": 0,
  • "sendBufferCount": 0,
  • "smaCommunicationsProtocol": "string",
  • "smaftAgentPort": "string",
  • "smaftServerPortForNonTls": "string",
  • "smaNetComIdentifier": "string",
  • "smaNetComSocket": "string",
  • "supportedAgentCapability": [
    ],
  • "_supportNonTlsForSmaftAgent": true,
  • "supportNonTLSForSMAFTAgent": true,
  • "_supportNonTlsForSmaftServer": true,
  • "supportNonTLSForSMAFTServer": true,
  • "_supportTLSForSMAFTAgent": true,
  • "supportTLSForSMAFTAgent": true,
  • "_supportTLSForSMAFTServer": true,
  • "supportTLSForSMAFTServer": true,
  • "supportsHandshake": "string",
  • "tcpIpAddress": "string",
  • "timeOffsetfromSamInHours": 0.1,
  • "timeOffsetfromUtcInHours": 0.1,
  • "timeSent": "string",
  • "timeZoneName": "string",
  • "tlsCertificateDistinguishedName": "string",
  • "_tlsCertificateSerialNumber": "string",
  • "tlsCertificateSerialNumber": "string",
  • "traceAllMessages": true,
  • "_useTLSforSchedulingCommunications": true,
  • "useTLSforSchedulingCommunications": true,
  • "agentVersion": "string",
  • "hpNonStopIpAddress": "string",
  • "hpNonStopSocketNumber": 0,
  • "_opconMftServerEnabled": true,
  • "opConMFTServerEnabled": true,
  • "_opconMftServerEventsWebhook": "string",
  • "opConMFTServerEventsWebhook": "string",
  • "_sapBwClientId": 0,
  • "sapBwClientId": 0,
  • "_sapBwGateway": "string",
  • "sapBwGateway": "string",
  • "_sapBwGroup": "string",
  • "sapBwGroup": "string",
  • "_sapBwName": "string",
  • "sapBwName": "string",
  • "_sapBwQueryListenerPort": 0,
  • "sapBwQueryListenerPort": 0,
  • "_sapBwSystemNumber": 0,
  • "sapBwSystemNumber": 0,
  • "_sapBwRfcTrace": 0,
  • "sapBwRfcTrace": "string",
  • "_sapR3andCrmAuditLevel": 0,
  • "sapR3andCrmAuditLevel": "string",
  • "_sapR3andCrmClientId": 0,
  • "sapR3andCrmClientId": 0,
  • "_sapEvents": [
    ],
  • "sapEvents": [
    ],
  • "_sapR3andCrmGateway": "string",
  • "sapR3andCrmGateway": "string",
  • "_sapR3andCrmGroup": "string",
  • "sapR3andCrmGroup": "string",
  • "_sapR3andCrmName": "string",
  • "sapR3andCrmName": "string",
  • "_sapR3andCrmQueryListenerPort": 0,
  • "sapR3andCrmQueryListenerPort": 0,
  • "_sapR3andCrmSystemNumber": 0,
  • "sapR3andCrmSystemNumber": 0,
  • "_sapR3andCrmRfcTrace": 0,
  • "sapR3andCrmRfcTrace": "string"
}

Response samples

Content type
No sample

Deletes the Machine with the specified Id

Sample request:

DELETE /api/machines/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Re-synchronizes running jobs on the Machine with the specified Id

Sample request:

POST /api/syncRunningJobs

{
"machine": {
    "id": 1
}
Authorizations:
Token
Request Body schema:
object (OpCon.Api.Data.Entities.MachineToSync)
runningJobsCount
integer <int32>

Responses

Request samples

Content type
{
  • "machine": {
    },
  • "runningJobsCount": 0
}

Response samples

Content type
No sample

NamedInstances

Gets a list of Named Instances based on optional criteria specified

Sample request:

GET /api/namedInstances?limit=10
Authorizations:
Token
query Parameters
Id
integer <int32>

The Schedule Instance Id

Name
string

The Schedule Instance Name (Can accept ? and * wildcards)

ScheduleId
integer <int32>

The Schedule Id

Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

SortOrders
Array of strings
SortBy
string

Option to sort Schedule Instances by Id, Name or ScheduleId in ascending (default) or descending (:desc) order

Responses

Response samples

Content type
No sample

Gets the Named Instances with the specified Id

Sample request:

GET /api/namedInstances/1
Authorizations:
Token
path Parameters
instanceId
required
integer <int32>

Responses

Response samples

Content type
No sample

NotificationCategories

Gets a list of Notification Categories based on option criteria provided

Sample request: 

GET /api/notificationCategories?limit=1&offset=1
Authorizations:
Token
query Parameters
Id
integer <int32>

The Notification Category Id

Name
string

The Notification Category Name (Can accept ? and * wildcards)

Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

IgnoreCase
boolean

Use case-insensitive search criteria

SortBy
string

Option to sort Notification Categories by Id or Category in ascending (default) or descending (:desc) order

Responses

Response samples

Content type
No sample

Creates a new Notification Category

Sample request:

POST /api/notificationCategories
        
{
    "category": "newCategory",
    "groups": [
        {
            "id": 1,
            "name": "Group1"
        }
    ]
}
Authorizations:
Token
Request Body schema:
id
integer <int32>
category
required
string [ 1 .. 4000 ] characters
Array of objects or null (OpCon.Api.Data.Services.NotificationCategories.NotificationCategoryGroup)

Responses

Request samples

Content type
{
  • "id": 0,
  • "category": "string",
  • "groups": [
    ]
}

Response samples

Content type
No sample

Updates the Notification Category with the specified Id

Sample request: 

PUT /api/notificationCategories/1

{
    "id": 1,
    "category": "updated Sample Category",
    "groups": [
        {
            "id": 1,
            "name": "Group1"
        }
    ]
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer <int32>
category
required
string [ 1 .. 4000 ] characters
Array of objects or null (OpCon.Api.Data.Services.NotificationCategories.NotificationCategoryGroup)

Responses

Request samples

Content type
{
  • "id": 0,
  • "category": "string",
  • "groups": [
    ]
}

Response samples

Content type
No sample

Deletes the Notification Category with the specified Id

Sample request:

DELETE /api/notificationCategories/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

NotificationGroups

Gets a list of Schedules for Notification Groups based on optional criteria specified

Sample request:

GET /api/notificationGroups/schedules?Name=testScheduleName
Authorizations:
Token
query Parameters
Name
string

The Notification Group Name (Can accept ? and * wildcards)

Type
string

The Notification Group Type (Can accept ? and * wildcards)

MachineTypes
string

Comma-separated list of type of the machines to fetch

Ids
string

Comma-separated list of Notification Group Ids

Limit
integer <int32>

Limits the results being fetched. 0 retrieves just a count

Offset
integer <int32>

Retrieves records beginning at this record number

IgnoreCase
boolean

Use case-insensitive search criteria

SortBy
string

Option to sort Notification Groups by Name or Type in ascending (default) or descending (:desc) order

BasicDetails
boolean

Flag to retrieve basic details only

Show
integer <int32> (OpCon.Api.Data.Criteria.NotificationGroupCriteria+NotificationGroupShow)
Enum: 0 1 2

Retrieve All ids, Selected ids, or NotSelected ids. Used by notificationGroups/{groupType} endpoints only. Default is All.

GroupId
integer <int32>

Limits the results of Show to the specified group id. Used by notificationGroups/{groupType} endpoints only.

Responses

Response samples

Content type
No sample

Gets a list of Jobs for Notification Groups based on optional criteria specified

Sample request:

GET /api/notificationGroups/jobs?Name=sampleJobName
Authorizations:
Token
query Parameters
Name
string

The Notification Group Name (Can accept ? and * wildcards)

Type
string

The Notification Group Type (Can accept ? and * wildcards)

MachineTypes
string

Comma-separated list of type of the machines to fetch

Ids
string

Comma-separated list of Notification Group Ids

Limit
integer <int32>

Limits the results being fetched. 0 retrieves just a count

Offset
integer <int32>

Retrieves records beginning at this record number

IgnoreCase
boolean

Use case-insensitive search criteria

SortBy
string

Option to sort Notification Groups by Name or Type in ascending (default) or descending (:desc) order

BasicDetails
boolean

Flag to retrieve basic details only

Show
integer <int32> (OpCon.Api.Data.Criteria.NotificationGroupCriteria+NotificationGroupShow)
Enum: 0 1 2

Retrieve All ids, Selected ids, or NotSelected ids. Used by notificationGroups/{groupType} endpoints only. Default is All.

GroupId
integer <int32>

Limits the results of Show to the specified group id. Used by notificationGroups/{groupType} endpoints only.

Responses

Response samples

Content type
No sample

Gets a list of Machines for Notification Groups

Sample request:

GET /api/notificationGroups/machines?Name=sampleMachineName
Authorizations:
Token
query Parameters
Name
string

The Notification Group Name (Can accept ? and * wildcards)

Type
string

The Notification Group Type (Can accept ? and * wildcards)

MachineTypes
string

Comma-separated list of type of the machines to fetch

Ids
string

Comma-separated list of Notification Group Ids

Limit
integer <int32>

Limits the results being fetched. 0 retrieves just a count

Offset
integer <int32>

Retrieves records beginning at this record number

IgnoreCase
boolean

Use case-insensitive search criteria

SortBy
string

Option to sort Notification Groups by Name or Type in ascending (default) or descending (:desc) order

BasicDetails
boolean

Flag to retrieve basic details only

Show
integer <int32> (OpCon.Api.Data.Criteria.NotificationGroupCriteria+NotificationGroupShow)
Enum: 0 1 2

Retrieve All ids, Selected ids, or NotSelected ids. Used by notificationGroups/{groupType} endpoints only. Default is All.

GroupId
integer <int32>

Limits the results of Show to the specified group id. Used by notificationGroups/{groupType} endpoints only.

Responses

Response samples

Content type
No sample

Gets a list of Notification Groups based on optional criteria specified

Sample request:

GET /api/notificationGroups
Authorizations:
Token
query Parameters
Name
string

The Notification Group Name (Can accept ? and * wildcards)

Type
string

The Notification Group Type (Can accept ? and * wildcards)

MachineTypes
string

Comma-separated list of type of the machines to fetch

Ids
string

Comma-separated list of Notification Group Ids

Limit
integer <int32>

Limits the results being fetched. 0 retrieves just a count

Offset
integer <int32>

Retrieves records beginning at this record number

IgnoreCase
boolean

Use case-insensitive search criteria

SortBy
string

Option to sort Notification Groups by Name or Type in ascending (default) or descending (:desc) order

BasicDetails
boolean

Flag to retrieve basic details only

Show
integer <int32> (OpCon.Api.Data.Criteria.NotificationGroupCriteria+NotificationGroupShow)
Enum: 0 1 2

Retrieve All ids, Selected ids, or NotSelected ids. Used by notificationGroups/{groupType} endpoints only. Default is All.

GroupId
integer <int32>

Limits the results of Show to the specified group id. Used by notificationGroups/{groupType} endpoints only.

Responses

Response samples

Content type
No sample

Creates a new Notification Group

Sample request:

POST /api/notificationGroups/1  
        
{  
    "name": "NotificationGroup",
    "excludeSelected": false,
    "selected": [
        {
            "id":2,
            "name": "UnixMachine"
        }
    ],
    "categories":[
        "Tag1"
    ],
    "type": "J"
}
Authorizations:
Token
Request Body schema:
id
integer or null <int32>

Id for the notification group

name
string or null

Name for the notification group

excludeSelected
boolean or null

Boolean to specify if selected items will be included or excluded

Array of objects or null (OpCon.Api.Data.Services.NotificationGroups.NotificationGroupSelectedItem)

Jobs, Schedules or Machines associated with the notification group

categories
Array of strings or null

Categories associated with the notification group

type
string or null

Notification group type (System, User) Valid values = machine, schedule or job

parentGroupId
integer or null <int32>

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "excludeSelected": true,
  • "selected": [
    ],
  • "categories": [
    ],
  • "type": "string",
  • "parentGroupId": 0
}

Response samples

Content type
No sample

Updates the Notification Group with the specified Id

Sample request:

PUT /api/notificationGroups/1  
        
{
    "id": 1,
    "name": "NotificationGroup",
    "excludeSelected": false,
    "selected": [
        {
            "id":2,
            "name": "UnixMachine"
        }
    ],
    "categories":[
        "Tag1"
    ],
    "type": "J"
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer or null <int32>

Id for the notification group

name
string or null

Name for the notification group

excludeSelected
boolean or null

Boolean to specify if selected items will be included or excluded

Array of objects or null (OpCon.Api.Data.Services.NotificationGroups.NotificationGroupSelectedItem)

Jobs, Schedules or Machines associated with the notification group

categories
Array of strings or null

Categories associated with the notification group

type
string or null

Notification group type (System, User) Valid values = machine, schedule or job

parentGroupId
integer or null <int32>

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "excludeSelected": true,
  • "selected": [
    ],
  • "categories": [
    ],
  • "type": "string",
  • "parentGroupId": 0
}

Response samples

Content type
No sample

Deletes the Notification Group with the specified Id

Sample request:

DELETE /api/notificationGroups/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Notifications

Gets the Notification with the specified Id

Sample request:

GET /api/notifications/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

NotificationTriggers

Gets a list of Notification Triggers for the Job with the specified Id

Sample request:

GET /api/notificationTriggers/1|Audit History Purge
Authorizations:
Token
path Parameters
jobId
required
string

Responses

Response samples

Content type
No sample

Gets a list of Notification Triggers based on optional criteria specified

Sample request:

GET /api/notificationTriggers?name=NTName
Authorizations:
Token
query Parameters
Name
string

Name of the trigger to fetch (Can accept ? and * wildcards)

Description
string

Descriptyion of the trigger to fetch (Can accept ? and * wildcards)

GroupType
string

Group type of the trigger to fetch: Job, Machine, or Schedule

Categories
string

Categories of the group for the trigger to fetch (Can accept ? and * wildcards)

Notifications
string

Notifications of the group for the trigger to fetch (Can accept ? and * wildcards)

Contents
string

Content of the trigger message (Can accept ? and * wildcards)

GroupId
integer <int32>

Unique identifier value of the notification group to be associated with the triggers to fetch

Group
string

Name of the notification group to be associated with the triggers to fetch (Can accept ? and * wildcards)

Ids
string

Comma-separated list of Notification Trigger Ids

Limit
integer <int32> [ 0 .. 2147483647 ]

Limits the results being fetched

Offset
integer <int32> [ 0 .. 2147483647 ]

Retrieves records beginning at this record number

SortBy
string

Option to sort Notification Triggers by Group, GroupType, Name or Description in ascending (default) or descending (:desc) order

IgnoreCase
boolean

Use case-insensitive search criteria.

IncludeDetails
boolean

Flag to include Messages and Group Categories. Default is true.

GroupIds
string

Comma-separated list of group ids.

Responses

Response samples

Content type
No sample

Creates a new Notification Trigger

Sample request:

POST /api/notificationTriggers 
        
{
 "name": "Job Finished Ok",
 "description": "",
 "includeInternalJobNumber": true,
 "group": { 
    "id": 1, "name": "someJobTriggersGroup",
    "categories": ["critical","daily"]
    },
  "notifications": [

  ]
}
Authorizations:
Token
Request Body schema:
id
integer or null <int32>

The id of the notification trigger

name
required
string non-empty

The name of the notification trigger

description
string or null

The description of the notification trigger

includeInternalJobNumber
boolean or null

Specifies whether the internal job number will be included in the job name or not.

object (OpCon.Api.Data.Services.NotificationGroups.NotificationGroup)
Array of objects or null (OpCon.Api.Data.Entities.NotificationMessage)

List of messages associated with the notification trigger

object (OpCon.Api.Data.Services.Escalation.Models.EscalationRule)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "includeInternalJobNumber": true,
  • "group": {
    },
  • "messages": [
    ],
  • "escalationRule": {
    }
}

Response samples

Content type
No sample

Updates the Notification Trigger specified by the Id

Sample request:

PUT /api/notificationTriggers/1  
        
{
    "id": 1,
    "name": "Job Failed",
    "description": "Description",
    "includeInternalJobNumber": false,
    "group": 
        {
            "id":2,
            "name": "UnixMachine",
    "categories":[
        "Category1"
    ]
    },
    "messages": []
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer or null <int32>

The id of the notification trigger

name
required
string non-empty

The name of the notification trigger

description
string or null

The description of the notification trigger

includeInternalJobNumber
boolean or null

Specifies whether the internal job number will be included in the job name or not.

object (OpCon.Api.Data.Services.NotificationGroups.NotificationGroup)
Array of objects or null (OpCon.Api.Data.Entities.NotificationMessage)

List of messages associated with the notification trigger

object (OpCon.Api.Data.Services.Escalation.Models.EscalationRule)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "includeInternalJobNumber": true,
  • "group": {
    },
  • "messages": [
    ],
  • "escalationRule": {
    }
}

Response samples

Content type
No sample

Deletes the Notification Trigger specified by the Id

Sample request:

DELETE /api/notificationTrigger/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Sends a test for the Message Type in the Trigger specified.

Sample request:

POST /api/notificationTriggers/test

{
 ,
 "messageType": "Email", //Options are: All, Email, Text, NetworkMessage, OpCon Event, Windows Event Log, RunCommand, SNMPTrap, SPO Event
}
Authorizations:
Token
Request Body schema:
messageType
string or null
object (OpCon.Api.Data.Entities.NotificationTrigger)

An notification trigger with id and name fields

Responses

Request samples

Content type
{
  • "messageType": "string",
  • "notificationTrigger": {
    }
}

OpConEvents

Submits a list of OpCon Events

Sample request:

POST /api/opConEventsCollection 
        
{
    "events": [
        "$CONSOLE:DISPLAY,event1",
        "$CONSOLE:DISPLAY,event2"
    ]
}
Authorizations:
Token
Request Body schema:
loginName
string or null
Array of objects or null (OpCon.Api.Data.Entities.SimpleEvent)

Responses

Request samples

Content type
{
  • "loginName": "string",
  • "events": [
    ]
}

Response samples

Content type
No sample

PasswordResetCodes

Creates a new Password Reset Code and sends an email to the User

Sample request:

POST /api/passwordResetCodes/request
        
{
    "loginName": "Operator",
    "email":"test@sam.com"
}
Authorizations:
Token
Request Body schema:
loginName
string or null

The Login Name of the user requesting the password reset

email
string or null

The email of the user requesting the password reset

Responses

Request samples

Content type
{
  • "loginName": "string",
  • "email": "string"
}

PropertyExpression

Creates a new Property Expression

Sample request:

POST /api/propertyExpression 
        
{
    "expression": "r'\d{3}-\d{2}-\d{4}'",
}
Authorizations:
Token
Request Body schema:
expression
string or null

The Property Expression

status
string or null

The Property Expression status (success, failed)

result
string or null

The result of the Property Expression evaluation

message
string or null

The Property Expression Message (evaluated, or error message)

Responses

Request samples

Content type
{
  • "expression": "string",
  • "status": "string",
  • "result": "string",
  • "message": "string"
}

Response samples

Content type
No sample

RefreshScheduleBuildResultsCache

Refreshes the Schedule Build Request cache

Sample request:

GET /api/refreshScheduleBuildResultCache
Authorizations:
Token

Responses

RefreshVisionCache

Refreshes the Vision cache

Sample request:

GET /api/refreshVisionCache
Authorizations:
Token
query Parameters
RefreshStatistics
boolean

Responses

Relay

Restart a specific relay

Sample request:

POST api/relay/restart
{
    "relayName": "YourRelayName"
}
Authorizations:
Token
Request Body schema:

Request containing the relay name to restart

relayName
string or null
machineId
string or null

Responses

Request samples

Content type
{
  • "relayName": "string",
  • "machineId": "string"
}

Upgrade a specific relay to a specified version

Sample request:

POST api/relay/upgrade
{
    "relayName": "YourRelayName",
    "version": "25.5.0"
}

Use GetAvailableUpgrades to get a list of available versions for the relay.

Authorizations:
Token
Request Body schema:

Request containing the relay name and version to upgrade to

relayName
string or null
version
string or null
machineId
string or null

Responses

Request samples

Content type
{
  • "relayName": "string",
  • "version": "string",
  • "machineId": "string"
}

Get list of available relays

Sample request:

GET api/relay/list
Authorizations:
Token

Responses

Get available upgrades for relays

Sample request:

GET api/relay/upgrades/available
GET api/relay/upgrades/available?relayName=Relay1
Authorizations:
Token
query Parameters
relayName
string

Responses

Get current logs from a specific relay on demand

Sample request:

GET api/relay/{relayName}/logs

This endpoint calls NetCommApi which sends an OpConRequest to the relay to retrieve the current log files (SMANetcomRelay.log, SMANetcomRelayApi.log, SMANetcomTrace.log). The response contains XML formatted log data.

Authorizations:
Token
path Parameters
relayName
required
string

Name of the relay to retrieve logs from

query Parameters
machineId
string

Responses

Get configuration from a relay

Sample request:

GET api/relay/{relayName}/configuration?machineId=123

This endpoint calls NetCommApi which sends an OpConRequest to the relay to retrieve the configuration from the SMANetComRelay.ini file [Dynamic Settings] section. The response contains JSON formatted configuration data.

Authorizations:
Token
path Parameters
relayName
required
string

Name of the relay to retrieve configuration from

query Parameters
machineId
string

MachineId of the relay (optional, for newer relays with primary/failover support)

Responses

Store configuration to a relay

Sample request:

POST api/relay/{relayName}/configuration?machineId=123
{
    "metricsCollectionIntervalMinutes": 2,
    "metricsReportingIntervalMinutes": 15,
    "sampleRetentionMinutes": 20,
    "enableMetricsCollection": true
}

This endpoint calls NetCommApi which sends an OpConRequest to the relay to store the configuration to the SMANetComRelay.ini file [Dynamic Settings] section.

Authorizations:
Token
path Parameters
relayName
required
string

Name of the relay to store configuration to

query Parameters
machineId
string

MachineId of the relay (optional, for newer relays with primary/failover support)

Request Body schema:

Request containing the configuration settings to store

metricsCollectionIntervalMinutes
integer or null <int32>
metricsReportingIntervalMinutes
integer or null <int32>
sampleRetentionMinutes
integer or null <int32>
enableMetricsCollection
boolean or null
machineId
string or null

Responses

Request samples

Content type
{
  • "metricsCollectionIntervalMinutes": 0,
  • "metricsReportingIntervalMinutes": 0,
  • "sampleRetentionMinutes": 0,
  • "enableMetricsCollection": true,
  • "machineId": "string"
}

Manually trigger failover to a specific relay

Sample request:

POST api/relay/failover/manual
{
    "relayName": "YourRelayName",
    "targetMachineId": "MachineId123",
    "reason": "Manual failover due to maintenance"
}
Authorizations:
Token
Request Body schema:

Request containing relay name and target machine ID

relayName
string or null
targetMachineId
string or null
reason
string or null

Responses

Request samples

Content type
{
  • "relayName": "string",
  • "targetMachineId": "string",
  • "reason": "string"
}

Get current failover status for a relay

Sample request:

GET api/relay/{relayName}/failover/status
Authorizations:
Token
path Parameters
relayName
required
string

Name of the relay

Responses

Get health metrics for a relay

Sample request:

GET api/relay/{relayName}/health
GET api/relay/{relayName}/health?machineId=MachineId123
Authorizations:
Token
path Parameters
relayName
required
string

Name of the relay

query Parameters
machineId
string

Optional machine ID

Responses

RemoteInstances

Gets a list of Remote Instances based on optional criteria specified

Sample request:

GET /api/remoteInstances
Authorizations:
Token
query Parameters
Ids
string

Comma-separated list of Remote Instance Ids

Name
string

The Remote Instance Name (Can accept ? and * wildcards)

Responses

Response samples

Content type
No sample

Creates a new Remote Instance and returns it with its Id, if successful

Sample request:

POST /api/remoteInstances/1
        
{
    "name": "instance1",
}
Authorizations:
Token
Request Body schema:
status
integer <int32> (OpCon.Api.Data.Entities.RemoteInstanceStatus)
Enum: 1 2
id
integer <int32>

The Remote Instance Id

name
string or null

The Remote Instance Name

description
string or null

The Remote Instance Description

object (OpCon.Api.Data.Entities.RemoteInstanceDatabaseConnection)
apiBaseUrl
string or null

The Remote Instance's API URL

solutionManagerBaseUrl
string or null

The Solution Manager API URL

object (OpCon.Api.Data.Services.Users.User)
object (OpCon.Api.Data.Entities.Token)
masterInstanceId
integer or null <int32>
connectionString
string or null
Array of objects or null (OpCon.Api.Data.Services.Users.User)

A list of Vision Action Users

Responses

Request samples

Content type
{
  • "status": 1,
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "databaseConnection": {
    },
  • "apiBaseUrl": "string",
  • "solutionManagerBaseUrl": "string",
  • "adminUser": {
    },
  • "adminToken": {
    },
  • "masterInstanceId": 0,
  • "connectionString": "string",
  • "visionActionUsers": [
    ]
}

Response samples

Content type
No sample

Gets the Remote Instance with the specified Id

Sample request:

GET /api/remoteInstances/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Remote Instance with the specified Id

Sample request:

PUT /api/remoteInstances/1
        
{
    "name": "instance1a",
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
status
integer <int32> (OpCon.Api.Data.Entities.RemoteInstanceStatus)
Enum: 1 2
id
integer <int32>

The Remote Instance Id

name
string or null

The Remote Instance Name

description
string or null

The Remote Instance Description

object (OpCon.Api.Data.Entities.RemoteInstanceDatabaseConnection)
apiBaseUrl
string or null

The Remote Instance's API URL

solutionManagerBaseUrl
string or null

The Solution Manager API URL

object (OpCon.Api.Data.Services.Users.User)
object (OpCon.Api.Data.Entities.Token)
masterInstanceId
integer or null <int32>
connectionString
string or null
Array of objects or null (OpCon.Api.Data.Services.Users.User)

A list of Vision Action Users

Responses

Request samples

Content type
{
  • "status": 1,
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "databaseConnection": {
    },
  • "apiBaseUrl": "string",
  • "solutionManagerBaseUrl": "string",
  • "adminUser": {
    },
  • "adminToken": {
    },
  • "masterInstanceId": 0,
  • "connectionString": "string",
  • "visionActionUsers": [
    ]
}

Response samples

Content type
No sample

Deletes the Remote Instance with the specified Id

Sample request:

DELETE /api/remoteInstances/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Reporting

Get a list of records of a Report type based on an optional criteria

Sample request for Audit report with AND logic (default):

POST /api/reporting

{
    "reportType": "Audit",
    "offset": 0,
    "limit": 5100,
    "logicalOperator": "And",
    "filters": [
        {
            "name": "category",
            "comparer": "=",
            "value": "Master Job"
        },
        {
            "name": "date",
            "comparer": ">=",
            "value": "06/20/2023"
        }
    ],
    "orderBy": [
        {
            "name": "name",
            "direction": "asc"
        }
    ]
}

Sample request for CurrentInstancePropertyValues report with OR logic:

POST /api/reporting

{
    "reportType": "CurrentInstancePropertyValues",
    "offset": 0,
    "limit": 50,
    "logicalOperator": "Or",
    "filters": [
        {
            "name": "propertyName",
            "comparer": "like",
            "value": "database"
        },
        {
            "name": "propertyValue",
            "comparer": "like",
            "value": "prod"
        }
    ],
    "orderBy": [
        {
            "name": "propertyName",
            "direction": "asc"
        }
    ]
}

Note: The logicalOperator field is optional and defaults to "And" if not specified. Valid values are "And" and "Or". All filters will be combined using the specified operator.

Authorizations:
Token
Request Body schema:
reportType
string (OpCon.Api.Data.Services.Reporting.ReportType)
Enum: "Unknown" "Audit" "ScheduleJob" "AnnualPlanDatesByCalendar" "CrossReferenceSchedulesAndJobs" "CurrentGlobalPropertyValues" "CurrentResourceValues" "CurrentThresholdValues" "DailyJobInformation" "DailySchedulesInformation" "EventDetails" "FrequenciesAndAssociatedJobs" "MasterJobInformation" "ComparativeJobExecutionStatistics" "JobDependenciesAndDocumentation" "UniqueTaskCount" "UsersAndPrivileges" "RolesAndPrivileges"
limit
integer <int32>

Limits the results being fetched

offset
integer <int32>

Retrieves records beginning at this record number

Array of objects or null (OpCon.Api.Data.Services.Reporting.OrderBy)
startDate
string <date-time>

The date to start the search from

endDate
string <date-time>

The date to end the search

Array of objects or null (OpCon.Api.Data.Services.Reporting.Filter)
logicalOperator
integer <int32> (OpCon.Api.Data.Services.Reporting.LogicalOperator)
Enum: 0 1
columnOrder
Array of strings or null

Optional column order for CSV export. If provided, CSV columns will be ordered according to this list. If null/empty, uses default column definition order.

Responses

Request samples

Content type
{
  • "reportType": "Unknown",
  • "limit": 0,
  • "offset": 0,
  • "orderBy": [
    ],
  • "startDate": "2019-08-24T14:15:22Z",
  • "endDate": "2019-08-24T14:15:22Z",
  • "filters": [
    ],
  • "logicalOperator": 0,
  • "columnOrder": [
    ]
}

Response samples

Content type
No sample

Downloads the specified Report records

Sample request for Audit report with AND logic (default):

POST /api/reporting/export
        
{
    "reportType": "Audit",
    "offset": 0,
    "limit": 5100,
    "logicalOperator": "And",
    "filters": [
        {
            "name": "category",
            "comparer": "=",
            "value": "Master Job"
        },
        {
            "name": "date",
            "comparer": ">=",
            "value": "06/20/2023"
        }
    ],
    "orderBy": [
        {
            "name": "name",
            "direction": "asc"
        }
    ]
}

Sample request for CurrentInstancePropertyValues report with OR logic:

POST /api/reporting/export
        
{
    "reportType": "CurrentInstancePropertyValues",
    "offset": 0,
    "limit": 50,
    "logicalOperator": "Or",
    "filters": [
        {
            "name": "description",
            "comparer": "like",
            "value": "connection"
        }
    ],
    "orderBy": [
        {
            "name": "propertyName",
            "direction": "asc"
        }
    ]
}

Note: The logicalOperator field is optional and defaults to "And" if not specified. Valid values are "And" and "Or". All filters will be combined using the specified operator.

Authorizations:
Token
Request Body schema:
reportType
string (OpCon.Api.Data.Services.Reporting.ReportType)
Enum: "Unknown" "Audit" "ScheduleJob" "AnnualPlanDatesByCalendar" "CrossReferenceSchedulesAndJobs" "CurrentGlobalPropertyValues" "CurrentResourceValues" "CurrentThresholdValues" "DailyJobInformation" "DailySchedulesInformation" "EventDetails" "FrequenciesAndAssociatedJobs" "MasterJobInformation" "ComparativeJobExecutionStatistics" "JobDependenciesAndDocumentation" "UniqueTaskCount" "UsersAndPrivileges" "RolesAndPrivileges"
limit
integer <int32>

Limits the results being fetched

offset
integer <int32>

Retrieves records beginning at this record number

Array of objects or null (OpCon.Api.Data.Services.Reporting.OrderBy)
startDate
string <date-time>

The date to start the search from

endDate
string <date-time>

The date to end the search

Array of objects or null (OpCon.Api.Data.Services.Reporting.Filter)
logicalOperator
integer <int32> (OpCon.Api.Data.Services.Reporting.LogicalOperator)
Enum: 0 1
columnOrder
Array of strings or null

Optional column order for CSV export. If provided, CSV columns will be ordered according to this list. If null/empty, uses default column definition order.

Responses

Request samples

Content type
{
  • "reportType": "Unknown",
  • "limit": 0,
  • "offset": 0,
  • "orderBy": [
    ],
  • "startDate": "2019-08-24T14:15:22Z",
  • "endDate": "2019-08-24T14:15:22Z",
  • "filters": [
    ],
  • "logicalOperator": 0,
  • "columnOrder": [
    ]
}

ReportingSettings

Gets the Reporting Settings

Sample request:

GET /api/reportingSettings
Authorizations:
Token

Responses

Response samples

Content type
No sample

Updates the Reporting Settings

Sample request: 

PUT /api/reportingSettings

{
    "scheduleTime1": "02:00",
    "scheduleTime2": "14:00",
    "defaultCommandTimeout": 30,
    "maxRetryAttempts": 3,
    "retryDelaySeconds": 30,
    "logLevel": "Information",
    "maxLogSize": 1,
    "maxLogDays": 30,
    "maxDownloadRecords": 100000
}
Authorizations:
Token
Request Body schema:
scheduleTime1
string or null
scheduleTime2
string or null
timeZone
string or null
defaultCommandTimeout
integer or null <int32>
maxRetryAttempts
integer or null <int32>
retryDelaySeconds
integer or null <int32>
logLevel
string or null
maxLogSize
integer or null <int32>
maxLogDays
integer or null <int32>
maxDownloadRecords
integer or null <int32>

Responses

Request samples

Content type
{
  • "scheduleTime1": "string",
  • "scheduleTime2": "string",
  • "timeZone": "string",
  • "defaultCommandTimeout": 0,
  • "maxRetryAttempts": 0,
  • "retryDelaySeconds": 0,
  • "logLevel": "string",
  • "maxLogSize": 0,
  • "maxLogDays": 0,
  • "maxDownloadRecords": 0
}

Response samples

Content type
No sample

Resources

Updates the Resource with the specified Id

Sample request:

PUT /api/resources/1

{
    "id": 1,
    "name": "R1",
    "description": "Resource 1",
    "value": 10
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer or null <int32>

Threshold/Resource Id

name
string or null

Threshold/Resource Name

description
string or null

Threshold/Resource Description

value
integer or null <int32>

Threshold/Resource Value

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceDailyJob)

List of Daily Jobs that depend on the Threshold/Resource

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceDailyJob)

List of Daily Jobs that update the Threshold/Resource

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceMasterJob)

List of Master Jobs that depend on the Threshold/Resource

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceMasterJob)

List of Master Jobs that update the Threshold/Resource

used
integer or null <int32>

Number of times the Resource is used

locked
boolean or null

Flag to indicate if the Resource is locked

object (OpCon.Api.Data.Entities.LockedByDailyJob)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "value": 0,
  • "dependentDailyJobs": [
    ],
  • "updatedByDailyJobs": [
    ],
  • "dependentMasterJobs": [
    ],
  • "updatedByMasterJobs": [
    ],
  • "used": 0,
  • "locked": true,
  • "lockedByDailyJob": {
    }
}

Response samples

Content type
No sample

Gets the Resource with the specified Id

Sample request:

GET /api/resources/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Deletes the Resource with the specified Id

Sample request:

DELETE /api/resources/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Creates a new Resource

Sample request:

POST /api/resources

{
    "name": "R1",
    "description": "Resource 1",
    "value": 10
}
Authorizations:
Token
Request Body schema:
id
integer or null <int32>

Threshold/Resource Id

name
string or null

Threshold/Resource Name

description
string or null

Threshold/Resource Description

value
integer or null <int32>

Threshold/Resource Value

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceDailyJob)

List of Daily Jobs that depend on the Threshold/Resource

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceDailyJob)

List of Daily Jobs that update the Threshold/Resource

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceMasterJob)

List of Master Jobs that depend on the Threshold/Resource

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceMasterJob)

List of Master Jobs that update the Threshold/Resource

used
integer or null <int32>

Number of times the Resource is used

locked
boolean or null

Flag to indicate if the Resource is locked

object (OpCon.Api.Data.Entities.LockedByDailyJob)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "value": 0,
  • "dependentDailyJobs": [
    ],
  • "updatedByDailyJobs": [
    ],
  • "dependentMasterJobs": [
    ],
  • "updatedByMasterJobs": [
    ],
  • "used": 0,
  • "locked": true,
  • "lockedByDailyJob": {
    }
}

Response samples

Content type
No sample

Get a list of resources based on the optional specified criteria

Sample request:

GET /api/resources?name=R1
Authorizations:
Token
query Parameters
IncludeDependentDailyJobs
boolean

Flag to include a list of Daily Jobs dependent on the Threshold

IncludeUpdatedByDailyJobs
boolean

Flag to include a list of Thresholds updated by Daily Jobs

IncludeDependentMasterJobs
boolean

Flag to include a list of Master Jobs dependent on the Threshold

IncludeUpdatedByMasterJobs
boolean

Flag to include a list of Thresholds updated by Master Jobs

Offset
integer <int32>

Retrieves records beginning at this record number

Limit
integer <int32>

Limits the results being fetched. 0 retrieves just a count

Name
string

The Threshold Name

Value
integer <int32>

The Threshold Value

Ids
string

Comma-separated list of Threshold Ids

Description
string

Threshold description

SortBy
string

Option to sort Thresholds by Id, Name or Description in ascending (default) or descending (:desc) order

SortOrders
Array of strings

Responses

Response samples

Content type
No sample

Roles

Gets a list of Roles based on optional criteria specified

Sample request (this returns a list of Roles by Name in descending order):

GET /api/roles?sortBy=name:desc
Authorizations:
Token
query Parameters
Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieve records beginning at this record number

IncludeAccessCodes
boolean

Flag to include Access Code Ids assigned to the Role

IncludeDepartmentFunctions
boolean

Flag to include Department Function Ids assigned to the Role

IncludeMachines
boolean

Flag to include Machines assigned to the Role

IncludeMachineGroups
boolean

Flag to include Machine Groups assigned to the Role

IncludeSchedules
boolean

Flag to include Schedule Ids assigned to the Role

IncludeServiceRequests
boolean

Flag to include Service Request Ids assigned to the Role

IncludeBatchUsers
boolean

Flag to include Batch User Ids assigned to the Role

IncludeEmbeddedScripts
boolean

Flag to include Script Ids assigned to the Role

IncludeUsers
boolean

Flag to include User Ids assigned to the Role

Name
string

The Role Name (Can accept ? and * wildcards)

Ids
string

Comma-separated list of Role Ids

SortOrder.SortBy
string
SortOrder.IdColumns
Array of strings
SortOrder.ValidSortOrders
Array of strings
SortOrder.ColumnList
Array of strings
SortOrder.SortTypeList
Array of strings
SortBy
string

Option to sort Roles by Id or Name

Responses

Response samples

Content type
No sample

Creates a new Role and returns it with its Id, if successful

Sample request:

POST /api/roles

{
    "name": "SomeRole",
    "inheritAllSchedulePrivileges: true
}
Authorizations:
Token
Request Body schema:
id
integer <int32>

The Role Id

name
string or null

The Role Name

description
string or null

The Role Description

modifiedBy
string or null

Read-only user name who last modified the Role

modifiedOn
string or null

Read-only timestamp when Role was last modified

inheritAllSchedulePrivileges
boolean or null

When true, this Role's privileges will be applied to all Schedules optional

inheritAllMachinePrivileges
boolean or null

When true, this Role's privileges will be applied to all Machines optional

inheritAllMachineGroupPrivileges
boolean or null

When true, this Role's privileges will be applied to all Machine Groups optional

inheritAllEmbeddedScriptPrivileges
boolean or null

When true, this Role's privileges will be applied to all Embedded Scripts optional

ssoGroups
boolean or null

Flag to indicate if the Role belongs to any SSO groups

object (OpCon.Api.Data.Entities.Permissions)
Array of objects or null (OpCon.Api.Data.Services.Roles.Models.RoleUser)

A list of Users with this Role

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "modifiedBy": "string",
  • "modifiedOn": "string",
  • "inheritAllSchedulePrivileges": true,
  • "inheritAllMachinePrivileges": true,
  • "inheritAllMachineGroupPrivileges": true,
  • "inheritAllEmbeddedScriptPrivileges": true,
  • "ssoGroups": true,
  • "permissions": {
    },
  • "users": [
    ]
}

Response samples

Content type
No sample

Gets a Role with the specified Id

Sample request (this returns the Role with Id = 1):

GET /api/roles/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Role with the specified Id

Sample request:

PUT /api/roles/10

{
    "name": "UpdatedRole",
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer <int32>

The Role Id

name
string or null

The Role Name

description
string or null

The Role Description

modifiedBy
string or null

Read-only user name who last modified the Role

modifiedOn
string or null

Read-only timestamp when Role was last modified

inheritAllSchedulePrivileges
boolean or null

When true, this Role's privileges will be applied to all Schedules optional

inheritAllMachinePrivileges
boolean or null

When true, this Role's privileges will be applied to all Machines optional

inheritAllMachineGroupPrivileges
boolean or null

When true, this Role's privileges will be applied to all Machine Groups optional

inheritAllEmbeddedScriptPrivileges
boolean or null

When true, this Role's privileges will be applied to all Embedded Scripts optional

ssoGroups
boolean or null

Flag to indicate if the Role belongs to any SSO groups

object (OpCon.Api.Data.Entities.Permissions)
Array of objects or null (OpCon.Api.Data.Services.Roles.Models.RoleUser)

A list of Users with this Role

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "modifiedBy": "string",
  • "modifiedOn": "string",
  • "inheritAllSchedulePrivileges": true,
  • "inheritAllMachinePrivileges": true,
  • "inheritAllMachineGroupPrivileges": true,
  • "inheritAllEmbeddedScriptPrivileges": true,
  • "ssoGroups": true,
  • "permissions": {
    },
  • "users": [
    ]
}

Response samples

Content type
No sample

Deletes the Role with the specified Id

Sample request:

DELETE /api/roles/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Gets a list of all Access Codes, Batch Users, Machines, Machine Groups, Schedules, and Scripts

Sample request:

GET /api/roles/resources
Authorizations:
Token

Responses

Response samples

Content type
No sample

SapQuery

Sends SAP query

Sample request (this sends a sap query for SAP B/W jobs):
POST /api/sapQueries

{ "type":"chains", "SapMachine":"SAPMACHINENAME", "language":"EN", "Criteria":[ {"name":"","value":""} ], }

Authorizations:
Token
Request Body schema:
id
integer <int32>
status
string or null
type
string or null
sapMachine
string or null
user
string or null
externalUser
string or null
password
string or null
language
string or null
selection
string or null
jobName
string or null
jobCount
string or null
destination
string or null
systemId
string or null
Array of objects or null (OpCon.Api.Data.Entities.Operations.Sap.Criteria)
object (OpCon.Api.Data.Entities.Operations.Sap.SapJobDetail)

This is the jobDetail parameter

abapName
string or null

This is the abapName parameter

variantName
string or null

This is the variantName parameter

Array of objects or null (OpCon.Api.Data.Entities.Operations.Sap.VariantParameter)

This is the parameters parameter Required for creating abap variant

isJobModify
boolean

Specified when running JobCreate query but editing a daily job.

jobStepModified
boolean

Specified when steps have been added, removed or order changed during job editind

action
string or null
message
string or null
requestIds
Array of integers or null <int64> [ items <int64 > ]
expiryTime
string <date-time>
userId
integer <int32>
result
string or null
Array of objects or null (OpCon.Api.Data.Entities.Operations.Sap.SapQueryResponseValues)
errorMessage
string or null

Responses

Request samples

Content type
{
  • "id": 0,
  • "status": "string",
  • "type": "string",
  • "sapMachine": "string",
  • "user": "string",
  • "externalUser": "string",
  • "password": "string",
  • "language": "string",
  • "selection": "string",
  • "jobName": "string",
  • "jobCount": "string",
  • "destination": "string",
  • "systemId": "string",
  • "criteria": [
    ],
  • "jobDetail": {
    },
  • "abapName": "string",
  • "variantName": "string",
  • "parameters": [
    ],
  • "isJobModify": true,
  • "jobStepModified": true,
  • "action": "string",
  • "message": "string",
  • "requestIds": [
    ],
  • "expiryTime": "2019-08-24T14:15:22Z",
  • "userId": 0,
  • "result": "string",
  • "results": [
    ],
  • "errorMessage": "string"
}

Response samples

Content type
No sample

Return the specified SAP query result

Sample request (this creates a new access code):
GET /api/sapquery/id

Authorizations:
Token
path Parameters
id
required
integer <int32>

Unique identifier for the request

Responses

Response samples

Content type
No sample

ScheduleActions

Gets the result of the Schedule Action with the specified Id

Sample request:

GET /api/scheduleActions/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Submits the Schedule Action provided in the request

Sample request:

POST /api/scheduleActions
        
{
    "action": "hold",
    "scheduleActionItems": [
        {
            "id":"20231128|1|1"
        }
    ]
}
Authorizations:
Token
Request Body schema:
id
integer <int32>
action
string or null
result
string or null
message
string or null
expiryTime
string <date-time>
requestIds
Array of integers or null <int64> [ items <int64 > ]
userId
integer <int32>
invalidStates
Array of strings or null
states
Array of strings or null
reason
string or null

The reason

Array of objects or null (OpCon.Api.Data.Entities.Actions.ScheduleActionItem)

A list of schedule action items

Responses

Request samples

Content type
{
  • "id": 0,
  • "action": "string",
  • "result": "string",
  • "message": "string",
  • "expiryTime": "2019-08-24T14:15:22Z",
  • "requestIds": [
    ],
  • "userId": 0,
  • "invalidStates": [
    ],
  • "states": [
    ],
  • "reason": "string",
  • "scheduleActionItems": [
    ]
}

Response samples

Content type
No sample

ScheduleActionsByDate

Gets the Schedule Action with the specified date

Sample request:

GET /api/scheduleActionsByDate/44444
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Creates a new Schedule Action and returns it with its Id, if successful

Sample request:

POST /api/scheduleActionsByDate
        
{
    "scheduleDates": [ "2023-11-29T00:00:00.0000000-0600" ],
    "action": "holdJobs",
    "states": [ "WAITING" ],
    "jobs": []
    ,"reason": "the reason"
}
Authorizations:
Token
Request Body schema:
action
string or null
invalidStates
Array of strings or null
states
Array of strings or null
requestIds
Array of integers or null <int64> [ items <int64 > ]
expiryTime
string <date-time>
userId
integer <int32>
id
integer <int32>

The Schedule Id

scheduleDates
Array of strings or null

A comma-separated list of dates

Array of objects or null (OpCon.Api.Data.Entities.Actions.ScheduleDateJobItem)

A list of Jobs

reason
string or null

The reason for the Action

result
string or null

The Schedule Action result

message
string or null

The Schedule Action message

updated
integer or null <int32>

A count of the updated Jobs

Responses

Request samples

Content type
{
  • "action": "string",
  • "invalidStates": [
    ],
  • "states": [
    ],
  • "requestIds": [
    ],
  • "expiryTime": "2019-08-24T14:15:22Z",
  • "userId": 0,
  • "id": 0,
  • "scheduleDates": [
    ],
  • "scheduleDateActionItems": [
    ],
  • "reason": "string",
  • "result": "string",
  • "message": "string",
  • "updated": 0
}

Response samples

Content type
No sample

ScheduleBuilds

Gets the Schedule Build response for the specified Id

Sample request:

GET /api/scheduleBuilds/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Creates a new Schedule Build request for the specified schedule Id

Sample request:

POST /api/scheduleBuilds
        
{
    "builds": [
        {
            "masterSchedule": { "id":1 }
        }
    ],
    "dates": ["2023-11-29T00:00:00.0000000-0600"],
    "overwrite": false,
    "hold": true
}
Authorizations:
Token
Request Body schema:
Array of objects or null (ScheduleBuildRequest)
Array of objects or null (ScheduleBuildActionSchedule)
action
string or null
id
integer <int32>
result
string or null
message
string or null
requestIds
Array of integers or null <int64> [ items <int64 > ]
expiryTime
string <date-time>
userId
integer <int32>
dates
Array of strings or null
logFile
string or null
overwrite
boolean
namedInstance
string or null
machineName
string or null
hold
boolean

Responses

Request samples

Content type
{
  • "requests": [
    ],
  • "schedules": [
    ],
  • "action": "string",
  • "id": 0,
  • "result": "string",
  • "message": "string",
  • "requestIds": [
    ],
  • "expiryTime": "2019-08-24T14:15:22Z",
  • "userId": 0,
  • "dates": [
    ],
  • "logFile": "string",
  • "overwrite": true,
  • "namedInstance": "string",
  • "machineName": "string",
  • "hold": true
}

Response samples

Content type
No sample

ScheduleChecks

Submits the specified Schedule Check

Sample request:

POST /api/scheduleChecks
        
{
    "id": "20240430|1|1",
    "entityType": "Schedule",
    "checkType": "Fast"
}
Authorizations:
Token
Request Body schema:
id
required
string [ 1 .. 50 ] characters
entityType
integer <int32> (OpCon.Api.Data.Services.ScheduleCheck.Models.ScheduleCheckRequestType)
Enum: 0 1 2
checkType
string (OpCon.Api.Data.Services.ScheduleCheck.Models.ScheduleCheckType)
Enum: "Unknown" "Slow" "Normal" "Fast"

Responses

Request samples

Content type
{
  • "id": "string",
  • "entityType": 0,
  • "checkType": "Unknown"
}

Gets the schedule check response for the Schedule with the specified id

Sample request:

GET /api/scheduleChecks/20240430|1|1
Authorizations:
Token
path Parameters
id
required
string

Responses

Response samples

Content type
No sample

Gets Log files for the Schedule with the specified date

Sample request:

GET /api/scheduleChecks/logs/11-04-2024
Authorizations:
Token
path Parameters
requestId
required
integer <int64>

Responses

Response samples

Content type
No sample

ScriptDeployments

Deploys the Scripts for the specified Master Jobs

Sample request:

POST /api/scriptDeployments
        
{
    "VersionSelectionType": "Latest",
    "masterJobIds": [ "10|SomeJob" ]
}
Authorizations:
Token
Request Body schema:
masterJobIds
required
Array of strings non-empty
versionSelectionType
required
string non-empty
targetScriptVersionId
integer <int32>

Responses

Request samples

Content type
{
  • "masterJobIds": [
    ],
  • "versionSelectionType": "string",
  • "targetScriptVersionId": 0
}

ScriptRunners

Gets a list of all Script Runners based on optional criteria specified

Sample request:

GET /api/scriptRunners
Authorizations:
Token
query Parameters
ScriptTypeId
integer <int32>

Script Type Id

PlatformId
integer <int32>

OS Platform Id

Name
string

Script Runner Name (Can accept ? and * wildcards)

ScriptRunnerIds
Array of integers <int32> [ items <int32 > ]

List of Script Runner Ids

IncludeCrossReferences
boolean

Flag to include a list of Master and Daily Jobs associated with the Script Runner

AcsApplication
string

ACS Application (only used when PlatformId is 27 | ACS)

Responses

Response samples

Content type
No sample

Creates a new Script Runner

Sample request:

POST /api/scriptRunners

{
    "name": "LuminScript",
    "scriptType": {
        "id": 9
    },
    "lsamType": {
        "id": 6,
        "description": "Unix"
    },
    "command": "run my_script.lumin"
}
Authorizations:
Token
Request Body schema:
name
required
string [ 1 .. 128 ] characters

Script runner name

required
object (SMAOpConRestApi.Controllers.Models.Scripts.AddScriptType)
required
object (SMAOpConRestApi.Controllers.Models.Scripts.AddLsamType)
command
required
string non-empty

Script runner command

Responses

Request samples

Content type
{
  • "name": "string",
  • "scriptType": {
    },
  • "lsamType": {
    },
  • "command": "string"
}

Response samples

Content type
No sample

Gets the Script Runner with the specified Id

Sample request:

GET /api/scriptRunners/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Deletes the Script Runner with the specified Id

Sample request: DELETE /api/scriptRunners/1

Authorizations:
Token
path Parameters
scriptRunnerId
required
integer <int32>

Responses

Updates the Script Runner with the specified Id

Sample request:

PUT /api/scriptRunners/1

{
    "name": "LuminScript",
    "command": "run my_other_script.lumin"
}
Authorizations:
Token
path Parameters
scriptRunnerId
required
integer <int32>
Request Body schema:
name
required
string [ 1 .. 128 ] characters
command
required
string non-empty

Responses

Request samples

Content type
{
  • "name": "string",
  • "command": "string"
}

Response samples

Content type
No sample

Scripts

Gets a list of Script based on optional criteria

Sample request:

GET /api/scripts
Authorizations:
Token
query Parameters
ScriptName
string

The Script Name (Can accept ? and * wildcards)

ScriptTypeName
string

The Script Type Name

ScriptIds
Array of integers <int32> [ items <int32 > ]

A list of Script Ids

VersionIds
Array of integers <int32> [ items <int32 > ]

A list of Script Version Ids

IncludeCrossReferences
boolean

Flag to include a list of Master and Daily Jobs associated with the Script

IncludeVersions
boolean

Flag to include Script Versions

IncludeVersionContent
boolean

Flag to include Content for Script Versions

OpConPlatformId
integer <int32>

The Script Platform Type Id

Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

SortValue
string (OpCon.Api.Data.Services.Scripts.Models.ScriptCriteriaSortColumn)
Enum: "Unknown" "TypeName" "ScriptName" "Description"

Option to sort Scripts by Id, Name or Description

SortDescending
boolean

Flag to indicate to sort Scripts in descending order

AcsApplication
string

The ACS application which the script runners must support

ForMachineId
integer <int32>

Script can only be ran on this Machine ID

Responses

Response samples

Content type
No sample

Create a new Script

Sample request:

POST /api/scripts

{
    "name": "My New Script",
    "description": "My New Script Description",
    "type": {
    "id": 6,
    },
    "versions": [
        {
        "comment": "My New Script Version Comment",
        "content": "My New Script Version Content"
        }
    ]
}
Authorizations:
Token
Request Body schema:
name
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_-]*$

Script name

required
Array of objects (SMAOpConRestApi.Controllers.Models.Scripts.AddInitialScriptVersion) = 1 items

List of script versions

required
object (SMAOpConRestApi.Controllers.Models.Scripts.AddScriptType)
id
integer <int32> [ 0 .. 0 ]

Script id - must be 0 for new scripts

description
string or null <= 4000 characters

Script descrition

forMachineId
integer or null <int32> >= 1

Locks script to a MACHID. This value will be the same for all versions of the script.

required
Array of objects (SMAOpConRestApi.Controllers.Models.Scripts.AddScriptRoleAssignment)

List of roles associated with the script

Responses

Request samples

Content type
{
  • "name": "string",
  • "versions": [
    ],
  • "type": {
    },
  • "id": 0,
  • "description": "string",
  • "forMachineId": 1,
  • "roles": [
    ]
}

Gets the Script with the specified Id

Sample request:

GET /api/scripts/2004
Authorizations:
Token
path Parameters
id
required
integer <int32>
query Parameters
ScriptName
string

The Script Name (Can accept ? and * wildcards)

ScriptTypeName
string

The Script Type Name

ScriptIds
Array of integers <int32> [ items <int32 > ]

A list of Script Ids

VersionIds
Array of integers <int32> [ items <int32 > ]

A list of Script Version Ids

IncludeCrossReferences
boolean

Flag to include a list of Master and Daily Jobs associated with the Script

IncludeVersions
boolean

Flag to include Script Versions

IncludeVersionContent
boolean

Flag to include Content for Script Versions

OpConPlatformId
integer <int32>

The Script Platform Type Id

Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

SortValue
string (OpCon.Api.Data.Services.Scripts.Models.ScriptCriteriaSortColumn)
Enum: "Unknown" "TypeName" "ScriptName" "Description"

Option to sort Scripts by Id, Name or Description

SortDescending
boolean

Flag to indicate to sort Scripts in descending order

AcsApplication
string

The ACS application which the script runners must support

ForMachineId
integer <int32>

Script can only be ran on this Machine ID

Responses

Response samples

Content type
No sample

Deletes the Script with the specified Id

Sample request:

DELETE /api/scripts/2004
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Updates the Script with the specified Id

Sample request:

PUT /api/scripts/2004

{
    "name": "My Updated Script",
    "description": "My Updated Script Description",
    "type": {
        "id": 6,
    }
}
Authorizations:
Token
path Parameters
scriptId
required
integer <int32>
Request Body schema:
name
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_-]*$
required
object (SMAOpConRestApi.Controllers.Models.Scripts.UpdateScriptModel+UpdateScriptType)
description
string or null <= 4000 characters
forMachineId
integer or null <int32> >= 1

Responses

Request samples

Content type
{
  • "name": "string",
  • "type": {
    },
  • "description": "string",
  • "forMachineId": 1
}

ScriptTypes

/api/ScriptTypes

Authorizations:
Token
query Parameters
Name
string
ScriptTypeIds
Array of integers <int32> [ items <int32 > ]
IncludeCrossReferences
boolean

Flag to include a list of Scripts associated with the Script Type

IncludeReadOnlyTypes
boolean

Flag to include Script Types that are read-only and cannot be edited

Responses

Creates a new Script Type and returns it with its Id, if successful

Sample request:

POST /api/scriptTypes
        
{
    "id": 1,
    "description": "Updated description",
    "name": "PowerShell",
    "fileExtension": "ps1",
}
Authorizations:
Token
Request Body schema:
name
required
string [ 1 .. 128 ] characters
description
string or null <= 4000 characters
fileExtension
string or null <= 12 characters ^[a-zA-Z0-9]*$

Responses

Request samples

Content type
{
  • "name": "string",
  • "description": "string",
  • "fileExtension": "string"
}

Response samples

Content type
No sample

Gets the Script Type with the specified Id

Sample request:

GET /api/scriptTypes/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Deletes the Script Type with the specified Id

Sample request:

DELETE /api/scriptTypes/1
Authorizations:
Token
path Parameters
scriptTypeId
required
integer <int32>

Responses

Updates the Script Type with the specified Id

Sample request:

PUT /api/scriptTypes/1
        
{
    "id": 1,
    "description": "Updated description",
    "name": "PowerShell",
    "fileExtension": "ps1",
}
Authorizations:
Token
path Parameters
scriptTypeId
required
integer <int32>
Request Body schema:
name
required
string [ 1 .. 128 ] characters
description
string or null <= 4000 characters
fileExtension
string or null <= 12 characters ^[a-zA-Z0-9]*$

Responses

Request samples

Content type
{
  • "name": "string",
  • "description": "string",
  • "fileExtension": "string"
}

ScriptVersions

Deletes the Script Version with the specified Id

Sample request:

DELETE /api/scriptVersions/6
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Creates a new Script Version and returns it with its Id, if successful

Sample request:

POST /api/scriptVersions
        
{
    "comment": "Some comment",
    "content": "echo test",
    "scriptId": "1",
}
Authorizations:
Token
Request Body schema:
id
integer <int32> [ 0 .. 0 ]
comment
string or null <= 4000 characters
content
required
string non-empty ^[^\u001f]*$
scriptId
required
integer <int32> [ 1 .. 2147483647 ]

Responses

Request samples

Content type
{
  • "id": 0,
  • "comment": "string",
  • "content": "string",
  • "scriptId": 1
}

Response samples

Content type
No sample

ServerOptions

Gets the Server Options for OpCon

Sample request:

GET /api/serverOptions
Authorizations:
Token

Responses

Response samples

Content type
No sample

Updates the Server Option Settings

Sample request: 

PUT /api/serverOptions

{
    "enableOtto": false,
    "jobDependencyOffsetType": "Calendar Days",
    "samCalculatesJobAverages": false,
    "removePeriodInAbbreviatedMonthsAndDays": false,
    "allowWildCardsInEvents": false,
    "allowJobEventsToRestartSchedules": false,
    "failedJobsShouldKeepTheScheduleInProcess": false,
    "alternateOddAndEvenWeeks": false,
    "numberOfDaysToKeepServiceRequestExecutions": 7,
    "loggingSettings": {
        "logCriticalMessagesToNTEvents": false,
        "logJobDependencyErrorsToCritical": true,
        "maxNumberOfDaysLogsShouldBeKept": 10,
        "samMessageLoggingLevel": 0
    },
    "htmlDocumentation": {
        "rootDocUrl": ""
    },
    "passwordPolicy": {
        "minimumCharacters": 8,
        "numericRequired": true,
        "alphaRequired": true,
        "specialCharacterRequired": true,
        "repeatedCharacterOccurrencesAllowed": 2,
        "minimumNumberOfLowerCaseCharacters": 0,
        "minimumNumberOfUpperCaseCharacters": 0,
        "minimumNumberOfDaysToChangePassword": 0,
        "daysValid": 365,
        "daysBeforeExpirationToWarn": 0,
        "numberOfPasswordsToRetain": 10,
        "attemptsBeforeAccountLock": 5
    },
    "visionSettings": {
        "visionPastProcessingDays": 1,
        "visionFutureProcessingDays": 1,
        "visionHistoryDaysToKeep": 3650
    },
    "ssoSettings": {}
}
Authorizations:
Token
Request Body schema:
enableOtto
boolean or null
tlsCertificateSerialNumber
string or null
jobDependencyOffsetType
string or null
numberOfRunsIncludedInJobAverageCalculations
integer or null <int32>
samCalculatesJobAverages
boolean or null
removePeriodInAbbreviatedMonthsAndDays
boolean or null
allowWildCardsInEvents
boolean or null
allowJobEventsToRestartSchedules
boolean or null
failedJobsShouldKeepTheScheduleInProcess
boolean or null
alternateOddAndEvenWeeks
boolean or null
enableWindowsAuthentication
boolean or null
numberOfDaysToKeepServiceRequestExecutions
integer or null <int32>
object (OpCon.Api.Data.Services.OpConConfig.Models.LoggingSettings)
object (OpCon.Api.Data.Services.OpConConfig.Models.HtmlDocumentation)
emailRequired
boolean or null
object (OpCon.Api.Data.Entities.PasswordPolicy)
object (OpCon.Api.Data.Services.OpConConfig.Models.VisionSettingsApiModel)
object (OpCon.Api.Data.Services.OpConConfig.Models.SMTPSettingsApiModel)
object (OpCon.Api.Data.Services.OpConConfig.Models.TimeSettingsApiModel)
object (OpCon.Api.Data.Services.OpConConfig.Models.NotificationSettingsApiModel)
object (OpCon.Api.Data.Services.OpConConfig.Models.OperationSettings)
object (OpCon.Api.Data.Services.OpConConfig.Models.AutomaticLicenseRenewalSettingsApiModel)
solutionManagerSettings
string or null
ticketingSystemName
string or null
loginSecureMessage
string or null
object (OpCon.Api.Data.Services.Sso.SsoSettings)
customerName
string or null
customerId
string or null
systemId
string or null

Responses

Request samples

Content type
{
  • "enableOtto": true,
  • "tlsCertificateSerialNumber": "string",
  • "jobDependencyOffsetType": "string",
  • "numberOfRunsIncludedInJobAverageCalculations": 0,
  • "samCalculatesJobAverages": true,
  • "removePeriodInAbbreviatedMonthsAndDays": true,
  • "allowWildCardsInEvents": true,
  • "allowJobEventsToRestartSchedules": true,
  • "failedJobsShouldKeepTheScheduleInProcess": true,
  • "alternateOddAndEvenWeeks": true,
  • "enableWindowsAuthentication": true,
  • "numberOfDaysToKeepServiceRequestExecutions": 0,
  • "loggingSettings": {
    },
  • "htmlDocumentation": {
    },
  • "emailRequired": true,
  • "passwordPolicy": {
    },
  • "visionSettings": {
    },
  • "smtpSettings": {
    },
  • "timeSettings": {
    },
  • "notificationSettings": {
    },
  • "operationSettings": {
    },
  • "automaticLicenseRenewalSettings": {
    },
  • "solutionManagerSettings": "string",
  • "ticketingSystemName": "string",
  • "loginSecureMessage": "string",
  • "ssoSettings": {
    },
  • "customerName": "string",
  • "customerId": "string",
  • "systemId": "string"
}

Response samples

Content type
No sample

Gets the SSO Settings

Sample request:

GET /api/serverOptions/sso
Authorizations:
Token

Responses

Response samples

Content type
No sample

ServiceRequestCategories

Gets a list of Service Request Categories

Sample request:

GET /api/serviceRequestCategories
Authorizations:
Token
query Parameters
Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

IncludeServiceRequests
boolean

Flag to include Service Reuests associated with the Service Request Category

Name
string

The Service Request Category Name (Can accept ? and * wildcards)

Color
string

The Service Request Category Color (Can accept ? and * wildcards)

ServiceRequestName
string

The Service Request Name (Can accept ? and * wildcards)

Ids
string

Comma-separated list of Service Request Category Ids

SortOrder.SortBy
string
SortOrder.IdColumns
Array of strings
SortOrder.ValidSortOrders
Array of strings
SortOrder.ColumnList
Array of strings
SortOrder.SortTypeList
Array of strings
SortBy
string

Option to sort Service Request Categories by Id, Name or Color

Responses

Response samples

Content type
No sample

Creates a new Service Request Category and returns it with its Id, if successful

Sample request:

POST /api/serviceRequestCategories
Authorizations:
Token
Request Body schema:
id
integer <int32>
name
string or null
color
string or null
Array of objects or null (OpCon.Api.Data.Entities.ServiceRequest)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "color": "string",
  • "serviceRequests": [
    ]
}

Response samples

Content type
No sample

Gets the Service Request Category with the specified Id

Sample request:

GET /api/serviceRequestCategories/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Service Request Category with the specified Id

Sample request:

PUT /api/serviceRequestCategories/1
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer <int32>
name
string or null
color
string or null
Array of objects or null (OpCon.Api.Data.Entities.ServiceRequest)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "color": "string",
  • "serviceRequests": [
    ]
}

Response samples

Content type
No sample

Deletes the Service Request Category with the specified Id

Sample request:

DELETE /api/serviceRequestCategories/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

ServiceRequestExecutions

Gets a list of Service Request Executions

Sample request:

GET /api/serviceRequestExecutions
Authorizations:
Token
query Parameters
Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

IncludeServiceRequests
boolean

Flag to include Service Requests associated with the Service Request Execution

IncludeOpconResponses
boolean

Flag to include OpCon Responses associated with the Service Request Execution

IncludeUsers
boolean

Flag to include Users associated with the Service Request Execution

ServiceRequestName
string

The Service Request Name (Can accept ? and * wildcards)

LoginName
string

The User Login Name associated with the Service Request Execution (Can accept ? and * wildcards)

Ids
string

Comma-separated list of Service Request Execution Ids

ServiceRequestIds
string

Comma-separated list of Service Request Ids

ExecutionStatuses
string

Comma-separated list of Execution Statuses (Waiting, Completed Valid, Completed Invalid, In Process Invalid, In Process Valid)

LastUpdateLessThan
string

Return a list of Service Request Executions that have been updated before this date

SortOrder.SortBy
string
SortOrder.IdColumns
Array of strings
SortOrder.ValidSortOrders
Array of strings
SortOrder.ColumnList
Array of strings
SortOrder.SortTypeList
Array of strings
GroupBy
string
SortBy
string

Option to sort Service Request Executions by Id, ServiceRequestId, ServiceRequestName, ExecutionStatus or LoginName

Responses

Response samples

Content type
No sample

Creates a new Service Request Executions and returns it with its Id, if successful

Sample request:

POST /api/serviceRequestExecutions
        
{
    "name": "test",
    "documentation": "some documentation",
    "request": {
        "confirmed": true,
        "sendAsOcadm": false,
        "events": [ "$CONSOLE:DISPLAY,test" ],
        "trackEventExecutions": false,
        "variables":[]
    },
    "roles": [ { "id": 0, "name": "Role_ocadm" } ]
}
Authorizations:
Token
Request Body schema:
id
integer <int32>
executionStatus
string or null
details
string or null
submitAsOcadm
boolean or null
requestTs
string or null <date-time>
requestTimeStamp
string or null
lastUpdateTs
string or null <date-time>
lastUpdateTimeStamp
string or null
object (OpCon.Api.Data.Services.Users.User)
object (OpCon.Api.Data.Entities.ServiceRequest)
Array of objects or null (OpCon.Api.Data.Entities.OpConRequest)
Array of objects or null (OpCon.Api.Data.Entities.OpConResponse)
Array of objects or null (OpCon.Api.Data.Entities.SelfServiceVariable)
completedCount
integer or null <int32>
totalCount
integer or null <int32>
Array of objects or null (OpCon.Api.Data.Entities.EventExecution)
trackEvent
boolean

Responses

Request samples

Content type
{
  • "id": 0,
  • "executionStatus": "string",
  • "details": "string",
  • "submitAsOcadm": true,
  • "requestTs": "2019-08-24T14:15:22Z",
  • "requestTimeStamp": "string",
  • "lastUpdateTs": "2019-08-24T14:15:22Z",
  • "lastUpdateTimeStamp": "string",
  • "user": {
    },
  • "serviceRequest": {
    },
  • "opconRequests": [
    ],
  • "opconResponses": [
    ],
  • "variables": [
    ],
  • "completedCount": 0,
  • "totalCount": 0,
  • "eventExecutions": [
    ],
  • "trackEvent": true
}

Response samples

Content type
No sample

Gets the Service Request Execution for the specified Id

Sample request:

GET /api/serviceRequestExecutions/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Service Request Execution with the specified Id

PUT api/serviceRequestExecutions/1

Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer <int32>
executionStatus
string or null
details
string or null
submitAsOcadm
boolean or null
requestTs
string or null <date-time>
requestTimeStamp
string or null
lastUpdateTs
string or null <date-time>
lastUpdateTimeStamp
string or null
object (OpCon.Api.Data.Services.Users.User)
object (OpCon.Api.Data.Entities.ServiceRequest)
Array of objects or null (OpCon.Api.Data.Entities.OpConRequest)
Array of objects or null (OpCon.Api.Data.Entities.OpConResponse)
Array of objects or null (OpCon.Api.Data.Entities.SelfServiceVariable)
completedCount
integer or null <int32>
totalCount
integer or null <int32>
Array of objects or null (OpCon.Api.Data.Entities.EventExecution)
trackEvent
boolean

Responses

Request samples

Content type
{
  • "id": 0,
  • "executionStatus": "string",
  • "details": "string",
  • "submitAsOcadm": true,
  • "requestTs": "2019-08-24T14:15:22Z",
  • "requestTimeStamp": "string",
  • "lastUpdateTs": "2019-08-24T14:15:22Z",
  • "lastUpdateTimeStamp": "string",
  • "user": {
    },
  • "serviceRequest": {
    },
  • "opconRequests": [
    ],
  • "opconResponses": [
    ],
  • "variables": [
    ],
  • "completedCount": 0,
  • "totalCount": 0,
  • "eventExecutions": [
    ],
  • "trackEvent": true
}

Deletes the Service Request Execution with the specified Id

DELETE api/serviceRequestExecutions/1

Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Gets a count of Service Request Executions for the specified Field

Sample request:

GET /api/serviceRequestExecutions/count_by_{field}
Authorizations:
Token
path Parameters
field
required
string
query Parameters
Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

IncludeServiceRequests
boolean

Flag to include Service Requests associated with the Service Request Execution

IncludeOpconResponses
boolean

Flag to include OpCon Responses associated with the Service Request Execution

IncludeUsers
boolean

Flag to include Users associated with the Service Request Execution

ServiceRequestName
string

The Service Request Name (Can accept ? and * wildcards)

LoginName
string

The User Login Name associated with the Service Request Execution (Can accept ? and * wildcards)

Ids
string

Comma-separated list of Service Request Execution Ids

ServiceRequestIds
string

Comma-separated list of Service Request Ids

ExecutionStatuses
string

Comma-separated list of Execution Statuses (Waiting, Completed Valid, Completed Invalid, In Process Invalid, In Process Valid)

LastUpdateLessThan
string

Return a list of Service Request Executions that have been updated before this date

SortOrder.SortBy
string
SortOrder.IdColumns
Array of strings
SortOrder.ValidSortOrders
Array of strings
SortOrder.ColumnList
Array of strings
SortOrder.SortTypeList
Array of strings
GroupBy
string
SortBy
string

Option to sort Service Request Executions by Id, ServiceRequestId, ServiceRequestName, ExecutionStatus or LoginName

Responses

Gets a count of Self Service Request Executions based on the specified Field

GET api/selfServiceRequestExecutions/count_by_{field}

Authorizations:
Token
path Parameters
field
required
string
query Parameters
Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

IncludeServiceRequests
boolean

Flag to include Service Requests associated with the Service Request Execution

IncludeOpconResponses
boolean

Flag to include OpCon Responses associated with the Service Request Execution

IncludeUsers
boolean

Flag to include Users associated with the Service Request Execution

ServiceRequestName
string

The Service Request Name (Can accept ? and * wildcards)

LoginName
string

The User Login Name associated with the Service Request Execution (Can accept ? and * wildcards)

Ids
string

Comma-separated list of Service Request Execution Ids

ServiceRequestIds
string

Comma-separated list of Service Request Ids

ExecutionStatuses
string

Comma-separated list of Execution Statuses (Waiting, Completed Valid, Completed Invalid, In Process Invalid, In Process Valid)

LastUpdateLessThan
string

Return a list of Service Request Executions that have been updated before this date

SortOrder.SortBy
string
SortOrder.IdColumns
Array of strings
SortOrder.ValidSortOrders
Array of strings
SortOrder.ColumnList
Array of strings
SortOrder.SortTypeList
Array of strings
GroupBy
string
SortBy
string

Option to sort Service Request Executions by Id, ServiceRequestId, ServiceRequestName, ExecutionStatus or LoginName

Responses

Gets a list of Self Service Request Executions based on optional criteria specified

GET api/selfServiceRequestExecutions

Authorizations:
Token
query Parameters
Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

IncludeServiceRequests
boolean

Flag to include Service Requests associated with the Service Request Execution

IncludeOpconResponses
boolean

Flag to include OpCon Responses associated with the Service Request Execution

IncludeUsers
boolean

Flag to include Users associated with the Service Request Execution

ServiceRequestName
string

The Service Request Name (Can accept ? and * wildcards)

LoginName
string

The User Login Name associated with the Service Request Execution (Can accept ? and * wildcards)

Ids
string

Comma-separated list of Service Request Execution Ids

ServiceRequestIds
string

Comma-separated list of Service Request Ids

ExecutionStatuses
string

Comma-separated list of Execution Statuses (Waiting, Completed Valid, Completed Invalid, In Process Invalid, In Process Valid)

LastUpdateLessThan
string

Return a list of Service Request Executions that have been updated before this date

SortOrder.SortBy
string
SortOrder.IdColumns
Array of strings
SortOrder.ValidSortOrders
Array of strings
SortOrder.ColumnList
Array of strings
SortOrder.SortTypeList
Array of strings
GroupBy
string
SortBy
string

Option to sort Service Request Executions by Id, ServiceRequestId, ServiceRequestName, ExecutionStatus or LoginName

Responses

Response samples

Content type
No sample

Creates a new Self Service Request Execution and returns it with its Id, if successful

POST api/selfServiceRequestExecutions

Authorizations:
Token
Request Body schema:
id
integer <int32>
executionStatus
string or null
details
string or null
submitAsOcadm
boolean or null
requestTs
string or null <date-time>
requestTimeStamp
string or null
lastUpdateTs
string or null <date-time>
lastUpdateTimeStamp
string or null
object (OpCon.Api.Data.Services.Users.User)
object (OpCon.Api.Data.Entities.ServiceRequest)
Array of objects or null (OpCon.Api.Data.Entities.OpConRequest)
Array of objects or null (OpCon.Api.Data.Entities.OpConResponse)
Array of objects or null (OpCon.Api.Data.Entities.SelfServiceVariable)
completedCount
integer or null <int32>
totalCount
integer or null <int32>
Array of objects or null (OpCon.Api.Data.Entities.EventExecution)
trackEvent
boolean

Responses

Request samples

Content type
{
  • "id": 0,
  • "executionStatus": "string",
  • "details": "string",
  • "submitAsOcadm": true,
  • "requestTs": "2019-08-24T14:15:22Z",
  • "requestTimeStamp": "string",
  • "lastUpdateTs": "2019-08-24T14:15:22Z",
  • "lastUpdateTimeStamp": "string",
  • "user": {
    },
  • "serviceRequest": {
    },
  • "opconRequests": [
    ],
  • "opconResponses": [
    ],
  • "variables": [
    ],
  • "completedCount": 0,
  • "totalCount": 0,
  • "eventExecutions": [
    ],
  • "trackEvent": true
}

Response samples

Content type
No sample

Gets the Self Service Request Execution with the specified Id

GET api/selfServiceRequestExecutions/1

Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

ServiceRequests

/api/servicerequests

Authorizations:
Token
query Parameters
Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

IncludeRoles
boolean

Flag to include Roles associated with the Service Request

EvaluateRules
boolean

Flag to evaluate the Service Request Category rules

Name
string

The Service Request Name (Can accept ? and * wildcards)

CategoryName
string

The Service Request Category Name (Can accept ? and * wildcards)

RoleName
string

The Service Request Role Name (Can accept ? and * wildcards)

Ids
string

Comma-separated list of Service Request Ids

SortOrder.SortBy
string
SortOrder.IdColumns
Array of strings
SortOrder.ValidSortOrders
Array of strings
SortOrder.ColumnList
Array of strings
SortOrder.SortTypeList
Array of strings
SortBy
string

Option to sort Service Requests by Id, Name or CategoryName

Responses

/api/servicerequests

Authorizations:
Token
Request Body schema:
id
integer <int32>
name
string or null
documentation
string or null
html
string or null
object (OpCon.Api.Data.Entities.SelfServiceRequest)
details
string or null
object (OpCon.Api.Data.Entities.ServiceRequestControl)
disableRule
string or null
object (OpCon.Api.Data.Entities.ServiceRequestControl)
hideRule
string or null
object (OpCon.Api.Data.Entities.ServiceRequestCategory)
Array of objects or null (OpCon.Api.Data.Services.Roles.Models.Role)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "documentation": "string",
  • "html": "string",
  • "request": {
    },
  • "details": "string",
  • "disabled": {
    },
  • "disableRule": "string",
  • "hidden": {
    },
  • "hideRule": "string",
  • "serviceRequestCategory": {
    },
  • "roles": [
    ]
}

/api/servicerequests/{id}

Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

/api/servicerequests/{id}

Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer <int32>
name
string or null
documentation
string or null
html
string or null
object (OpCon.Api.Data.Entities.SelfServiceRequest)
details
string or null
object (OpCon.Api.Data.Entities.ServiceRequestControl)
disableRule
string or null
object (OpCon.Api.Data.Entities.ServiceRequestControl)
hideRule
string or null
object (OpCon.Api.Data.Entities.ServiceRequestCategory)
Array of objects or null (OpCon.Api.Data.Services.Roles.Models.Role)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "documentation": "string",
  • "html": "string",
  • "request": {
    },
  • "details": "string",
  • "disabled": {
    },
  • "disableRule": "string",
  • "hidden": {
    },
  • "hideRule": "string",
  • "serviceRequestCategory": {
    },
  • "roles": [
    ]
}

/api/servicerequests/{id}

Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

/api/selfServiceRequests/{id}

Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

/api/selfServiceRequests/{id}

Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

/api/selfServiceRequests/{id}

Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer <int32>
name
string or null
documentation
string or null
html
string or null
object (OpCon.Api.Data.Entities.SelfServiceRequest)
details
string or null
object (OpCon.Api.Data.Entities.ServiceRequestControl)
disableRule
string or null
object (OpCon.Api.Data.Entities.ServiceRequestControl)
hideRule
string or null
object (OpCon.Api.Data.Entities.ServiceRequestCategory)
Array of objects or null (OpCon.Api.Data.Services.Roles.Models.Role)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "documentation": "string",
  • "html": "string",
  • "request": {
    },
  • "details": "string",
  • "disabled": {
    },
  • "disableRule": "string",
  • "hidden": {
    },
  • "hideRule": "string",
  • "serviceRequestCategory": {
    },
  • "roles": [
    ]
}

/api/selfServiceRequests

Authorizations:
Token
query Parameters
Limit
integer <int32>

Limits the results being fetched

Offset
integer <int32>

Retrieves records beginning at this record number

IncludeRoles
boolean

Flag to include Roles associated with the Service Request

EvaluateRules
boolean

Flag to evaluate the Service Request Category rules

Name
string

The Service Request Name (Can accept ? and * wildcards)

CategoryName
string

The Service Request Category Name (Can accept ? and * wildcards)

RoleName
string

The Service Request Role Name (Can accept ? and * wildcards)

Ids
string

Comma-separated list of Service Request Ids

SortOrder.SortBy
string
SortOrder.IdColumns
Array of strings
SortOrder.ValidSortOrders
Array of strings
SortOrder.ColumnList
Array of strings
SortOrder.SortTypeList
Array of strings
SortBy
string

Option to sort Service Requests by Id, Name or CategoryName

Responses

/api/selfServiceRequests

Authorizations:
Token
Request Body schema:
id
integer <int32>
name
string or null
documentation
string or null
html
string or null
object (OpCon.Api.Data.Entities.SelfServiceRequest)
details
string or null
object (OpCon.Api.Data.Entities.ServiceRequestControl)
disableRule
string or null
object (OpCon.Api.Data.Entities.ServiceRequestControl)
hideRule
string or null
object (OpCon.Api.Data.Entities.ServiceRequestCategory)
Array of objects or null (OpCon.Api.Data.Services.Roles.Models.Role)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "documentation": "string",
  • "html": "string",
  • "request": {
    },
  • "details": "string",
  • "disabled": {
    },
  • "disableRule": "string",
  • "hidden": {
    },
  • "hideRule": "string",
  • "serviceRequestCategory": {
    },
  • "roles": [
    ]
}

SolutionManagerSettings

Gets Solution Manager settings based on optional criteria specified

Sample request:

GET /api/solutionManagerSettings
Authorizations:
Token
query Parameters
Ids
string

Comma-separated list of Solution Manager Setting Ids

Name
string

Name of the Solution Manager Setting, accepts wildcards

RoleId
integer <int32>

The Role Id associated with the Solution Manager Setting

UserId
integer <int32>

The User Id associated with the Solution Manager Setting

GlobalOnly
boolean

Flag to indicate to return global Solution Manager Settings only

Public
boolean

Flag to indicate to return public Solution Manager Settings

UserCanWrite
boolean

Flag to indicate to return Solution Manager Settings with User Can Write

Responses

Response samples

Content type
No sample

Creates new Solution Manager settings

Sample request:

POST /api/solutionManagerSettings
        
{
    "userId": 0,
    "name": "user",
    "value": "{...}",
    "userCanWrite": false,
    "public": false
}
Authorizations:
Token
Request Body schema:
id
integer <int32>

The Solution Manager Setting Id

roleId
integer or null <int32>

The Role Id associated with the Solution Manager Setting

userId
integer or null <int32>

The User Id associated with the Solution Manager Setting

name
string or null

The Name of the Solution Manager Setting

value
string or null

The value of the Solution Manager Setting

userCanWrite
boolean or null

Flag to indicate of a User can write to the Solution Manager Setting

isPublic
boolean or null

Flag to indicate if the Solution Manager Setting is public

Responses

Request samples

Content type
{
  • "id": 0,
  • "roleId": 0,
  • "userId": 0,
  • "name": "string",
  • "value": "string",
  • "userCanWrite": true,
  • "isPublic": true
}

Response samples

Content type
No sample

Gets Solution Manager settings with the specified Id

Sample request:

GET /api/solutionManagerSettings/1
Authorizations:
Token
path Parameters
id
required
string

Responses

Response samples

Content type
No sample

Updates the Solution Manager settings with the specified Id

Sample request:

PUT /api/solutionManagerSettings/1
        
{
    "id": 1,
    "userId": 0,
    "name": "user",
    "value": "{...}",
    "userCanWrite": false,
    "public": false
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer <int32>

The Solution Manager Setting Id

roleId
integer or null <int32>

The Role Id associated with the Solution Manager Setting

userId
integer or null <int32>

The User Id associated with the Solution Manager Setting

name
string or null

The Name of the Solution Manager Setting

value
string or null

The value of the Solution Manager Setting

userCanWrite
boolean or null

Flag to indicate of a User can write to the Solution Manager Setting

isPublic
boolean or null

Flag to indicate if the Solution Manager Setting is public

Responses

Request samples

Content type
{
  • "id": 0,
  • "roleId": 0,
  • "userId": 0,
  • "name": "string",
  • "value": "string",
  • "userCanWrite": true,
  • "isPublic": true
}

Response samples

Content type
No sample

Deletes the Solution Manager settings with the specified Id

Sample request:

DELETE /api/solutionManagerSettings/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

SSO

Gets a Token based on information taken from IdP access token which needs to be sent in the Headers/Authorization field

Sample request:

POST /api/sso
Authorizations:
Token

Responses

Thresholds

Updates the Threshold with the specified Id

Sample request:

PUT /api/thresholds/1

{
    "id": 1,
    "name": "T1",
    "description": "Threshold 1",
    "value": 10
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer or null <int32>

Threshold/Resource Id

name
string or null

Threshold/Resource Name

description
string or null

Threshold/Resource Description

value
integer or null <int32>

Threshold/Resource Value

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceDailyJob)

List of Daily Jobs that depend on the Threshold/Resource

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceDailyJob)

List of Daily Jobs that update the Threshold/Resource

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceMasterJob)

List of Master Jobs that depend on the Threshold/Resource

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceMasterJob)

List of Master Jobs that update the Threshold/Resource

used
integer or null <int32>

Number of times the Threshold is used

locked
boolean or null

Flag to indicate if the Threshold is locked

object (OpCon.Api.Data.Entities.LockedByDailyJob)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "value": 0,
  • "dependentDailyJobs": [
    ],
  • "updatedByDailyJobs": [
    ],
  • "dependentMasterJobs": [
    ],
  • "updatedByMasterJobs": [
    ],
  • "used": 0,
  • "locked": true,
  • "lockedByDailyJob": {
    }
}

Response samples

Content type
No sample

Gets the Threshold with the specified Id

Sample request:

GET /api/thresholds/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Deletes the Threshold with the specified Id

Sample request:

DELETE /api/thresholds/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Creates a new Threshold

Sample request:

POST /api/thresholds

{
    "name": "T1",
    "description": "Threshold 1",
    "value": 10
}
Authorizations:
Token
Request Body schema:
id
integer or null <int32>

Threshold/Resource Id

name
string or null

Threshold/Resource Name

description
string or null

Threshold/Resource Description

value
integer or null <int32>

Threshold/Resource Value

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceDailyJob)

List of Daily Jobs that depend on the Threshold/Resource

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceDailyJob)

List of Daily Jobs that update the Threshold/Resource

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceMasterJob)

List of Master Jobs that depend on the Threshold/Resource

Array of objects or null (OpCon.Api.Data.Entities.ThresholdResourceMasterJob)

List of Master Jobs that update the Threshold/Resource

used
integer or null <int32>

Number of times the Threshold is used

locked
boolean or null

Flag to indicate if the Threshold is locked

object (OpCon.Api.Data.Entities.LockedByDailyJob)

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "value": 0,
  • "dependentDailyJobs": [
    ],
  • "updatedByDailyJobs": [
    ],
  • "dependentMasterJobs": [
    ],
  • "updatedByMasterJobs": [
    ],
  • "used": 0,
  • "locked": true,
  • "lockedByDailyJob": {
    }
}

Response samples

Content type
No sample

Get a list of thresholds matching the optional provided criteria

Sample request:
GET /api/thresholds?name=T1

Authorizations:
Token
query Parameters
IncludeDependentDailyJobs
boolean

Flag to include a list of Daily Jobs dependent on the Threshold

IncludeUpdatedByDailyJobs
boolean

Flag to include a list of Thresholds updated by Daily Jobs

IncludeDependentMasterJobs
boolean

Flag to include a list of Master Jobs dependent on the Threshold

IncludeUpdatedByMasterJobs
boolean

Flag to include a list of Thresholds updated by Master Jobs

Offset
integer <int32>

Retrieves records beginning at this record number

Limit
integer <int32>

Limits the results being fetched. 0 retrieves just a count

Name
string

The Threshold Name

Value
integer <int32>

The Threshold Value

Ids
string

Comma-separated list of Threshold Ids

Description
string

Threshold description

SortBy
string

Option to sort Thresholds by Id, Name or Description in ascending (default) or descending (:desc) order

SortOrders
Array of strings

Responses

Response samples

Content type
No sample

Tokens

Gets the current user's API Token

Sample request:

GET /api/tokens
Authorizations:
Token

Responses

Response samples

Content type
No sample

Creates a new API token for the current user

Sample request:

POST /api/tokens

{
    "user": {
        "loginName": "SomeUser",
        "password": "password1234"
    },
    "tokenType": {
        "type": "User"
    }
}
Authorizations:
Token
Request Body schema:
id
string or null

The token

object (OpCon.Api.Data.Services.Users.User)
object (OpCon.Api.Data.Entities.TokenType)
validFrom
string or null <date-time>

Valid start date time of the token

validUntil
string or null <date-time>

Token expiration date time

passwordExpired
boolean

Responses

Request samples

Content type
{
  • "id": "string",
  • "user": {
    },
  • "tokenType": {
    },
  • "validFrom": "2019-08-24T14:15:22Z",
  • "validUntil": "2019-08-24T14:15:22Z",
  • "passwordExpired": true
}

Response samples

Content type
No sample

Deletes the API Token for the current user

Sample request:

DELETE /api/tokens
Authorizations:
Token

Responses

Creates a new API Token for the current user using Windows Authentication

Sample request:

POST /api/tokens/windowsAuth
Authorizations:
Token

Responses

Response samples

Content type
No sample

TriggersMetadata

Gets a list of Event Trigger types and their parameters

Sample request:

GET /api/metadata/eventTriggers
Authorizations:
Token

Responses

Response samples

Content type
No sample

Users

Get the User with the specified Id

Sample request:

GET /api/users/1
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
limit
integer or null <int32>

Limit the results being fetched

offset
integer or null <int32>

Retrieve records beginning at this record number

includeDetails
boolean

Flag to include User details

loginName
string or null

The User Login Name (Can accept ? and * wildcards)

userName
string or null

The User Name (Can accept ? and * wildcards)

roleName
string or null

The Role Name (Can accept ? and * wildcards)

selfServiceUser
boolean or null

Flag to indicate if Self Service Users should be included in the results

ids
string or null

A comma-separated list of User Ids

sortBy
string or null

Option to sort Users by Id, LoginName or UserName in ascending (default) or descending (:desc) order

Responses

Request samples

Content type
{
  • "limit": 0,
  • "offset": 0,
  • "includeDetails": true,
  • "loginName": "string",
  • "userName": "string",
  • "roleName": "string",
  • "selfServiceUser": true,
  • "ids": "string",
  • "sortBy": "string"
}

Response samples

Content type
No sample

Delete the User with the specified Id

Sample request:

DELETE /api/users/1
Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Updates the User with the specified Id

Sample request:

PUT /api/users/1

{
    "id": 1,
    "name": "Updated User",
    "loginName": "new-user",
    "roles": []
}
Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer <int32>

The User Id

loginName
string or null

The User Login Name

firstName
string or null

The User's First Name

lastName
string or null

The User's Last Name

name
string or null

The User's Full Name

password
string or null

The User's Password

passwordSalt
string or null
isPasswordReset
boolean or null

Flag to indicate the current PUT request is a Password reset - forces user to change Password at next login

externalPassword
string or null
externalHashedToken
string or null
details
string or null

The User's Notes

moreDetails
string or null

The User's Comments

ssoLogin
boolean or null

Flag to indicate if the user has logged in with SSO

Array of objects or null (OpCon.Api.Data.Services.Roles.Models.Role)

The User's Roles

phoneNumber
string or null

The User's Phone Number

modifiedBy
string or null

The User who last modified this User

modifiedOn
string or null

The date this User was last modified

language
string or null

The User's Language - English, French, German, Italian, Portuguese, Spanish

isExternalTokenDisabled
boolean or null

Flag to enable/disable the User's External Token

isDisabled
boolean or null

Flag to enable/disable the User

forcePasswordChange
boolean or null

Flag to indicate a Password change is required

email
string or null

The User's Email

numberOfFailedPasswordAttempts
integer or null <int32>

The number of failed Password attempts

passwordNeverExpires
boolean or null

Flag to indicate the User's Password never expires

lastPasswordChangeDate
string or null
lastLoggedIn
string or null

The date the User last logged in

isSelfServiceUser
boolean or null

Flag to indicate if the User has a Self-Service license

historicalPasswords
Array of strings or null
solutionManagerSettings
string or null

Solution Manager settings for the user

Responses

Request samples

Content type
{
  • "id": 0,
  • "loginName": "string",
  • "firstName": "string",
  • "lastName": "string",
  • "name": "string",
  • "password": "string",
  • "passwordSalt": "string",
  • "isPasswordReset": true,
  • "externalPassword": "string",
  • "externalHashedToken": "string",
  • "details": "string",
  • "moreDetails": "string",
  • "ssoLogin": true,
  • "roles": [
    ],
  • "phoneNumber": "string",
  • "modifiedBy": "string",
  • "modifiedOn": "string",
  • "language": "string",
  • "isExternalTokenDisabled": true,
  • "isDisabled": true,
  • "forcePasswordChange": true,
  • "email": "string",
  • "numberOfFailedPasswordAttempts": 0,
  • "passwordNeverExpires": true,
  • "lastPasswordChangeDate": "string",
  • "lastLoggedIn": "string",
  • "isSelfServiceUser": true,
  • "historicalPasswords": [
    ],
  • "solutionManagerSettings": "string"
}

Response samples

Content type
No sample

Get a list of Users based on the optional criteria specified

Sample request:

GET /api/users?sortBy=name&limit=10&offset=5
Authorizations:
Token
query Parameters
Limit
integer <int32>

Limit the results being fetched

Offset
integer <int32>

Retrieve records beginning at this record number

IncludeDetails
boolean

Flag to include User details

LoginName
string

The User Login Name (Can accept ? and * wildcards)

UserName
string

The User Name (Can accept ? and * wildcards)

RoleName
string

The Role Name (Can accept ? and * wildcards)

SelfServiceUser
boolean

Flag to indicate if Self Service Users should be included in the results

Ids
string

A comma-separated list of User Ids

SortBy
string

Option to sort Users by Id, LoginName or UserName in ascending (default) or descending (:desc) order

Responses

Response samples

Content type
No sample

Creates a new User and return it with its Id, if successful

Sample request:

POST /api/users
        
{
    "name": "New User",
    "loginName": "new-user",
    "password": "somePassword",
    "roles": []
}
Authorizations:
Token
Request Body schema:
id
integer <int32>

The User Id

loginName
string or null

The User Login Name

firstName
string or null

The User's First Name

lastName
string or null

The User's Last Name

name
string or null

The User's Full Name

password
string or null

The User's Password

passwordSalt
string or null
isPasswordReset
boolean or null

Flag to indicate the current PUT request is a Password reset - forces user to change Password at next login

externalPassword
string or null
externalHashedToken
string or null
details
string or null

The User's Notes

moreDetails
string or null

The User's Comments

ssoLogin
boolean or null

Flag to indicate if the user has logged in with SSO

Array of objects or null (OpCon.Api.Data.Services.Roles.Models.Role)

The User's Roles

phoneNumber
string or null

The User's Phone Number

modifiedBy
string or null

The User who last modified this User

modifiedOn
string or null

The date this User was last modified

language
string or null

The User's Language - English, French, German, Italian, Portuguese, Spanish

isExternalTokenDisabled
boolean or null

Flag to enable/disable the User's External Token

isDisabled
boolean or null

Flag to enable/disable the User

forcePasswordChange
boolean or null

Flag to indicate a Password change is required

email
string or null

The User's Email

numberOfFailedPasswordAttempts
integer or null <int32>

The number of failed Password attempts

passwordNeverExpires
boolean or null

Flag to indicate the User's Password never expires

lastPasswordChangeDate
string or null
lastLoggedIn
string or null

The date the User last logged in

isSelfServiceUser
boolean or null

Flag to indicate if the User has a Self-Service license

historicalPasswords
Array of strings or null
solutionManagerSettings
string or null

Solution Manager settings for the user

Responses

Request samples

Content type
{
  • "id": 0,
  • "loginName": "string",
  • "firstName": "string",
  • "lastName": "string",
  • "name": "string",
  • "password": "string",
  • "passwordSalt": "string",
  • "isPasswordReset": true,
  • "externalPassword": "string",
  • "externalHashedToken": "string",
  • "details": "string",
  • "moreDetails": "string",
  • "ssoLogin": true,
  • "roles": [
    ],
  • "phoneNumber": "string",
  • "modifiedBy": "string",
  • "modifiedOn": "string",
  • "language": "string",
  • "isExternalTokenDisabled": true,
  • "isDisabled": true,
  • "forcePasswordChange": true,
  • "email": "string",
  • "numberOfFailedPasswordAttempts": 0,
  • "passwordNeverExpires": true,
  • "lastPasswordChangeDate": "string",
  • "lastLoggedIn": "string",
  • "isSelfServiceUser": true,
  • "historicalPasswords": [
    ],
  • "solutionManagerSettings": "string"
}

Response samples

Content type
No sample

Force all Users to reset their password at their next logon

Sample request:

PUT /api/users/resetPassword
Authorizations:
Token

Responses

Version

Gets the API version

Sample request:

GET /api/version
Authorizations:
Token

Responses

Response samples

Content type
No sample

VisionActions

Gets a list of Vision Actions based on optional criteria specified

Authorizations:
Token
query Parameters
Ids
string

A comma-separated list of Action Ids

Name
string

The Action Name (Can accept ? and * wildcards)

Responses

Response samples

Content type
No sample

Creates a new Vision Action

Authorizations:
Token
Request Body schema:
id
integer <int32>

The Action Id

name
string or null

The Action Name

Array of objects or null (OpCon.Api.Data.Entities.VisionActionDetail)

A list of Action details

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "actionDetails": [
    ]
}

Response samples

Content type
No sample

Gets a Vision Action based on the specified Id

Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Vision Action with the specified Id

Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer <int32>

The Action Id

name
string or null

The Action Name

Array of objects or null (OpCon.Api.Data.Entities.VisionActionDetail)

A list of Action details

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "actionDetails": [
    ]
}

Response samples

Content type
No sample

Deletes the Vision Action with the specified Id

Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

VisionCardAnomalies

Gets Vision Card Anomalies based on the optional criteria specified

Authorizations:
Token
query Parameters
Ids
string

Comma-separated list of Vision History Ids

From
string

The start date represented in the % QoS Failure(s) and % SLA Failure(s) frames.

To
string

The end date represented in the % QoS Failure(s) and % SLA Failure(s) frames.

CardIds
string

The Card Ids

ExcludeQos
boolean

Flag to exclude QoS (Quality of Service)

ExcludeSla
boolean

Flag to exclude SLA (Service Level Agreement)

Array of objects (OpCon.Api.Data.Contexts.CardTrackId)

List of Vision card Track Ids

Responses

Response samples

Content type
No sample

VisionCards

Gets a Vision Card by Workspace Id and Card Id

Authorizations:
Token
path Parameters
id
required
integer <int32>
cardId
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Vision Card with the specified Id and Workspace Id

Authorizations:
Token
path Parameters
id
required
integer <int32>
cardId
required
integer <int32>
Request Body schema:
id
integer <int32>

The Master Vision Card Id

version
integer <int32>

The Master Vision Card Version

trackId
string or null

The Track Id in GUID format

trackIdInternal
string or null <uuid>
name
string or null

The Master Vision Card Name

description
string or null

The Master Vision Card Description

tagPattern
string or null

The Tag Pattern

offset
integer <int32>

The offset in days, +/- 5 days, of the Schedule date on which Vision has to look for Jobs

qosTolerableThreshold
integer or null <int32>

Defines the value to indicate the QoS tolerable threshold (0 - 100)

qosCriticalThreshold
integer or null <int32>

Defines the value to indicate the QoS critical threshold (0 - 100)

slaTolerableThreshold
integer or null <int32>

Defines the value to indicate the SLA tolerable threshold (0 - 100)

slaCriticalThreshold
integer or null <int32>

Defines the value to indicate the SLA critical threshold (0 - 100)

remoteInstanceId
integer or null <int32>
remoteInstanceName
string or null
object (OpCon.Api.Data.Entities.RemoteInstance)
parentMasterVisionCard
object (OpCon.Api.Data.Entities.MasterVisionCard) Recursive
parentId
integer <int32>
Array of objects or null (OpCon.Api.Data.Entities.MonitoredVisionFrequency)

A list of Frequencies associated with the Master Vision Card

roleId
integer or null <int32>
roleName
string or null
Array of objects or null (OpCon.Api.Data.Services.Roles.Models.Role)

A list of Roles assigned to the Master Vision Card

children
Array of objects or null (OpCon.Api.Data.Entities.MasterVisionCard)

A list of child Cards assigned to the Master Vision Card

Responses

Request samples

Content type
{
  • "id": 0,
  • "version": 0,
  • "trackId": "string",
  • "trackIdInternal": "a286c8f6-fa07-448e-953e-cbd6ca854a46",
  • "name": "string",
  • "description": "string",
  • "tagPattern": "string",
  • "offset": 0,
  • "qosTolerableThreshold": 0,
  • "qosCriticalThreshold": 0,
  • "slaTolerableThreshold": 0,
  • "slaCriticalThreshold": 0,
  • "remoteInstanceId": 0,
  • "remoteInstanceName": "string",
  • "remoteInstance": {
    },
  • "parentMasterVisionCard": { },
  • "parentId": 0,
  • "associatedFrequencies": [
    ],
  • "roleId": 0,
  • "roleName": "string",
  • "associatedRoles": [
    ],
  • "children": [
    ]
}

Response samples

Content type
No sample

Creates a Vision Card and returns it with its Id, if successful

Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer <int32>

The Master Vision Card Id

version
integer <int32>

The Master Vision Card Version

trackId
string or null

The Track Id in GUID format

trackIdInternal
string or null <uuid>
name
string or null

The Master Vision Card Name

description
string or null

The Master Vision Card Description

tagPattern
string or null

The Tag Pattern

offset
integer <int32>

The offset in days, +/- 5 days, of the Schedule date on which Vision has to look for Jobs

qosTolerableThreshold
integer or null <int32>

Defines the value to indicate the QoS tolerable threshold (0 - 100)

qosCriticalThreshold
integer or null <int32>

Defines the value to indicate the QoS critical threshold (0 - 100)

slaTolerableThreshold
integer or null <int32>

Defines the value to indicate the SLA tolerable threshold (0 - 100)

slaCriticalThreshold
integer or null <int32>

Defines the value to indicate the SLA critical threshold (0 - 100)

remoteInstanceId
integer or null <int32>
remoteInstanceName
string or null
object (OpCon.Api.Data.Entities.RemoteInstance)
parentMasterVisionCard
object (OpCon.Api.Data.Entities.MasterVisionCard) Recursive
parentId
integer <int32>
Array of objects or null (OpCon.Api.Data.Entities.MonitoredVisionFrequency)

A list of Frequencies associated with the Master Vision Card

roleId
integer or null <int32>
roleName
string or null
Array of objects or null (OpCon.Api.Data.Services.Roles.Models.Role)

A list of Roles assigned to the Master Vision Card

children
Array of objects or null (OpCon.Api.Data.Entities.MasterVisionCard)

A list of child Cards assigned to the Master Vision Card

Responses

Request samples

Content type
{
  • "id": 0,
  • "version": 0,
  • "trackId": "string",
  • "trackIdInternal": "a286c8f6-fa07-448e-953e-cbd6ca854a46",
  • "name": "string",
  • "description": "string",
  • "tagPattern": "string",
  • "offset": 0,
  • "qosTolerableThreshold": 0,
  • "qosCriticalThreshold": 0,
  • "slaTolerableThreshold": 0,
  • "slaCriticalThreshold": 0,
  • "remoteInstanceId": 0,
  • "remoteInstanceName": "string",
  • "remoteInstance": {
    },
  • "parentMasterVisionCard": { },
  • "parentId": 0,
  • "associatedFrequencies": [
    ],
  • "roleId": 0,
  • "roleName": "string",
  • "associatedRoles": [
    ],
  • "children": [
    ]
}

Response samples

Content type
No sample

Deletes the Vision Card with the specified Id, Version, and Workspace Id

Authorizations:
Token
path Parameters
id
required
integer <int32>
cardId
required
integer <int32>
version
required
integer <int32>

Responses

VisionCardStatistics

Get Vision Card statistics based on the optional criteria specified

Authorizations:
Token
query Parameters
Ids
string

Comma-separated list of Vision History Ids

From
string

The start date represented in the % QoS Failure(s) and % SLA Failure(s) frames.

To
string

The end date represented in the % QoS Failure(s) and % SLA Failure(s) frames.

CardIds
string

The Card Ids

ExcludeQos
boolean

Flag to exclude QoS (Quality of Service)

ExcludeSla
boolean

Flag to exclude SLA (Service Level Agreement)

Array of objects (OpCon.Api.Data.Contexts.CardTrackId)

List of Vision card Track Ids

Responses

Response samples

Content type
No sample

VisionFrequencies

Gets a list of Vision Frequencies

Authorizations:
Token
query Parameters
Ids
string

Comma-separated list of Vision Frequency Ids

Name
string

The Vision Frequency Name

Responses

Response samples

Content type
No sample

Create a new Vision Frequency and returns it with its Id, if successful

Authorizations:
Token
Request Body schema:
id
integer <int32>

The Vision Frequency Id

name
string or null

The Vision Frequency Name

description
string or null

The Vision Frequency Description

type
integer or null <int32>

The Vision Frequency Type. 0 = dates included (default); 1 = dates excluded

dates
Array of strings or null

A list of dates

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "type": 0,
  • "dates": [
    ]
}

Response samples

Content type
No sample

Gets a Vision Frequency with the specified Id

Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

Updates the Vision Frequency with the specified Id

Authorizations:
Token
path Parameters
id
required
integer <int32>
Request Body schema:
id
integer <int32>

The Vision Frequency Id

name
string or null

The Vision Frequency Name

description
string or null

The Vision Frequency Description

type
integer or null <int32>

The Vision Frequency Type. 0 = dates included (default); 1 = dates excluded

dates
Array of strings or null

A list of dates

Responses

Request samples

Content type
{
  • "id": 0,
  • "name": "string",
  • "description": "string",
  • "type": 0,
  • "dates": [
    ]
}

Response samples

Content type
No sample

Deletes the Vision Frequency with the specified Id

Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

VisionJobAnomalies

Gets Vision Job Anomalies based on optional criteria specified

Authorizations:
Token
query Parameters
VisionCardAnomalyId
integer <int64>

The Vision Card Anomaly Id

VisionCardAnomalyIds
string

A comma-separated list of Vision Card Anomaly Ids

ScheduleDate
string <date-time>

The Schedule Date

TagPattern
string

The Tag Pattern

StartedLate
boolean

Flag to include Jobs that started late

EndedLate
boolean

Flag to include Jobs that ended late

ExpectedStartTime
string <date-time>

The expected Job Start Time

ExpectedEndTime
string <date-time>

The expected Job End Time

ActualStartTime
string <date-time>

The actual Job Start Time

ActualEndTime
string <date-time>

The actual Job End Time

Responses

Response samples

Content type
No sample

VisionStatistic

Get a list of Vision Statistics

Authorizations:
Token
query Parameters
Ids
string

Comma-separated list of Vision History Ids

From
string

The start date represented in the % QoS Failure(s) and % SLA Failure(s) frames.

To
string

The end date represented in the % QoS Failure(s) and % SLA Failure(s) frames.

CardIds
string

The Card Ids

ExcludeQos
boolean

Flag to exclude QoS (Quality of Service)

ExcludeSla
boolean

Flag to exclude SLA (Service Level Agreement)

Array of objects (OpCon.Api.Data.Contexts.CardTrackId)

List of Vision card Track Ids

Responses

Response samples

Content type
No sample

VisionStats

Get a list of remote Vision Statistics based on optional criteria specified

Authorizations:
Token
query Parameters
Ids
string

Comma-separated list of Remote Vision Stats Ids

Responses

Response samples

Content type
No sample

Get a list of remote Vision Statistics with the specified Id

Authorizations:
Token
path Parameters
id
required
integer <int32>

Responses

Response samples

Content type
No sample

ZOs

/api/zos/jcl/{machId}

Authorizations:
Token
path Parameters
machId
required
integer <int32>
query Parameters
Dd
string

The override DD name or DD name for JCL

MemberName
string

The job name, or temporary member name, or member name for JCL

Data
string

Responses

Response samples

Content type
No sample

Updates JCL data for a DD and Member pair from a machine. A connection will be made to the given mach id based on its JORS port and IP Address

Sample request:

PUT /api/zos/jcl/5

{ "dd": "FOO", "memberName": "BAR", "data": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt" }

Authorizations:
Token
path Parameters
machId
required
integer <int32>
Request Body schema:
dd
string or null

The override DD name or DD name for JCL

memberName
string or null

The job name, or temporary member name, or member name for JCL

data
string or null

The JCL data retrieved for the given DD and Member

userName
string or null

The JCL data retrieved for the given DD and Member

response
string or null

Save Response from saving JCL to the Server.

Responses

Request samples

Content type
{
  • "dd": "string",
  • "memberName": "string",
  • "data": "string",
  • "userName": "string",
  • "response": "string"
}

Response samples

Content type
No sample