---
title: "Upload blob data for a pre-created existing blob"
method: POST
path: "/blob/upload/{id}"
tags: ["Blob"]
---

# Upload blob data for a pre-created existing blob

`POST /blob/upload/{id}`

## Request

- Base URL: `https://app.testiny.io/api/v1`
- URL: `https://app.testiny.io/api/v1/blob/upload/{id}`
- Auth: API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/testiny/apis/testiny-api/docs/blob/upload/:id/post.ts> (a function with typed inputs; its response is checked against the schema)

Upload data for an existing blob previously created without inline data. Use if blob is too large to upload as Base64 in JSON

## Path parameters

- `id` integer, required

## Request body `application/octet-stream`

- string, binary

## Response `200`

Returns 'Blob'

- Blob
  - `id` integer: The unique entity id - must be a positive integer
  - `title` string: An optional descriptive title for the blob
  - `is_deleted` boolean: If the entity has been soft-deleted this value is true
  - `project_id` integer: The project id this entity or mapping belongs to
  - `created_at` string, date-time: The creation time for this entity or mapping value
  - `created_by` number: The creator user id of this entity or mapping value - or zero if created by the system
  - `modified_at` string, date-time: The last modification time for this entity or mapping value
  - `modified_by` number: The id of the user who last modified or undeleted this entity or mapping value - or zero if modified by the system
  - `deleted_at` string, date-time: The soft-deletion time for this entity or mapping value
  - `deleted_by` number: The id of the user who deleted this entity or mapping value - or zero if deleted by the system
  - `blob_id` string: A globally unique id for the blob
  - `mime_type` string: The MIME type of the blob (e.g. image/jpeg)
  - `filename` string: The file name of the blob when it was uploaded. Should have an extension compatible with the 'mime_type'
  - `size` number: The size in bytes of the final blob
  - `external_key` string: An optional external key for identification
  - `data` string: The base64 data of the blob when uploading - as an alternative to uploading the blob in a separate request (for small blobs)

## Other responses

- `4XX`: The request failed because invalid request parameters or data were supplied or access was denied.
- `5XX`: The request failed because an error occurred during processing of the request.

---

[API](https://skmtc.dev/testiny/apis/testiny-api.md) - [All operations](https://skmtc.dev/testiny/apis/testiny-api/llms.txt) - [OpenAPI document](https://skmtc.dev/testiny/apis/testiny-api/revisions/8f7643b2429d?raw)