Push

---

Upload a distributed app

post

Upload a distributed app to the server

Authorizations

AuthorizationstringRequired

Your ByteNite access token

Body

datastringRequired

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

Responses

200

A successful response.

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.

401

Returned when the user is not authenticated.

403

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

404

Returned when the resource does not exist.

500

Returned when an error on the server occurred.

503

Returned when the resource is temporarily unavailable.

default

An unexpected error response.

post/apps

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"
}

{
  "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-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "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"
}