Retrieve a share link

client.ShareLinks.Get(ctx, id) (*ShareLinkGetResponse, error)

GET/compute/v1/share-links/{id}

Retrieve metadata for a share link owned by the authenticated organization. Archived and expired links remain retrievable.

ParametersExpand Collapse

id string

ReturnsExpand Collapse

type ShareLinkGetResponse struct{…}

ID string

Share link ID. This value is the bearer credential used to access the linked resources — treat it as a secret.

AccessParameters ShareLinkGetResponseAccessParametersUnion

Access-control parameters for the share link. Discriminated by access_mode: public requires no other fields; email requires a non-empty allowed_emails list.

One of the following:

type ShareLinkGetResponseAccessParametersPublicShareLinkAccessParameters struct{…}

Public access: anyone holding the share link ID can read.

AccessMode Public

type ShareLinkGetResponseAccessParametersEmailShareLinkAccessParameters struct{…}

Email-restricted access: only the addresses in allowed_emails can read the link.

AccessMode Email

AllowedEmails []string

Email addresses allowed to read the link. Must contain at least one address; up to 100 entries.

ArchivedAt Time

When the share link was archived, or null if it has never been archived.

formatdate-time

CreatedAt Time

When the share link was created.

formatdate-time

ExpiresAt Time

When the share link stops granting access.

formatdate-time

PipelineIDs []string

Pipelines exposed by this share link.

PredictionIDs []string

Predictions exposed by this share link.

WorkspaceID string

Workspace that owns the share link and the referenced resources.

URL stringOptional

Visitable share link URL for the deployment’s public app. Present when the deployment has a configured app host; otherwise construct as <your-app-host>/share/{id}. Treat as a secret — the {id} segment is the bearer credential.

formaturi

Retrieve a share link

package main

import (
  "context"
  "fmt"

  "github.com/boltz-bio/boltz-api-go"
  "github.com/boltz-bio/boltz-api-go/option"
)

func main() {
  client := boltzapi.NewClient(
    option.WithAPIKey("My API Key"),
  )
  shareLink, err := client.ShareLinks.Get(context.TODO(), "shr_qoEFr2BlPTBLuM5BinaC8x7iVPP_AwppEOmlxQjJ-eo")
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", shareLink.ID)
}

{
  "id": "shr_qoEFr2BlPTBLuM5BinaC8x7iVPP_AwppEOmlxQjJ-eo",
  "access_parameters": {
    "access_mode": "public"
  },
  "archived_at": "2019-12-27T18:11:19.117Z",
  "created_at": "2019-12-27T18:11:19.117Z",
  "expires_at": "2019-12-27T18:11:19.117Z",
  "pipeline_ids": [
    "string"
  ],
  "prediction_ids": [
    "string"
  ],
  "workspace_id": "workspace_id",
  "url": "https://lab.boltz.bio/share/shr_qoEFr2BlPTBLuM5BinaC8x7iVPP_AwppEOmlxQjJ-eo"
}

Returns Examples

{
  "id": "shr_qoEFr2BlPTBLuM5BinaC8x7iVPP_AwppEOmlxQjJ-eo",
  "access_parameters": {
    "access_mode": "public"
  },
  "archived_at": "2019-12-27T18:11:19.117Z",
  "created_at": "2019-12-27T18:11:19.117Z",
  "expires_at": "2019-12-27T18:11:19.117Z",
  "pipeline_ids": [
    "string"
  ],
  "prediction_ids": [
    "string"
  ],
  "workspace_id": "workspace_id",
  "url": "https://lab.boltz.bio/share/shr_qoEFr2BlPTBLuM5BinaC8x7iVPP_AwppEOmlxQjJ-eo"
}