Project properties
Use the following endpoints to manage project properties programmatically.
Rate limits
Project property resources have the following rate limits:
Quick reference
| Type | Resource | Description |
|---|---|---|
| GET | /api/properties | List project-level properties that match a prefix and project ID. |
| POST | /api/properties | Upsert 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/propertiesQuery parameters
| Name | Type | Description |
|---|---|---|
| prefix | string 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_id | string 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
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
{
"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/propertiesPROPERTY LIMITS
Project properties have the following limits:
Query parameters
| Name | Type | Description |
|---|---|---|
| project_id | string 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
| Name | Type | Description |
|---|---|---|
| properties | Hash required | Contains the names and values of the properties you plan to upsert. |
Sample request
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
{
"success": true
}Last updated: