Create a public file system
Creates a public file system (a "release") with a secure token for sharing project assets publicly without authentication. `itemPaths` are relative to `project/{projectId}/creator`. Requires `canCreatePublicFileSystem`. Gated by the `publicSharing` workspace capability — granted by every paid base plan and intentionally withheld from the Demo plan. Requests from workspaces without the capability return 403 `capabilityNotAvailable` with `errorData.capability = "publicSharing"`; clients can use this to prompt the user to upgrade their plan.
Creates a public file system (a "release") with a secure token for sharing project assets publicly without authentication. itemPaths are relative to project/{projectId}/creator. Requires canCreatePublicFileSystem.
Gated by the publicSharing workspace capability — granted by every paid base plan and intentionally withheld from the Demo plan. Requests from workspaces without the capability return 403 capabilityNotAvailable with errorData.capability = "publicSharing"; clients can use this to prompt the user to upgrade their plan.
Authorization
bearerAuth In: header
Path Parameters
Unique ID of the project.
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/public" \ -H "Content-Type: application/json" \ -d '{ "title": "Client review – round 1" }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "ownerResourceType": "project", "ownerResourceId": "7d5ad1db-89f9-42df-868c-86a72347ae1c", "token": "string", "title": "string", "description": "string", "inventory": { "image": 12, "video": 2, "folder": 3 }, "status": "active", "expires": "2019-08-24T14:15:22Z", "hideCreators": true, "allowAnonymousComments": true, "creatorId": "688ebf54-d343-4104-8711-82c2feac534a", "creator": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "firstName": "string", "middleName": "string", "lastName": "string", "company": "string", "userName": "string", "displayName": "string", "avatarId": "ac572b6e-802b-4b9e-a602-0786d4441e67", "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779", "color": "#ffffff", "email": "user@example.com", "isEmailVerified": false, "hasPassword": false, "allowOauthAutolink": true, "mfaEnabled": false, "mfaType": "totp", "status": "active", "accountType": "standard", "globalRoles": [ "string" ], "preferences": {}, "language": "en", "externalIds": {}, "lastSeen": "2019-08-24T14:15:22Z", "hasUsedTrial": false, "hasUsedDemo": false, "hasSeen": [ "string" ], "awards": [ "staff" ], "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }, "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}