The raw attachment is uploaded and attached to the session. Any previous value of the session in that point name is replaced. If the previous value was an attachment, then the previous attachment is also deleted from the system.
This api call will accept a standard form upload post (content-type = ‘multipart/form-data’), in which case the attached file is expected to be in a form field named “attachment”.
This api call will also accept a raw upload (content-type = ‘application/octet-stream’). In this case the request body is saved as is into the attachment. To specify a filename for the attachment, use a “filename” query parameter in the request URI.
This api call returns a 400 Bad Request error if the content type was not recognised or the attachment was not found in the request (eg: incorrect form field name).
On a successful request, this endpoint returns a JSON response with the result set to a hash with the following keys:
These will allow the calling application to determine that the file was indeed delivered and saved correctly.
| Param name | Description |
|---|---|
|
project_id required |
The project ID number Validations:
|
|
session_id required |
The session UUID Validations:
|
|
id required |
The name of the point containing an attached file. Validations:
|