Upload an app version

POST

/v1/apps/:id/versions

POST

/v1/apps/:id/versions

$ curl -X POST https://api.runtype.com/v1/apps/id/versions \
>      -H "Authorization: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "files": {}
> }'

1 {
2   "appId": "app_9f8b7c6d5e4f3a2b1c0d",
3   "bundleHash": "a1b2c3d4e5f67890123456789abcdef0",
4   "createdAt": "2024-06-15T10:45:00Z",
5   "createdBy": "user_1234567890abcdef",
6   "fileCount": 12,
7   "id": "version_abcdef1234567890",
8   "manifest": {
9     "auth": "required",
10     "capabilities": {
11       "agents": [
12         "email-agent",
13         "notification-agent"
14       ],
15       "flows": [
16         "user-onboarding",
17         "purchase-flow"
18       ]
19     },
20     "data": [
21       {
22         "access": "read-write",
23         "namespace": "user_profiles"
24       },
25       {
26         "access": "read",
27         "namespace": "analytics_data"
28       }
29     ],
30     "name": "Customer Engagement App",
31     "description": "Initial release of the customer engagement app with onboarding and purchase flows."
32   },
33   "sizeBytes": 2048576,
34   "status": "uploaded",
35   "versionNumber": 3
36 }

Upload a zip bundle as a new version. The bundle must contain index.html and runtype.app.json at the root. Uploading does not change what is served; call activate to deploy.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

Request

The app bundle: either a raw zip archive (application/zip) or JSON file maps (application/json) that the API zips server-side.

filesmap from strings to stringsRequired

Text files for the bundle, path (relative to bundle root) to content.

filesBase64map from strings to stringsOptional

Binary files for the bundle, path to base64-encoded content.

Response

Version uploaded

appIdstring

bundleHashstring

createdAtstring

createdBystring

fileCountdouble

idstring

manifestobject

sizeBytesdouble

statusenum

versionNumberdouble

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error

503

Service Unavailable Error