Upload an attachment to use in an action. Any attachment which has not been linked to an object via
an action within one hour after upload will be removed.
Previously mapped attachments which are not connected to any object anymore are also removed on
a biweekly basis.
The body of the request must contain the binary content of the file and the Content-Type header must be application/octet-stream.
Third-party applications using this endpoint via OAuth2 must request the
following operation scopes: api:ontologies-write.
objectSuccess response.
stringThe unique resource identifier of an attachment.
stringThe name of a File within Foundry. Examples: my-file.txt, my-file.jpg, dataframe.snappy.parquet.
stringThe size of the file or attachment in bytes.
stringThe media type of the file or attachment.
Examples: application/json, application/pdf, application/octet-stream, image/jpeg
1
2
3
4
5
curl -X POST \
-H "Content-type: application/octet-stream" \
-H "Authorization: Bearer $TOKEN" \
"https://$HOSTNAME/api/v1/attachments/upload?filename=My+Image.jpeg" \
-d '@/path/to/file'1
2
3
4
5
6
{
"rid": "ri.attachments.main.attachment.bb32154e-e043-4b00-9461-93136ca96b6f",
"filename": "My Image.jpeg",
"sizeBytes": 393469,
"mediaType": "image/jpeg"
}