(v2) Upload a File

post

https://{amsServer}/{amsAppName}/fileupload

Step 1 of 3 in the file upload process. Uploads a file to the server's file store.

After a successful upload (HTTP 200, empty body), call POST /api/v2/fileupload/getUploadStatus to retrieve the file ID and name.

Content-Type: This endpoint uses multipart/form-data.

Session reuse: Requires the session cookie from the v2 login session in addition to Basic Auth. session-token (the skypeName value) is a CSRF check only and does not identify the session. Warning: Omitting the session cookie still returns HTTP 200 with an empty body, but the file is never stored.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

session-token

string

required

The skypeName value from the authentication response — a CSRF check, not a session identifier

filename

string

required

Filename including file extension (e.g. image.png)

processorkey

string

required

Leave as document-key

filedata

file

required

The file content to upload

Headers

session-header

string

required

The current session token. Returned by most API calls and must be passed on all subsequent v2/v3 calls.

X-APP-ID

string

A unique identifier for your application. Helps Teamworks support staff identify your requests if you need assistance.

Response

200

File uploaded successfully. Empty response body. Call POST /api/v2/fileupload/getUploadStatus next to retrieve the file ID and name.