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: