Push

---

Upload a distributed app

post

Upload a distributed app to the server

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Your ByteNite access token

Body

application/jsonapplication/x-protobuf

datastringRequired

Base64-encoded tar archive containing application code, configuration, and dependencies.

Responses

200

A successful response.

application/jsonapplication/x-protobuf

Each bytenite job is tagged to an app which describes the type of job being run.

idstringRead-onlyOptional

Unique identifier assigned to the distributed app (UUID).

Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

namestringOptional

Human-readable name of the app.

Example: video-transcoding

versionstringOptionalExample: 1.0

ownerstringOptional

UUID of the user who owns the app.

Example: b7aac91d-7e62-4923-898f-5c6d9ea48927

statusstringOptional

Status of the app, e.g., active, inactive.

Example: active

isPublicbooleanOptional

Indicates whether the app is publicly accessible.

createdAtstring · date-timeRead-onlyOptional

UTC timestamp when the app was created.

updatedAtstring · date-timeRead-onlyOptional

UTC timestamp when the app was last updated.

platformstringOptional

Target platform for app execution (e.g., docker).

Example: docker

hashstringRead-onlyOptional

SHA256 checksum of the uploaded tar archive.

Example: Plv5qqtm1jPtm8Brq4jMj9u/zSJMQV85fl62UNxltcM=

linkstringOptional

Currently contains the link to the app's source code.

entrypointstringOptional

Main executable file or script to launch the application (e.g., main.py).

Example: main.py

revisionstring · int64Read-onlyOptional

Internal revision tracking number.

descriptionstringOptional

Optional free-form description of the app.

userNamestringOptional

User name of the app owner.

Example: alice

400

Returned when the users sends a malformed request.

application/jsonapplication/x-protobuf

401

Returned when the user is not authenticated.

application/jsonapplication/x-protobuf

403

Returned when the user does not have permission to access the resource.

application/jsonapplication/x-protobuf

404

Returned when the resource does not exist.

application/jsonapplication/x-protobuf

500

Returned when an error on the server occurred.

application/jsonapplication/x-protobuf

503

Returned when the resource is temporarily unavailable.

application/jsonapplication/x-protobuf

default

An unexpected error response.

application/jsonapplication/x-protobuf

post

/apps

HTTPcURLJavaScriptPython

POST /v1/dev/apps HTTP/1.1
Host: api.bytenite.com
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "data": "text"
}

application/jsonapplication/x-protobuf

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "video-transcoding",
  "version": "1.0",
  "owner": "b7aac91d-7e62-4923-898f-5c6d9ea48927",
  "status": "active",
  "deviceRequirements": {
    "minCpu": 1,
    "minMemory": 2,
    "gpu": [
      "tesla t4",
      "nvidia a100-sxm4-40gb"
    ]
  },
  "isPublic": true,
  "createdAt": "2026-03-02T18:02:30.196Z",
  "updatedAt": "2026-03-02T18:02:30.196Z",
  "platform": "docker",
  "hash": "Plv5qqtm1jPtm8Brq4jMj9u/zSJMQV85fl62UNxltcM=",
  "link": "text",
  "platformConfig": {
    "container": "python:latest",
    "privateImage": true,
    "username": "text",
    "token": "text",
    "secrets": [
      "text"
    ]
  },
  "entrypoint": "main.py",
  "revision": "text",
  "description": "text",
  "userName": "alice"
}