Skip to main content
POST
/
v3beta1
/
organizations
/
{org_id}
/
snapshot-setup
/
blueprints
Create an org- or repo-tier blueprint
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>"
}
'
{
  "blueprint_id": "<string>",
  "created_at": 123,
  "repo_name": "<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.

​
Permissions

Requires a service user with the ManageRepoBlueprints permission at the organization level. Creating org-tier blueprints requires the ManageOrgSnapshots permission.

​
Behavior

Creates an org- or repo-tier blueprint. A blueprint defines the declarative environment configuration for Devin sessions. Mutating a blueprint does not auto-trigger a build — you must explicitly call the builds endpoint.

Authorizations

​
Authorization
string
header
required

Service User credential (prefix: cog_)

Body

application/json
​
contents
string | null

Optional initial YAML body for the blueprint.

​
repo_name
string | null

If set, creates a repo-tier blueprint for that repository. If omitted, creates an org-wide (org-tier) blueprint.

Response

Successful Response

Public Blueprint resource shape.

Note: the type enum may grow in the future; clients MUST gracefully handle unknown values. YAML contents are fetched separately via GET /blueprints/{id}/contents.

​
blueprint_id
string
required
​
created_at
integer
required
​
repo_name
string | null
required
​
type
enum<string>
required
Available options:
enterprise,
org,
repo
​
updated_at
integer
required