Skip to content
Speccy

Make a new share link (REQ-085). It replaces the old one and sets link visibility. The URL appears one time.

POST
/bundles/{bundleId}/share
curl --request POST \
  --url https://example.com/api/v1/bundles/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/share \
  --header 'Content-Type: application/json' \
  --data '{ "expires_at": "2026-04-15T12:00:00Z" }'

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
bundleId
required
string format: uuid

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
expires_at
string format: date-time
Examplegenerated
{
  "expires_at": "2026-04-15T12:00:00Z"
}

Responses

Section titled “ Responses ”

200

Section titled “200”

The new link.

Media typeapplication/json
object
url
required
string
access
required
object
visibility
required
string
Allowed values: private internal link
authors
required

Author user IDs.

Array<string>
reviewers
required
Array<string>
share_active
required
boolean
share_expires_at
string format: date-time
can_edit
required

Whether the caller can change the bundle and its access.

boolean
Example
{
  "access": {
    "visibility": "private"
  }
}

default

Section titled “default”

An error.

Media typeapplication/problem+json

RFC 9457 problem details with a stable code.

object
type
required
string
title
required
string
status
required
integer
detail
string
instance
string
code
required

A stable machine-readable error code.

string
Examplegenerated
{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "code": "example"
}