Skip to content

Upload a full project ZIP archive and create a new immutable source revision.

POST
/api/workspace/admin/net-operation-project/upload
curl --request POST \
--url https://example.com/api/workspace/admin/net-operation-project/upload \
--header 'Content-Type: multipart/form-data' \
--form File=@file \
--form Comment=example
  • None
access_token
string

Optional access token for clients that cannot set Authorization headers. Prefer Authorization: Bearer <token> when possible.

Media typemultipart/form-data
object
File

Uploaded ZIP archive.

string format: binary
Comment

Optional revision comment.

string

OK

Media typeapplication/json
object
Data

Result of uploading a Net Operation Project source archive.

object
Revision

Immutable Net Operation Project source revision.

object
Id

Revision identifier.

string
nullable
ProjectId

Project identifier.

string
nullable
RevisionNumber

Monotonic revision number.

integer format: int32
SourceKind
integer format: int32
Allowed values: 0 1 2 3
Status
integer format: int32
Allowed values: 0 1 2 3 4
Comment

Optional revision comment.

string
nullable
SourceChecksum

Canonical source tree checksum.

string
nullable
SchemaContractHash

Optional schema contract hash captured with the revision.

string
nullable
CreatedAt

Creation timestamp.

string format: date-time
CreatedByUserId

Creating user identifier.

string
nullable
FileCount

Number of files stored in the revision.

integer format: int32
Build

Net Operation Project build history record.

object
Id

Build identifier.

string
nullable
ProjectId

Project identifier.

string
nullable
RevisionId

Source revision identifier.

string
nullable
BuildNumber

Monotonic build number.

integer format: int32
Kind
integer format: int32
Allowed values: 0 1
Status
integer format: int32
Allowed values: 0 1 2 3 4
Stage
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10
StageMessageKey

Localization key for current build stage.

string
nullable
ProgressPercent

Current progress percentage.

integer format: int32
RequestedByUserId

Requesting user identifier.

string
nullable
RequestedAt

Build request timestamp.

string format: date-time
StartedAt

Build start timestamp.

string format: date-time
nullable
CompletedAt

Build completion timestamp.

string format: date-time
nullable
WorkerId

Worker that claimed the build.

string
nullable
HeartbeatAt

Last worker heartbeat timestamp.

string format: date-time
nullable
AttemptCount

Number of worker attempts.

integer format: int32
GeneratedProjectChecksum

Optional generated project checksum.

string
nullable
SchemaContractHash

Optional schema contract hash.

string
nullable
DiagnosticsJson

Optional structured diagnostics JSON.

string
nullable
ErrorSummary

Optional short error summary.

string
nullable
RowVersion

Concurrency token.

string format: uuid
Failure

Safe structured diagnostics for a failed Net Operation Project build.

object
ReasonCode

Stable machine-readable reason code.

string
nullable
Category
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9
Retryable

Whether retrying can reasonably succeed without operator remediation.

boolean
SqlState

Optional PostgreSQL SQLSTATE without SQL or parameter values.

string
nullable
TargetKind

Optional allow-listed publication target kind.

string
nullable
TargetId

Optional safe logical target identifier.

string
nullable
RemediationCode

Stable remediation instruction code.

string
nullable
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Data": {
"Revision": {
"SourceKind": 0,
"Status": 0
},
"Build": {
"Kind": 0,
"Status": 0,
"Stage": 0,
"Failure": {
"Category": 0
}
}
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Bad Request

Media typeapplication/json
object
Data

Result of uploading a Net Operation Project source archive.

object
Revision

Immutable Net Operation Project source revision.

object
Id

Revision identifier.

string
nullable
ProjectId

Project identifier.

string
nullable
RevisionNumber

Monotonic revision number.

integer format: int32
SourceKind
integer format: int32
Allowed values: 0 1 2 3
Status
integer format: int32
Allowed values: 0 1 2 3 4
Comment

Optional revision comment.

string
nullable
SourceChecksum

Canonical source tree checksum.

string
nullable
SchemaContractHash

Optional schema contract hash captured with the revision.

string
nullable
CreatedAt

Creation timestamp.

string format: date-time
CreatedByUserId

Creating user identifier.

string
nullable
FileCount

Number of files stored in the revision.

integer format: int32
Build

Net Operation Project build history record.

object
Id

Build identifier.

string
nullable
ProjectId

Project identifier.

string
nullable
RevisionId

Source revision identifier.

string
nullable
BuildNumber

Monotonic build number.

integer format: int32
Kind
integer format: int32
Allowed values: 0 1
Status
integer format: int32
Allowed values: 0 1 2 3 4
Stage
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9 10
StageMessageKey

Localization key for current build stage.

string
nullable
ProgressPercent

Current progress percentage.

integer format: int32
RequestedByUserId

Requesting user identifier.

string
nullable
RequestedAt

Build request timestamp.

string format: date-time
StartedAt

Build start timestamp.

string format: date-time
nullable
CompletedAt

Build completion timestamp.

string format: date-time
nullable
WorkerId

Worker that claimed the build.

string
nullable
HeartbeatAt

Last worker heartbeat timestamp.

string format: date-time
nullable
AttemptCount

Number of worker attempts.

integer format: int32
GeneratedProjectChecksum

Optional generated project checksum.

string
nullable
SchemaContractHash

Optional schema contract hash.

string
nullable
DiagnosticsJson

Optional structured diagnostics JSON.

string
nullable
ErrorSummary

Optional short error summary.

string
nullable
RowVersion

Concurrency token.

string format: uuid
Failure

Safe structured diagnostics for a failed Net Operation Project build.

object
ReasonCode

Stable machine-readable reason code.

string
nullable
Category
integer format: int32
Allowed values: 0 1 2 3 4 5 6 7 8 9
Retryable

Whether retrying can reasonably succeed without operator remediation.

boolean
SqlState

Optional PostgreSQL SQLSTATE without SQL or parameter values.

string
nullable
TargetKind

Optional allow-listed publication target kind.

string
nullable
TargetId

Optional safe logical target identifier.

string
nullable
RemediationCode

Stable remediation instruction code.

string
nullable
Errors
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Warnings
Array<object>
nullable
object
Code
required
string
nullable
Message
required
string
nullable
Target
string
nullable
Field
string
nullable
Metadata
object
key
additional properties
string
nullable
Type
integer format: int32
Allowed values: 0 1 2
Severity
integer format: int32
Allowed values: 0 1 2
Success
boolean
Example
{
"Data": {
"Revision": {
"SourceKind": 0,
"Status": 0
},
"Build": {
"Kind": 0,
"Status": 0,
"Stage": 0,
"Failure": {
"Category": 0
}
}
},
"Errors": [
{
"Type": 0,
"Severity": 0
}
],
"Warnings": [
{
"Type": 0,
"Severity": 0
}
]
}

Forbidden

Media typeapplication/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}