Environment properties

Use the following endpoints to manage Environments programmatically:

Rate limits

Environment property resources have the following rate limits:

Quick reference

TypeResourceDescription
GET/api/managed_users/:managed_user_id/propertiesReturns a list of environment properties belonging to a customer that matches a prefix.
POST/api/managed_users/:managed_user_id/propertiesUpserts 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

NameTypeDescription
managed_user_idstring
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.
prefixstring
required
Return properties with the given prefix. For example: salesforce_sync..

Sample request

shell
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

json
{
    "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 limits:

Parameters

NameTypeDescription
managed_user_idstring
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

NameTypeDescription
propertiesHash
required
Contains the names and values of the properties to upsert.

Sample request

shell
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

json
{
  "success": true
}

Last updated: