Project properties ​

Use the following endpoints to manage project properties programmatically.

Rate limits ​

Project property resources have the following rate limits:

Quick reference ​

TypeResourceDescription
GET/api/propertiesList project-level properties that match a prefix and project ID.
POST/api/propertiesUpsert project-level properties.

List project properties ​

Returns a list of project-level properties belonging to a specific project in a customer workspace that matches a project_id you specify. You must also include a prefix. For example, if you provide the prefix salesforce_sync., any project property with a name beginning with salesforce_sync., such as salesforce_sync.admin_email, with the project_id you provided is returned.

GET /api/properties

Query parameters ​

NameTypeDescription
prefixstring
required
Returns properties that contain the prefix you provided. For example, if the prefix is salesforce_sync. the property salesforce_sync.admin_email is returned.
project_idstring
required
Returns project-level properties that match the project_id you specify. If this parameter is not present, this call returns environment properties.

Sample request ​

shell
curl  -X GET 'https://www.workato.com/api/properties?prefix=salesforce_sync.&project_id=523144' \
      -H 'Authorization: Bearer <token>' \
      -H 'Content-Type: application/json'

Response ​

json
{
  "public_url": "https://www.example.com",
  "admin_email": "jude.feeney@example.com"
}

Upsert project properties ​

Upserts project properties belonging to a specific project in a customer workspace that matches a project_id you specify. This endpoint maps to properties based on the names you provide in the request.

POST /api/properties

PROPERTY LIMITS

Project properties have the following limits:

Query parameters ​

NameTypeDescription
project_idstring
required
Provide the project ID that contains the project properties you plan to upsert. If this parameter is not present, this call upserts environment properties.

Payload ​

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

Sample request ​

shell
curl  -X POST 'https://www.workato.com/api/properties?project_id=523144' \
      -H 'Authorization: Bearer <token>' \
      -H 'Content-Type: application/json' \
      -d '{ "properties": { "admin_email": "lucy.carrigan@example.com", "public_url": "https://www.example.com" }}'

Response ​

json
{
  "success": true
}

Last updated: