Announce a version

POST

/v1/resources/{name}/versions

curl --request POST \
  --url https://api.gampeon.com/v1/resources/example/versions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "version": "example", "sha256": "example", "sizeBytes": 1, "rightsConfirmed": true, "rightsStatement": "example" }'

• Production

Registers a version with size and checksum. Requires the explicit rights confirmation by the creator: rightsConfirmed: true and the exact current text from GET /v1/legal/rights-statement. Both are stored. Then upload the file with PUT …/file.

Not available with access tokens.

Rate limit: 30 per hour per account.

Authorizations

• session

Parameters

Path Parameters

name

required

string

/^[a-z0-9][a-z0-9_\-]{1,47}$/

Resource name

Request Body^required

Media typeapplication/json

object

version

required

Semantic version, for example 1.0.0

string

/^\d+\.\d+\.\d+(-[0-9A-Za-z.\-]+)?$/

sha256

required

SHA-256 of the file (lowercase hex)

string

/^[a-f0-9]{64}$/

sizeBytes

required

File size in bytes

integer

>= 1

rightsConfirmed

required

rightsStatement

required

Exact text of the current rights statement

string

Responses

201

Version registered

Media typeapplication/json

object

name

required

string

version

required

string

sha256

required

string

sizeBytes

required

integer

Example ^generated

{
  "name": "example",
  "version": "example",
  "sha256": "example",
  "sizeBytes": 1
}

400

Error codes: invalid_field

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

401

Error codes: unauthorized

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

403

Error codes: token_not_allowed, forbidden

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

404

Error codes: not_found

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

409

Error codes: version_exists

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

422

Error codes: rights_confirmation_required

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}

429

Limit: 30 per hour per account. Error codes: rate_limited

Media typeapplication/json

object

error

required

Machine-readable error code, for example not_found or rate_limited.

string

message

Human-readable detail. Only present for some errors.

string

Example ^generated

{
  "error": "example",
  "message": "example"
}