---
search:
  tags:
    - system
    - POST
seo:
  description: >-
    Loads the server packages of the request body, as… Reference for the POST
    /api/v1/packs/upload endpoint in the TimescaleDB Enterprise API.
sidebar:
  label: Upload server packages
  badge: POST
title: Upload server packages
type: openapi-operation
---
Loads the server packages of the request body, as ./timescale-enterprise.sh --pack does: a server package file, or a .tar file with server package files (the file of --make-bundle --packs-only). The console streams the body to the data volume, checks the name and the release of each file, checks the sha256 of each file against the SHA256SUMS of a .tar file, and verifies the signature. It refuses a bad name or a newer release (422) before it stores the body; it reads and discards the body of such a refusal, up to 2.5 GB, so that the client gets the refusal. The limit is 8.0 GB for each file (413). The data volume must have the size of the file (two times for a .tar file) and 1 GB more free (507). A pack with the same name is replaced. The response lists the loaded packs, and the pack list after the upload as GET /packs gives it.

`POST /api/v1/packs/upload`

**Request body** (`application/octet-stream`, required)

Request body example:

```json
"string"
```

**Responses**

- `200` — OK
- `default` — Error

Response example, 200:

```json
{
  "imported": [
    {
      "name": "string",
      "text": "string"
    }
  ],
  "outdated": [
    {
      "arch": "amd64",
      "command": "string",
      "file": "string",
      "label": "string",
      "os": "debian",
      "os_version": "string",
      "release": "string",
      "servers": [
        "string"
      ]
    }
  ],
  "packs": [
    {
      "arch": "amd64",
      "components": [
        {
          "name": "string",
          "postgresql_major": "string",
          "version": "string"
        }
      ],
      "installed_on": {
        "servers": [
          "string"
        ],
        "services": [
          "string"
        ]
      },
      "kind": "base",
      "name": "string",
      "older_release": true,
      "os": "string",
      "os_version": "string",
      "pinned_by": [
        "string"
      ],
      "postgresql": [
        {
          "major": "string",
          "minor": "string",
          "timescaledb": [
            "string"
          ]
        }
      ],
      "reason": "string",
      "release": "string",
      "remove_loses_servers": [
        "string"
      ],
      "remove_refusal": "string",
      "size_bytes": 0,
      "verified": true
    }
  ],
  "release": "string",
  "release_missing": [
    {
      "arch": "amd64",
      "command": "string",
      "file": "string",
      "kind": "base",
      "label": "string",
      "os": "string",
      "os_version": "string",
      "servers": [
        "string"
      ]
    }
  ]
}
```
