向会话发送消息

向活跃会话发送消息。如果会话已挂起，将自动恢复该会话。

POST /v3/organizations/{org_id}/sessions/{devin_id}/messages

向会话发送消息

cURL

curl --request POST \
  --url https://api.devin.ai/v3/organizations/{org_id}/sessions/{devin_id}/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "<string>",
  "message_as_user_id": "<string>"
}
'

200

{
  "acus_consumed": 123,
  "created_at": 123,
  "org_id": "<string>",
  "pull_requests": [
    {
      "pr_state": "<string>",
      "pr_url": "<string>"
    }
  ],
  "session_id": "<string>",
  "status": "new",
  "tags": [
    "<string>"
  ],
  "updated_at": 123,
  "url": "<string>",
  "child_session_ids": [
    "<string>"
  ],
  "is_advanced": false,
  "is_archived": false,
  "parent_session_id": "<string>",
  "playbook_id": "<string>",
  "service_user_id": "<string>",
  "status_detail": "working",
  "structured_output": {},
  "title": "<string>",
  "user_id": "<string>"
}

devin_id 是在会话 ID 前加上 devin- 前缀得到的值 (例如，devin-abc123) 。

​

权限

需要一个在组织级别被授予 ManageOrgSessions 权限的服务用户。

授权

Authorization · string · header · 必填

服务用户凭据（前缀：cog_）

路径参数

devin_id · string | null · 必填

Devin 会话 ID（前缀：devin-）

示例:

"devin-abc123def456"

org_id · string | null · 必填

组织 ID（前缀：org-）

示例:

"org-abc123def456"

请求体

application/json

message · string · 必填

message_as_user_id · string | null

响应

200

application/json

成功响应

acus_consumed · number · 必填

created_at · integer · 必填

org_id · string · 必填

pull_requests · SessionPullRequest · object[] · 必填

Show child attributes

session_id · string · 必填

status · enum<string> · 必填

可用选项: new, creating, claimed, running, exit, error, suspended, resuming

tags · string[] · 必填

updated_at · integer · 必填

url · string · 必填

child_session_ids · string[] | null

is_advanced · boolean · 默认值: false

is_archived · boolean · 默认值: false

parent_session_id · string | null

playbook_id · string | null

service_user_id · string | null

status_detail · enum<string> | null

有关 session 当前状态的更多详情。当 status 为“running”时，取值可能为“working”（正在执行）、“waiting_for_user”（需要用户输入）、“waiting_for_approval”（在安全模式下等待操作批准）或“finished”（任务已完成）。当 status 为“suspended”时，表示挂起原因，例如“inactivity”“user_request”“usage_limit_exceeded”“out_of_credits”“out_of_quota”“no_quota_allocation”“payment_declined”“org_usage_limit_exceeded”或“error”。仅在 GET/list 端点中返回。

可用选项: working, waiting_for_user, waiting_for_approval, finished, inactivity, user_request, usage_limit_exceeded, out_of_credits, out_of_quota, no_quota_allocation, payment_declined, org_usage_limit_exceeded, error

structured_output · Structured Output · object

来自会话的已验证结构化输出。仅在 GET/LIST 端点中返回。

title · string | null

user_id · string | null