Skip to content

Create a guest upload

Request

Create a new GuestUpload URL, to share with a guest to upload files to a specified folder

Security
bearerToken
Bodyapplication/jsonrequired
folderFieldOptionIdstringrequired

The unique ID of the Folder where guest files are uploaded when this GuestUpload URL is used

Example:"c4e146aa3-543a-4d58-bf99-0d33cf73e942"
namestringrequired

A human readable name for the GuestUpload URL

Example:"Social media Content"
messagestring or null

Optional message shown to anyone that visits the GuestUpload URL

Example:"Please upload your favourite social media pics for approval"
messageHeadingstring or null

Optional message header shown to anyone that visits the GuestUpload URL

Example:"Social media uploads"
curl -i -X POST \
  https://api-v2.dash.app/guest-uploads \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "folderFieldOptionId": "c4e146aa3-543a-4d58-bf99-0d33cf73e942",
    "name": "Social media Content",
    "message": "Please upload your favourite social media pics for approval",
    "messageHeading": "Social media uploads"
  }'

Responses

Success

Bodyapplication/json
resultobjectrequired
permittedActionsArray of objectsrequired
Response
{
  "result": {
    "id": "55f9964c-095d-4b8b-bb5e-4118d2e76ad0",
    "accountId": "cfb665ca-ce35-4418-b9d5-70ee815db4bd",
    "folderFieldOptionId": "c4e146aa3-543a-4d58-bf99-0d33cf73e942",
    "name": "Social media Content",
    "currentSlug": "puaon-social-media-content",
    "slugs": [ … ],
    "message": "Please upload your favourite social media pics for approval",
    "messageHeading": "Social media uploads"
  },
  "permittedActions": [
    { … }
  ]
}