Criar um blueprint de nível org ou repo

Cria um blueprint. type é inferido de repo_name.

Conforme a especificação, isso nunca aciona um build automaticamente — quem faz a chamada deve enviar POST /builds explicitamente.

POST /v3beta1/organizations/{org_id}/snapshot-setup/blueprints

Criar um blueprint de nível org ou repo

cURL

curl --request POST \
  --url https://api.devin.ai/v3beta1/organizations/{org_id}/snapshot-setup/blueprints \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": "<string>",
  "repo_name": "<string>"
}
'

201

{
  "blueprint_id": "<string>",
  "created_at": 123,
  "repo_name": "<string>",
  "updated_at": 123
}

​

Permissões

Requer um usuário de serviço com a permissão ManageRepoBlueprints no nível da organização. A criação de blueprints em nível da organização requer a permissão ManageOrgSnapshots.

​

Comportamento

Cria um blueprint de nível de org ou de repo. Um blueprint define a configuração declarativa de ambiente para as sessões do Devin. Alterar um blueprint não aciona automaticamente uma build — você deve chamar o endpoint de builds explicitamente.

Os blueprints não existem de forma independente da configuração do seu ambiente. Criar um blueprint com um repo_name também adiciona esse repositório ao ambiente — não há um endpoint separado para registrar o repo primeiro. O repositório é clonado no ambiente na próxima build, e sua indexação é iniciada.

O inverso também é válido: remover um repositório do ambiente (o controle Incluir no ambiente na UI) exclui todos os blueprints desse repo, incluindo todos os seus escopos de workspace.

O nome do repositório deve ser um ao qual o Devin já tenha acesso por meio da sua integração com o Git (por exemplo, owner/repo); um repo desconhecido ou inacessível retorna 404 e nenhum blueprint é criado. Se já existir um blueprint ativo para esse repo e escopo, a requisição retorna 409 — use o endpoint de atualização.

Autorizações

Authorization · string · header · obrigatório

Credencial de usuário de serviço (prefixo: cog_)

Parâmetros de caminho

org_id · string · obrigatório

ID da organização (prefixo: org-)

Exemplo:

"org-abc123def456"

Corpo

application/json

contents · string | null

Corpo YAML inicial opcional para o blueprint.

repo_name · string | null

Se definido, cria um blueprint de nível de repo para esse repositório. Se omitido, cria um blueprint em nível da organização (nível da org).

Resposta

201

application/json

Resposta bem-sucedida

Formato do recurso público Blueprint.

Note: o enum type poderá ser expandido no futuro; os clientes DEVEM lidar corretamente com valores desconhecidos. O conteúdo YAML é obtido separadamente via GET /blueprints/{id}/contents.

blueprint_id · string · obrigatório

created_at · integer · obrigatório

repo_name · string | null · obrigatório

type · enum<string> · obrigatório

Opções disponíveis: enterprise, org, repo

updated_at · integer · obrigatório