GET
/
api
/
v1
/
folders
curl --request GET \
  --url https://us.infisical.com/api/v1/folders \
  --header 'Authorization: Bearer <token>'
{
  "folders": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "version": 1,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "envId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "parentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "isReserved": false,
      "description": "<string>",
      "lastSecretModified": "2023-11-07T05:31:56Z",
      "relativePath": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

An access token in Infisical

Query Parameters

​
workspaceId
string
required

The ID of the project to list folders from.

​
environment
string
required

The slug of the environment to list folders from.

​
lastSecretModified
string

The timestamp used to filter folders with secrets modified after the specified date. The format for this timestamp is ISO 8601 (e.g. 2025-04-01T09:41:45-04:00)

​
path
string
default:/

The path to list folders from.

​
directory
string
default:/

The directory to list folders from. (Deprecated in favor of path)

​
recursive
default:false

Whether or not to fetch all folders from the specified base path, and all of its subdirectories.

Response

200
application/json
Default Response
​
folders
object[]
required

Was this page helpful?

Suggest editsRaise issue