Create a team conversation¶
Create a team conversation without submitting a runtime task.
POST https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-teams/{team_id}/sessions
Before you call this API¶
BASE_URL uses the product API prefix https://api.moi.matrixorigin.cn/v5. For a dedicated deployment, use its corresponding product API address.
Prepare product identity and object identifiers in the same environment.
Request¶
curl --request POST \
"$BASE_URL/workspaces/$WORKSPACE_ID/agent-teams/$TEAM_ID/sessions" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID" \
--header "Content-Type: application/json" \
--data '{"name":"资料整理"}'
Parameter |
Location |
Type |
Required |
Description |
|---|---|---|---|---|
|
Path |
string |
Yes |
Current Workspace ID, consistent with the product identity and request headers in the same environment. |
|
Path |
string |
Yes |
Team ID from the team list or creation response. |
|
Body |
string |
No |
Conversation name; may be empty. |
name may be omitted or empty and is trimmed when saved. Creation establishes conversation metadata only, not a task; context_id is server-generated.
Successful response¶
{
"code": 0,
"data": {
"workspace_id": "workspace-example",
"team_id": "team-example",
"context_id": "context-example",
"name": "资料整理",
"created_by_moi_user_id": "user-example",
"updated_by_moi_user_id": "user-example",
"version": 1,
"created_at": "2026-11-12T01:00:00Z",
"updated_at": "2026-11-12T01:00:00Z"
}
}
Field |
Type |
Description |
|---|---|---|
|
integer |
0 on success. |
|
object |
HTTP 201. Returns the corresponding object; confirm writes with the corresponding read operation.
Error response¶
Errors and concurrency handling distinguishes parameter, version, member/conversation state, and admission failures.