LinkCreate.mdx•2.39 kB
---
title: Link Create
description: |
Add a link to the community bookmarks. This will also scrape the content
at the site the link points to, if possible. If the submitted link is an
invalid link for whatever reason (invalid URL structure or page is dead)
then the API will fail. The metadata for the link is indexed on success.
If the submitted link already exists it will be an idempotent operation,
unless the body contains additional metadata. In these cases, the link's
metadata will be updated with the new metadata and the URL is unchanged.
When a link is submitted, it is first "cleaned" to remove any fragments.
full: false
_openapi:
method: POST
route: /links
toc: []
structuredData:
headings: []
contents:
- content: >
Add a link to the community bookmarks. This will also scrape the
content
at the site the link points to, if possible. If the submitted link is
an
invalid link for whatever reason (invalid URL structure or page is
dead)
then the API will fail. The metadata for the link is indexed on
success.
If the submitted link already exists it will be an idempotent
operation,
unless the body contains additional metadata. In these cases, the
link's
metadata will be updated with the new metadata and the URL is
unchanged.
When a link is submitted, it is first "cleaned" to remove any
fragments.
---
{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}
Add a link to the community bookmarks. This will also scrape the content
at the site the link points to, if possible. If the submitted link is an
invalid link for whatever reason (invalid URL structure or page is dead)
then the API will fail. The metadata for the link is indexed on success.
If the submitted link already exists it will be an idempotent operation,
unless the body contains additional metadata. In these cases, the link's
metadata will be updated with the new metadata and the URL is unchanged.
When a link is submitted, it is first "cleaned" to remove any fragments.
<APIPage document={"../api/openapi.yaml"} operations={[{"path":"/links","method":"post"}]} webhooks={[]} hasHead={false} />