Skip to main content
POST
Upload an enterprise blueprint file

Permissions

Requires a service user or personal access token with the ManageAccountSnapshots permission at the enterprise level.

Errors

  • 400 Bad Request: The name query parameter is not a plain file name. The name must not contain path separators, a leading dot, whitespace, or control characters. The name must contain at least one letter or digit.
  • 404 Not Found: The blueprint does not exist, is deleted, or is not the enterprise blueprint of this account.
  • 409 Conflict: Another active file produces the same environment variable name. The variable name is FILE_ plus the file name in upper case. Every character that is not a letter or digit becomes _. Delete or rename the other file first. A new file with the same name replaces the existing file and does not return 409.
  • 413 Content Too Large: The file is larger than 10 MB.

Behavior

Uploads a file to the enterprise blueprint. Files are referenced in the blueprint YAML and made available during snapshot builds.

Authorizations

Authorization
string
header
required

Service User credential (prefix: cog_)

Path Parameters

blueprint_id
string
required

Query Parameters

name
string
required

Body

multipart/form-data
file
file
required

Response

Successful Response

Public BlueprintFile resource shape.

blueprint_id
string
required
created_at
integer
required
env_var_name
string
required
file_id
string
required
name
string
required
size_bytes
integer
required
updated_at
integer
required