跳转到主要内容
POST
/
v3beta1
/
organizations
/
{org_id}
/
snapshot-setup
/
builds
触发手动构建
curl --request POST \
  --url https://api.devin.ai/v3beta1/organizations/{org_id}/snapshot-setup/builds \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
{
  "build_id": "<string>",
  "completed_at": 123,
  "created_at": 123,
  "pinned": true,
  "started_at": 123,
  "status": "pending",
  "trigger": "manual",
  "triggered_by_user_id": "<string>",
  "updated_at": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.devin.ai/llms.txt

Use this file to discover all available pages before exploring further.

权限

需要具有组织级别 ManageOrgSnapshots 权限的服务用户。

行为

为组织触发一次手动快照构建。该构建为异步执行——请轮询构建状态端点来跟踪进度。

授权

Authorization
string
header
必填

服务用户凭据(前缀:cog_)

请求体

application/json

POST /builds 的请求体。根据规范为空;为未来字段预留。

响应

成功响应

公开的 Build 资源结构——一种仅用于判断“是否已成功”的不透明视图。

根据规范,不提供平台/快照/各个 job 的内部信息。未来新增字段 (triggered_by_repo、构建元数据等)均为叠加式扩展。

build_id
string
必填
completed_at
integer | null
必填
created_at
integer
必填
pinned
boolean
必填
started_at
integer | null
必填
status
enum<string>
必填
可用选项:
pending,
running,
succeeded,
failed,
cancelled
trigger
enum<string> | null
必填
可用选项:
manual,
auto
triggered_by_user_id
string | null
必填
updated_at
integer
必填