Create a file upload session for a message attachment.

curl --request POST \
  --url https://api.revoengine.com/api/v1/chat/threads/{threadId}/messages/{messageId}/uploads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "retention": {
    "ttlSeconds": 2,
    "expiresAt": "2026-08-01T12:00:00.000Z"
  },
  "parentStorageEntryId": "00000000-0000-4000-8000-000000000000",
  "storageProviderConfigId": "00000000-0000-4000-8000-000000000001",
  "replaceStorageEntryId": "00000000-0000-4000-8000-000000000002",
  "replaceExpectedVersion": 3,
  "name": "contracts.csv",
  "contentTypeHint": "text/csv",
  "sizeHint": 1048576,
  "tier": "HOT",
  "uploadMode": "incremental",
  "computeStats": "async",
  "metadata": {
    "scope": "integration",
    "source": "sdk"
  },
  "refId": "<string>",
  "refType": "<string>",
  "refVer": 123,
  "restricted": true,
  "groups": [
    "<string>"
  ],
  "users": [
    "<string>"
  ]
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    retention: {ttlSeconds: 2, expiresAt: '2026-08-01T12:00:00.000Z'},
    parentStorageEntryId: '00000000-0000-4000-8000-000000000000',
    storageProviderConfigId: '00000000-0000-4000-8000-000000000001',
    replaceStorageEntryId: '00000000-0000-4000-8000-000000000002',
    replaceExpectedVersion: 3,
    name: 'contracts.csv',
    contentTypeHint: 'text/csv',
    sizeHint: 1048576,
    tier: 'HOT',
    uploadMode: 'incremental',
    computeStats: 'async',
    metadata: {scope: 'integration', source: 'sdk'},
    refId: '<string>',
    refType: '<string>',
    refVer: 123,
    restricted: true,
    groups: ['<string>'],
    users: ['<string>']
  })
};

fetch('https://api.revoengine.com/api/v1/chat/threads/{threadId}/messages/{messageId}/uploads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.revoengine.com/api/v1/chat/threads/{threadId}/messages/{messageId}/uploads"

payload = {
    "retention": {
        "ttlSeconds": 2,
        "expiresAt": "2026-08-01T12:00:00.000Z"
    },
    "parentStorageEntryId": "00000000-0000-4000-8000-000000000000",
    "storageProviderConfigId": "00000000-0000-4000-8000-000000000001",
    "replaceStorageEntryId": "00000000-0000-4000-8000-000000000002",
    "replaceExpectedVersion": 3,
    "name": "contracts.csv",
    "contentTypeHint": "text/csv",
    "sizeHint": 1048576,
    "tier": "HOT",
    "uploadMode": "incremental",
    "computeStats": "async",
    "metadata": {
        "scope": "integration",
        "source": "sdk"
    },
    "refId": "<string>",
    "refType": "<string>",
    "refVer": 123,
    "restricted": True,
    "groups": ["<string>"],
    "users": ["<string>"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)