API Reference

file.createFileUploadHandle

post
https://api.ashbyhq.com/file.createFileUploadHandle

Creates a presigned upload URL that allows uploading a file directly to storage, bypassing the need to send file bytes through the API.

The presigned URL expires after 10 minutes. Use CandidateResume for resumes, CandidateFiles for candidate files, ApplicationForm for application form file fields, or ApplicationFeedbackImage for inline feedback images. Pass feedback image handles directly in HTML to applicationFeedback.submit.

Requires the candidatesWrite permission.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
enum
required

The context for the file upload. Use CandidateResume for resume uploads, CandidateFiles for general file uploads, ApplicationForm for file fields in application form submissions, and ApplicationFeedbackImage for inline images in application feedback.

Allowed:
string
required
length ≥ 1

The name of the file being uploaded, including extension

string
required
length ≥ 1

The MIME type of the file being uploaded

integer
required
≤ 9007199254740991

The size of the file in bytes

Response

Updated 7 months ago

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 7 months ago