| Field | Type | Required | Description |
|---|---|---|---|
provider | String! | Yes | Storage provider accessed through the caller’s own personal connection. A human caller is required; agent, run, and service-account credentials are refused. |
projectReference | String | No | Project ID or slug. Requires project.integrations.connect through the caller’s own personal provider connection. |
folderId | String | No | Parent folder item ID or root. |
parentId | String | No | |
name | String! | Yes | |
idempotencyKey | String | No | 1-128 characters without whitespace. A retry with the same key and input within 24 hours returns the first folder. |