Skip to main content
POST
Criar um blueprint de nível de organização ou um blueprint de nível de repo

Permissões

Requer um usuário de serviço ou um token de acesso pessoal 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. Não permitido com source='git' (o conteúdo vem do repositório).

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).

source
enum<string> | null

Somente no nível do repositório. 'git' lê .devin/blueprint.yaml (e seus arquivos incluídos) da branch padrão do repositório e mantém o blueprint sincronizado com esse conteúdo; 'database' armazena o YAML no Devin. Quando omitido, o padrão é 'database'.

Opções disponíveis:
git,
database

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
build_on_default_branch_commit
boolean | null

Indica se cada push para a branch padrão do repositório gera um build do ambiente. Null, a menos que este seja o blueprint raiz de um repositório.

report_check_runs
boolean | null

Indica se cada build de commit é registrado como uma execução de verificação do GitHub no commit. Null, a menos que este seja o blueprint raiz de um repositório.

source
enum<string> | null

Onde o YAML é criado: 'git' (sincronizado a partir de .devin/blueprint.yaml no repositório) ou 'database' (editado pela API/UI). Sempre null para blueprints em nível Enterprise ou da organização.

Opções disponíveis:
git,
database