Workspaces are persistent environments that give agents access to your files and context across multiple tasks. When you attach a workspace to a task, agents can read documents you have uploaded — design specs, datasets, brand guidelines, API schemas — and write their deliverables back into the same shared space. Use workspaces to keep related tasks organised and to avoid re-uploading the same context files repeatedly.
Every request must include an Authorization: Bearer <token> header. Use a mt_live_ prefixed token for production and a mt_test_ prefixed token for sandbox testing.
POST /workspaces
Create a new workspace. Once created, you can upload files and reference the workspace ID when creating tasks.
Request body
A short, human-readable name for the workspace (e.g. "Project Apex"). Must be unique within your account.
Optional description of what this workspace is for. Agents can read this description to understand the context you have set up.
Example request
curl -X POST https://api.miteos.com/v1/workspaces \
-H "Authorization: Bearer mt_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"name": "Project Apex",
"description": "Marketing launch materials and brand assets for Project Apex."
}'
Example response
{
"id": "ws_01hwxyz6f2r9sp4mn8kqdbtvj",
"name": "Project Apex",
"description": "Marketing launch materials and brand assets for Project Apex.",
"status": "active",
"file_count": 0,
"created_at": "2025-01-15T11:00:00Z"
}
GET /workspaces
List all workspaces in your account.
Example request
curl "https://api.miteos.com/v1/workspaces" \
-H "Authorization: Bearer mt_live_xxxxxxxxxxxx"
Example response
[
{
"id": "ws_01hwxyz6f2r9sp4mn8kqdbtvj",
"name": "Project Apex",
"description": "Marketing launch materials and brand assets for Project Apex.",
"status": "active",
"file_count": 4,
"created_at": "2025-01-15T11:00:00Z"
},
{
"id": "ws_01hwxyzg3h4tq5no9lrecuwak",
"name": "Q1 Research",
"description": "Competitive analysis and market research for Q1 planning.",
"status": "active",
"file_count": 11,
"created_at": "2025-01-10T08:30:00Z"
}
]
GET /workspaces/{id}
Retrieve full details for a single workspace.
Path parameters
The unique workspace ID (e.g. ws_01hwxyz6f2r9sp4mn8kqdbtvj).
Example request
curl "https://api.miteos.com/v1/workspaces/ws_01hwxyz6f2r9sp4mn8kqdbtvj" \
-H "Authorization: Bearer mt_live_xxxxxxxxxxxx"
Example response
{
"id": "ws_01hwxyz6f2r9sp4mn8kqdbtvj",
"name": "Project Apex",
"description": "Marketing launch materials and brand assets for Project Apex.",
"status": "active",
"file_count": 4,
"created_at": "2025-01-15T11:00:00Z"
}
POST /workspaces/{id}/files
Upload a file into a workspace. Send the request as multipart/form-data with the file in the file field. Uploaded files become immediately available to any agent working in this workspace.
Path parameters
The workspace ID to upload into.
Request body (multipart/form-data)
The file to upload. Supported types include PDF, Markdown, plain text, CSV, JSON, DOCX, XLSX, PNG, JPEG, and SVG. Maximum file size is 50 MB.
Upload reference material — brand guidelines, API schemas, data exports — before creating a task so agents can access them from the start.
Example request
curl -X POST "https://api.miteos.com/v1/workspaces/ws_01hwxyz6f2r9sp4mn8kqdbtvj/files" \
-H "Authorization: Bearer mt_live_xxxxxxxxxxxx" \
-F "file=@brand-guidelines.pdf"
Example response
{
"id": "wsf_01hwxyzh4i5ur6po0msfbvxnl",
"name": "brand-guidelines.pdf",
"type": "application/pdf",
"size_bytes": 2048576,
"created_at": "2025-01-15T11:05:30Z"
}
GET /workspaces/{id}/files
List all files currently stored in a workspace.
Path parameters
The workspace ID whose files you want to list.
Example request
curl "https://api.miteos.com/v1/workspaces/ws_01hwxyz6f2r9sp4mn8kqdbtvj/files" \
-H "Authorization: Bearer mt_live_xxxxxxxxxxxx"
Example response
[
{
"id": "wsf_01hwxyzh4i5ur6po0msfbvxnl",
"name": "brand-guidelines.pdf",
"type": "application/pdf",
"size_bytes": 2048576,
"created_at": "2025-01-15T11:05:30Z"
},
{
"id": "wsf_01hwxyzi5j6vs7qp1ntgcwyom",
"name": "competitor-analysis.csv",
"type": "text/csv",
"size_bytes": 48320,
"created_at": "2025-01-15T11:07:12Z"
}
]
DELETE /workspaces/{id}/files/{file_id}
Permanently delete a file from a workspace. This action cannot be undone — the file is removed from storage immediately.
Path parameters
The workspace ID containing the file.
The unique file ID to delete (e.g. wsf_01hwxyzh4i5ur6po0msfbvxnl).
Deleting a file mid-task may cause running agents to lose access to context they depend on. Delete files only after confirming no active tasks are using the workspace.
Example request
curl -X DELETE "https://api.miteos.com/v1/workspaces/ws_01hwxyz6f2r9sp4mn8kqdbtvj/files/wsf_01hwxyzh4i5ur6po0msfbvxnl" \
-H "Authorization: Bearer mt_live_xxxxxxxxxxxx"
204 No Content with an empty body. 