Environment properties

Use the following endpoints to manage Environments programmatically:

Quick reference

Type	Resource	Description
GET	/api/managed_users/:managed_user_id/properties	Returns a list of environment properties belonging to a customer that matches a prefix.
POST	/api/managed_users/:managed_user_id/properties	Upserts environment properties to a customer workspace.

List properties by prefix

Returns a list of environment properties belonging to a customer that matches a prefix. For example, if the prefix provided is salesforce_sync., any account property with a name beginning with 'salesforce_sync.' is returned.

GET /api/managed_users/:managed_user_id/properties

URL Parameters

Name	Type	Description
managed_user_id	string required	Embedded customer ID/external ID. External ID must be prefixed with an E (for example, EA2300) and the resulting ID should be URL encoded.
prefix	string required	Return properties with the given prefix. For example: salesforce_sync..

Sample request

curl  -X GET 'https://www.workato.com/api/managed_users/19029/properties?prefix=salesforce_sync.' \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \

Response

{
    "result": {
        "salesforce_sync.object_name": "Account",
        "salesforce_sync.object_field": "Id"
    }
}

Upsert property

Upserts environment properties to a customer workspace. Matches by the names of the properties provided in the request.

POST /api/managed_users/:managed_user_id/properties

PROPERTY LIMITS

Environment properties have the following limitations:

• The maximum number of environment properties is 1000 per workspace.
• Property names have a maximum length of 100 characters.
• Property values have a maximum length of 1024 characters.

Parameters

Name	Type	Description
managed_user_id	string required	Embedded customer ID/external ID. External ID must be prefixed with an E (for example, EA2300) and the resulting ID should be URL encoded.

Payload

Name	Type	Description
properties	Hash required	Contains the names and values of the properties to upsert.

Sample request

curl  -X POST https://www.workato.com/api/managed_users/19029/properties \
      -H 'Authorization: Bearer <api_token>' \
      -H 'Content-Type: application/json' \
      -d '{ "properties": { "zendesk.object": "Ticket", "zendesk.key": "ticket_id" }}'

Response

{
  "success": true
}