JOjoinsophic
files

Request file upload

Changed on

Request a signed URL for uploading a file directly to storage. The returned id is needed to create a file from the signed upload.

post/signed-uploads

Request

  • Base URL
    https://api.engine.usesophic.com
  • Auth
    HTTP bearer

Request body

content_typestring

Media type of the file.

filenamestring required

Original name of the file.

purpose'verification_evidence' required

The purpose of the uploaded file.

Example request

{
  "content_type": "application/pdf",
  "filename": "identity-document.pdf"
}

Response

Created

created_atstring date-time required

The timestamp (in ISO-8601 format) of when the resource was created.

expires_atstring date-time required

Date and time the signed upload expires.

filenamestring required

Name of the file to upload.

idstring required

Unique resource identifier.

modified_atstring date-time required

The timestamp (in ISO-8601 format) of when the resource was last modified.

purpose'verification_evidence' required

Purpose of the file upload.

signed_upload_urlstring required

Signed URL for uploading the file.

upload_headersobject required

Headers the upload must send verbatim. They are covered by the URL's signature, so storage rejects the upload if any is missing or altered.

Example response

{
  "expires_at": "2026-07-14T10:00:00Z"
}

Changes

  • 1afda7d8d185Revision changes
    • info

      added the required property to the response with the status

  • 6a63920239d8Revision changes
    • breaking

      the request property type changed from no type to string

    • breaking

      the response's property type changed from no type to string for status