REST API Object Lookup Fallback to Client 0 Behavior in Automic Automation

Products

• Automic Automation

Issue/Introduction

When using the GET /{client_id}/objects/{object_name} REST API endpoint, you may observe that if an object does not exist in the target client, the system returns the object from Client 0 (if it exists). This article explains the design intent behind this behavior and how to configure it.

Environment

Automic Automation (Automation Engine)

Cause

The GET object REST API endpoint is designed to maintain consistency with the Automation Engine Java API and scripting functions. By default, the system allows a fallback to Client 0 to retrieve objects if they are not found in the target client.

Resolution

 If you wish to prevent the API from falling back to Client 0 and instead receive a 404 error when an object is not found in the target client, perform the following steps:

1. Log in to the Automic Web Interface (AWI) with an administrator account to the client 0.
2. Open the DIV_VARIABLES folder.
3. Locate and open the UC_SYSTEM_SETTINGS object.
4. Set the OBJECT_ACCESS_CLIENT_ZERO variable to N.
5. Save the object.

Additional Information

For further details on system variables and configuration, refer to the official Automic Automation documentation.