Skip to main content
POST
Criar um blueprint de nível org ou repo

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

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