# Coding my own upload endpoint (--server-url)

**URL:** <https://discourse.asciinema.org/t/coding-my-own-upload-endpoint-server-url/990>\
**Category:** General\
**Created:** [May 21, 2025, 2:07pm UTC](https://discourse.asciinema.org/t/coding-my-own-upload-endpoint-server-url/990 "2025-05-21T14:07:21Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![tacman](https://yyz1.discourse-cdn.com/flex027/user_avatar/discourse.asciinema.org/tacman/32/615_2.png) [@tacman](https://discourse.asciinema.org/u/tacman)\
**Post date:** [May 21, 2025, 2:07pm UTC](https://discourse.asciinema.org/t/coding-my-own-upload-endpoint-server-url/990/1 "2025-05-21T14:07:21Z")

</div>

I’m trying to figure out what data and in what format the upload command with a custom API endpoint using version 3.0-rc4

asciinema-x86\_64-unknown-linux-gnu upload public/make.cast --server-url=[https://127.0.0.1:8000/](https://127.0.0.1:8000/)

I’m receiving the POST, but I was hoping to get the contents of make.cast somehow. I’m wondering if the CLI first compresses it, or if it’s streamed, or what.

Can someone point me to the code that handles this, or documentation for the API endpoint?

---

<div class="post-metadata">

**Author:** ![tacman](https://yyz1.discourse-cdn.com/flex027/user_avatar/discourse.asciinema.org/tacman/32/615_2.png) [@tacman](https://discourse.asciinema.org/u/tacman)\
**Post date:** [May 21, 2025, 3:18pm UTC](https://discourse.asciinema.org/t/coding-my-own-upload-endpoint-server-url/990/2 "2025-05-21T15:18:59Z")

</div>

The answer is “it’s an uploaded file”.

---

<div class="post-metadata">

**Author:** ![ku1ik](https://yyz1.discourse-cdn.com/flex027/user_avatar/discourse.asciinema.org/ku1ik/32/171_2.png) [@ku1ik](https://discourse.asciinema.org/u/ku1ik)\
**Post date:** [May 29, 2025, 1:10pm UTC](https://discourse.asciinema.org/t/coding-my-own-upload-endpoint-server-url/990/3 "2025-05-29T13:10:38Z")

</div>

I see you got somewhere 🙂

The upload API is simple but not document (yet). I’ll be extending the API with a few new endpoints soon, and will document it properly on this occasion.

---

<div class="post-metadata">

**Author:** ![ku1ik](https://yyz1.discourse-cdn.com/flex027/user_avatar/discourse.asciinema.org/ku1ik/32/171_2.png) [@ku1ik](https://discourse.asciinema.org/u/ku1ik)\
**Post date:** [August 27, 2025, 3:22pm UTC](https://discourse.asciinema.org/t/coding-my-own-upload-endpoint-server-url/990/4 "2025-08-27T15:22:45Z")

</div>

There are docs for this API now: [API - asciinema docs](https://docs.asciinema.org/manual/server/api/#post-apiv1recordings)