See Stacksync in action with a solution architect. Book a demo ↗
StacksyncDocs
StacksyncCommunityBook a demoContact Support
HomeTwo-way syncAgentic WorkflowsGeniesEnterprise OSMCPEDIConnectorsSecurity and Other ResourcesChangelogDevelopersAPI Reference
Folders

Folders

List the resources in a folder

GET
/v1/workspaces/{workspace_id}/folders/{folder_id}/resources

What the folder holds, sub-folders included. limit and offset apply to each resource type.

Authorization

Authorizationstringheaderrequired

Bearer <key>, where <key> is a workspace API key or a user API key. See Authentication.

Path Parameters

workspace_id*integer

The workspace. List the ones your key can reach with GET /v1/workspaces.

folder_id*string

The folder.

Formatuuid

Query Parameters

region*Regions

Region of the resource: besg (Europe) or usnv (United States), as GET /v1/regions lists them

Value in"besg""usnv"
limit?Limit

Maximum number of items returned, at most 200

Range1 <= value <= 200
Default50
offset?Offset

Number of items skipped before the first one returned

Range0 <= value
Default0
resource_types?array<>|

Only these resource types; all types when absent

Defaultnull
search?|

Only resources whose name or id contains this text, searched in sub-folders too

Defaultnull

Response Body

OK

application/json
  1. response

The resources of a folder, page by page: limit and offset apply to each resource type, as the web app pages each section of a folder; has_more tells whether any type has more

data*array<>
has_more*Has More

Whether more items follow this page: request the next one with offset + limit

limit*Limit
offset*Offset
total_count*Total Count

How many resources of the requested types the folder holds (the matches of a search), across every page

List the resources in a folder
curl -X GET 'https://api.stacksync.com/v1/workspaces/0/folders/497f6eca-6276-4993-bfeb-53cbbbba6f08/resources?region=besg'
{  "data": [    {      "resource_type": "connection",      "resource_id": "<resource_id>",      "resource_name": "<resource_name>",      "status": "<status>",      "region": "besg",      "apps": [        "<apps>"      ],      "parent_folder_id": "<parent_folder_id>",      "last_modified_time": "2027-01-15T09:00:00Z"    }  ],  "has_more": false,  "limit": 0,  "offset": 0,  "total_count": 0}

DELDelete a variable

Delete a variable or secret; workflow steps referencing it no longer resolve it.

GETList the resources at the root

The workflows, syncs, connections, genies, knowledge bases, queues, variables, API proxies and folders at the root of the workspace. `limit` and `offset` apply to each resource type.