Sharing

create_external_share

Create a public share link for a content document, optionally with an expiration date. Anyone with the link can view it without a Marcora account, and it won't be indexed by search engines.

Parameters

Name	Type	Required	Default	Description
`content_id`	`string (uuid)`	Yes	—	The ID of the content you wish to share
`expires_at`	`integer`	No	—	Optional expiry for the share link, as a Unix timestamp in MILLISECONDS (e.g. Date.now() + 7 days). It is compared directly against the current time in milliseconds, so a seconds-based timestamp will make the link appear already expired. Omit it — or pass anything that is not a number, which is ignored — to create a link that never expires.

Input Schema

{
  "type": "object",
  "required": [
    "content_id"
  ],
  "properties": {
    "content_id": {
      "type": "string",
      "format": "uuid",
      "description": "The ID of the content you wish to share"
    },
    "expires_at": {
      "type": "integer",
      "description": "Optional expiry for the share link, as a Unix timestamp in MILLISECONDS (e.g. Date.now() + 7 days). It is compared directly against the current time in milliseconds, so a seconds-based timestamp will make the link appear already expired. Omit it — or pass anything that is not a number, which is ignored — to create a link that never expires."
    }
  }
}

Output Schema

{
  "type": "object",
  "required": [
    "share_link"
  ],
  "properties": {
    "share_link": {
      "type": "string",
      "description": "Public URL (https://app.marcora.ai/s/<token>) anyone can use to view the content."
    }
  }
}

Instructions

Creates a public share link for content, with optional expiration. Accessible by anyone without a Marcora account.

Workflow:

Get content_id from list_content.
Optionally provide expires_at as a Unix timestamp to limit access duration.
Returns a ready-to-use share_link URL that is accessible publicly, but will not be indexed by search engines.