Attach a file resource to an existing Session.
POST /api/v1/cloud/sessions/{session_id}/resources
Attaches a file resource to an existing Session. GitHub repository and Memory Store resources must be mounted when creating the Session; this endpoint only accepts type: "file".
Path parameters
|
Parameter |
Type |
Description |
|
|
string |
Session ID with the |
Request headers
|
Header |
Required |
Description |
|
|
Yes |
|
|
|
Yes |
|
Request body
|
Field |
Type |
Required |
Description |
|
|
string |
Yes |
Must be |
|
|
string |
Yes |
File ID returned by the Files API; the file must be ready |
|
|
string | null |
No |
Mount path. Defaults to |
Example request
curl -X POST https://api.qoder.com.cn/api/v1/cloud/sessions/sess_019e392c0d1e74e095d21ea4c6b41def/resources \
-H "Authorization: Bearer $QODER_PAT" \
-H "Content-Type: application/json" \
-d '{
"type": "file",
"file_id": "file_abc123def456",
"mount_path": "/data/inputs/spec.md"
}'
Example response
HTTP 200 OK
{
"id": "sesr_0e4323e8f47ba34853f5409e",
"type": "file",
"file_id": "file_019ef2a07a06704fb899908c29eed779",
"mount_path": "/mnt/session/uploads/file_019ef2a07a06704fb899908c29eed779",
"created_at": "2026-06-23T05:53:19.77484Z",
"updated_at": "2026-06-23T05:53:38.185714Z"
}
Errors
|
HTTP |
Type |
Trigger |
|
400 |
|
Malformed request, unsupported type, missing |
|
401 |
|
PAT invalid or expired |
|
404 |
|
Session or file does not exist |
|
409 |
|
Session is archived or terminated, file is not ready, or the file is already mounted to this Session |
HTTP 400 Bad Request
{
"type": "error",
"request_id": "cb80235f-76a2-4ff3-9e28-5aa2da12dc14",
"error": {
"type": "invalid_request_error",
"message": "Field 'type' must be 'file'."
}
}
HTTP 400 Bad Request
{
"type": "error",
"request_id": "cb80235f-76a2-4ff3-9e28-5aa2da12dc14",
"error": {
"type": "invalid_request_error",
"message": "Field 'file_id' is required."
}
}
HTTP 404 Not Found
{
"type": "error",
"request_id": "cb80235f-76a2-4ff3-9e28-5aa2da12dc14",
"error": {
"type": "not_found_error",
"message": "File 'file_fake_test_id' was not found."
}
}
See Errors for the full error envelope.