> For the complete documentation index, see [llms.txt](https://docs.fylr.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fylr.io/for-developers/api/endpoints/api-publish.md).

# /api/v1/publish

Record **publishings** of fylr objects in external systems. **fylr has no publishing layer of its own** — the publication itself (for example a DataCite DOI, an external gallery page or a share link) is produced and hosted elsewhere. A publish entry is fylr's record of such a publication: it ties an object's `system_object_id` to the **collector** it was published through (a target configured in the base config, e.g. `datacite`) and to the external `publish_uri` where the publication lives, plus a deep-link back into fylr (`easydb_uri`). These endpoints create, list and delete those records — they do not generate or serve the published artifacts.

### `GET /publish` — List publish records.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/publish" method="get" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-27a76749464f8079ac8ce2ee65518544084ed6fa%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `POST /publish` — Record one or more publishings.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/publish" method="post" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-27a76749464f8079ac8ce2ee65518544084ed6fa%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `GET /publish/{systemObjectId}` — Retrieve a single publish record by its id.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/publish/{systemObjectId}" method="get" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-27a76749464f8079ac8ce2ee65518544084ed6fa%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}

### `DELETE /publish/{publishId}` — Delete a publish record.

{% openapi src="/files/kfiDjhyZfEICNBmt5f49" path="/publish/{publishId}" method="delete" %}
[fylr-openapi.yml](https://4100607288-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAdRFzQASDY2Elfdm3wXW%2Fuploads%2Fgit-blob-27a76749464f8079ac8ce2ee65518544084ed6fa%2Ffylr-openapi.yml?alt=media)
{% endopenapi %}