Manage Run file attachments

​

Before you begin

• You have a Sift API key and your base URLs.
• You have the ID of the Run where you want to attach or remove a file.

​

How Run file attachments work

​

Attach a file to a Run

curl --request POST \
  --url "$SIFT_REST_URL/api/v0/remote-files/upload" \
  --header "Authorization: Bearer $SIFT_API_KEY" \
  --form "entityId=YOUR_RUN_ID" \
  --form "entityType=runs" \
  --form "file=@/path/to/your-file.png"

​

Remove a file from a Run

1. Look up the remoteFileId by calling ListRemoteFiles with a filter scoped to the Run.
   curl --request GET \
     --url "$SIFT_REST_URL/api/v1/remote-files" \
     --header "Authorization: Bearer $SIFT_API_KEY" \
     --get \
     --data-urlencode 'filter=entity_id == "YOUR_RUN_ID"'
   
   The response’s remoteFiles array includes each file’s remoteFileId and fileName.
2. Call DeleteRemoteFile with that remoteFileId.
   curl --request DELETE \
     --url "$SIFT_REST_URL/api/v1/remote-files/YOUR_REMOTE_FILE_ID" \
     --header "Authorization: Bearer $SIFT_API_KEY"
   

​

Update a Run file attachment

1. Remove the outdated file.
2. Attach the new file to the same Run.

​

Verify