---
title: "Upload release content"
description: "Uploads the raw bytes of one content hash the release manifest lists."
canonical: "https://www.cool.computer/docs/api-reference/publishing/upload-release-content"
---
# Upload release content

> Uploads the raw bytes of one content hash the release manifest lists.

```http
PUT https://api.cool.computer/api/computers/{id}/releases/{number}/blobs/{sha256}
```

Uploads the raw bytes of one content hash the release manifest lists. The bytes must match the manifest's sha256 and size. Uploading content the computer already holds succeeds without storing it again. The body must keep coming: it may wait at most a minute in all for each 4 KiB, and the request at most 15 minutes, or it is ended with 408 request_body_timeout; send it again.

## Authorization

- A Cool Computers API key, user access token, or claimed agent access token in the Authorization header. Follow https://www.cool.computer/auth.md for agent registration and https://www.cool.computer/authentication.md for direct user credentials.

## Parameters

- `id` (path, string, at least 1 characters, required): The computer's name, such as agent-atlas, or its id (cmp_…). Every caller may use either, the computer's own runtime token included.
- `number` (path, integer, at least 1, required): Release number, starting at 1 for each computer.
- `sha256` (path, string, pattern `^[0-9a-f]{64}$`, required): The content sha256 the release manifest lists.

## Request body

Required.

- `application/octet-stream` (string, binary)

## Responses

- `204`: The content is stored.
- `400`: Bad Request. `blob_not_in_manifest`: the release does not list this sha256.
- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: Not Found. `release_not_found` when the release does not exist.
- `409`: Conflict. `release_closed`: the release no longer accepts uploads. `publish_in_progress`: the computer is being created or is gaining a VM.
- `413`: Payload Too Large.
- `422`: Unprocessable Content. `blob_mismatch`: the bytes do not match the manifest's sha256 and size.
- `429`: Too Many Requests. If the problem code is api_request_rate_exceeded, wait for Retry-After seconds; other problem codes describe a separate limit.
- `500`: Internal Server Error.
- `503`: Service Unavailable. `artifacts_unavailable` means publishing is not configured on this server.
- `default`: A machine-readable API error with a stable code and recovery instruction.

An error is an `application/problem+json` document with a stable `code`; [API errors](/docs/api-reference/errors) says how to handle one.

## Example

```sh
curl -X PUT "https://api.cool.computer/api/computers/$PARAM_ID/releases/$PARAM_NUMBER/blobs/$PARAM_SHA256" \
  -H "authorization: Bearer $TOKEN" \
  -H "content-type: application/octet-stream" \
  --data-binary @file
```
