Connectors

Fetch one remote file

Changed on

Copy one provider file, named by an open_ref from browse, into a Vault (vault_id) or to a presigned S3 PUT URL (upload_url). Runs synchronously; files over 100 MB return 413 and belong in a transfer. A repeat for an unchanged provider version returns the first copy with 200. Vault copies are stored as uploaded: call POST /vault/{id}/ingest/{objectId} to index them. Fetched copies are never exported by a link.

post/connectors/v1/fetch

Request

  • Base URL
    https://api.case.dev
  • URL
    https://api.case.dev/connectors/v1/fetch
  • Auth
    HTTP bearer

Headers

x-case-connector-subjectstring

Trusted server-to-server application-user assertion. Must match the subject the open_ref was minted for.

Request body

open_refstring required

From a browse item, exactly as received

vault_idstring

Destination Vault. Exactly one destination.

upload_urlstring

Presigned HTTPS S3 PUT URL. Content-Type must not be a signed header. Exactly one destination.

Response

An earlier copy of this provider version, returned without downloading

Changes