PAparley
Files

Create an upload

Changed on

Start uploading a file. PUT the file's bytes to the returned url in one request before it expires (for example, curl -X PUT --upload-file ./letter.pdf "$URL"). Then pass the upload's id as uploadId to POST /files to add the file to a location, or to POST /skills or PATCH /skills/{slug} for a skill.

post/uploads

Request

  • Base URL
    https://api.parley.so/v1
  • URL
    https://api.parley.so/v1/uploads
  • Auth
    HTTP bearer

Request body

fileNamestring required

The file name, including its extension, such as engagement-letter.pdf. The file keeps this name in Parley.

Response

Created.

idstring required

Pass as uploadId when adding a file or when creating or updating a skill, once the upload finishes.

urlstring uri required

PUT the file's bytes to this URL in a single request. Send no Authorization header.

expiresAtstring date-time required

When the url stops accepting uploads.

Changes

  • 6b78aeee07bcRevision changes
    • breaking

      added subschema #1 to the request property allOf list

    • warning

      changed the pattern of the request property from ^(?!\.+$)[^/\\]+$ to ^[^\p{Cc}\p{Bidi_Control}]*$