# On-premise API

Workato API allows you to work with On-prem Groups and On-prem Agents through the API.

# Quick reference

Type Resource Description
GET /api/on_prem_groups List On-prem groups.
POST /api/on_prem_groups Create On-prem group.
GET /api/on_prem_groups/:id Get On-prem group details.
PUT /api/on_prem_groups/:id Update On-prem group.
DELETE /api/on_prem_groups/:id Delete an On-prem group.
GET /api/on_prem_groups/:id/status Get On-prem group status.
GET /api/on_prem_agents List On-prem agents.
POST /api/on_prem_agents Create On-prem agent.
GET /api/on_prem_agents/:id Get On-prem agent details.
PUT /api/on_prem_agents/:id Update On-prem agent.
DELETE /api/on_prem_agents/:id List On-prem agents.
GET /api/on_prem_agents/:id/status Get On-prem agent status.
GET /api/on_prem_agents/search Search for On-prem agent.

# List On-prem Groups

List all On-prem groups in your workspace.

GET /api/on_prem_groups

# Response

[
  {
    "id": 16803,
    "name": "CRM server",
    "created_at": "2017-09-21T01:51:45.954-07:00"
  }
]

# Create On-prem Group

Create an On-prem group.

POST /api/on_prem_groups

# Payload

Name Type Description
name string
The On-prem group name.

# Sample request

curl  -X POST 'https://www.workato.com/api/on_prem_groups' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d  '{
             "name":"CRM server"
          }'

# Response

[
  {
    "id": 16803,
    "name": "CRM server",
    "created_at": "2017-09-21T01:51:45.954-07:00"
  }
]

# Get On-prem Group details

Get details about an On-prem group.

GET /api/on_prem_groups/:id

# URL parameters

Name Type Description
id integer
On-prem group ID.

# Response

[
  {
    "id": 16803,
    "name": "CRM server",
    "created_at": "2017-09-21T01:51:45.954-07:00"
  }
]

# Update On-prem Group

Update an On-prem group.

PUT /api/on_prem_groups/:id

# URL parameters

Name Type Description
id integer
On-prem group ID.

# Payload

Name Type Description
name string
The On-prem group name.

# Sample request

curl  -X PUT 'https://www.workato.com/api/on_prem_groups/16803' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d  '{
             "name":"CRM server"
          }'

# Response

[
  {
    "id": 16803,
    "name": "CRM server",
    "created_at": "2017-09-21T01:51:45.954-07:00"
  }
]

# Delete On-prem Group

Delete an On-prem group. All on-prem agents in this group will be deleted.

DELETE /api/on_prem_groups/:id

# URL parameters

Name Type Description
id integer
On-prem group ID.

# Response

{
  "success": true
}

# Get On-prem Group status

Get the status of an On-prem group.

GET /api/on_prem_groups/:id/status

# URL parameters

Name Type Description
id integer
On-prem group ID.

# Response

{
  "agent_count": 4,
  "active_agent_count": 3,
  "profiles": [
    {
      "name": "CRM-Oracle",
      "provider": "oracle",
      "type": "Database",
      "connections": [
        {
          "id": 440724,
          "name": "Oracle CRM DB"
        }
      ]
    }
  ]
}

# List On-prem Agents

List all On-prem agents in your workspace.

GET /api/on_prem_agents

# Response

[
  {
    "id": 12233,
    "on_prem_group_id": 16803,
    "name": "primary agent",
    "cn": "134fd7acd89cf5b8b96deea4870d413d:12233",
    "os": "windows",
    "awaiting_setup": true,
    "enabled": true
  }
]

# Response schema

Name Description
name The On-prem agent name.
os The server operating system. Available OS are windows, linux, and mac
on_prem_group_id The On-prem group ID.
awaiting_setup True if agent is not configured.
enabled True if agent is enabled.

# Create On-prem Agent

Create an On-prem agent.

POST /api/on_prem_agents

# Payload

Name Type Description
name string
The On-prem agent name.
os string
The server operating system.
on_prem_group_id integer
The On-prem group ID. See List On-prem groups.
awaiting_setup boolean
optional
true if agent should be created in awaiting setup state. Set to false to skip agent setup and get its status right away.

# Sample request

curl  -X POST 'https://www.workato.com/api/on_prem_agents' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d  '{
              "name": "US-west-1",
              "on_prem_group_id": 50,
              "os": "windows",
              "awaiting_setup": false
           }'

# Response

[
  {
    "id": 12233,
    "on_prem_group_id": 16803,
    "name": "primary agent",
    "cn": "134fd7acd89cf5b8b96deea4870d413d:12233",
    "os": "windows",
    "awaiting_setup": false,
    "enabled": true
  }
]

# Get On-prem Agent details

Get details of an On-prem agent.

GET /api/on_prem_agents/:id

# URL parameters

Name Type Description
id integer
On-prem agent ID.

# Response

[
  {
    "id": 12233,
    "on_prem_group_id": 16803,
    "name": "primary agent",
    "cn": "134fd7acd89cf5b8b96deea4870d413d:12233",
    "os": "windows",
    "awaiting_setup": false,
    "enabled": true
  }
]

# Update On-prem Agent

Update an On-prem agent.

PUT /api/on_prem_agents/:id

# URL parameters

Name Type Description
id integer
On-prem agent ID.

# Payload

Name Type Description
name string
The On-prem agent name.
os string
The server operating system.
on_prem_group_id integer The On-prem group ID. See List On-prem groups.

# Sample request

curl  -X POST 'https://www.workato.com/api/on_prem_agents/12233' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d  '{
              "name": "primary agent"d
           }'

# Response

[
  {
    "id": 12233,
    "on_prem_group_id": 16803,
    "name": "primary agent",
    "cn": "134fd7acd89cf5b8b96deea4870d413d:12233",
    "os": "windows",
    "awaiting_setup": false,
    "enabled": true
  }
]

# Delete On-prem Agent

Delete an On-prem agent.

DELETE /api/on_prem_agents/:id

# URL parameters

Name Type Description
id integer
On-prem agent ID.

# Response

{
  "success": true
}

# Get On-prem Agent status

Get status of an On-prem agent.

GET /api/on_prem_agents/:id/status

# URL parameters

Name Type Description
id integer
On-prem agent ID.

# Response

{
  "active": true
}

# Search for On-prem Agent by common name

Get On-prem agents that matches a common name.

GET /api/on_prem_agents/search

# URL parameters

Name Type Description
cn string
Common name of on-prem agent.

# Response

[
  {
    "id": 12233,
    "on_prem_group_id": 16803,
    "name": "primary agent",
    "cn": "134fd7acd89cf5b8b96deea4870d413d:12233",
    "os": "windows",
    "awaiting_setup": false,
    "enabled": true
  }
]


Last updated: 7/18/2023, 1:18:37 AM