Sample expiration

from strand import Client

client = Client()

# Read a sample; expiration is a field group on it (read-only).
sample = client.samples.get(sample_id)
if sample.will_expire:
    print(f"expires in {sample.expires_in_days} days ({sample.expires_at_source})")

# Set a single sample to never expire.
client.samples.set_expiration(sample_id, expires_at=None, reason="Active research project")

# Expire on a specific date.
from datetime import datetime, timezone
client.samples.set_expiration(sample_id, expires_at=datetime(2026, 12, 31, tzinfo=timezone.utc))

# Bulk: set never-expire.
client.samples.set_expiration_bulk([id1, id2, id3], expires_at=None)

# Restore from Trash.
client.samples.restore(sample_id)

# Read a sample (expiration is one field group on it — read-only).
curl "https://app.strandai.com/api/v1/samples/$SAMPLE_ID" \
  -H "Authorization: Bearer $STRAND_API_KEY"
# -> {"id": "...", "filename": "...", "status": "ready", ...,
#     "expiresAt": "...", "expiresAtSource": "custom",
#     "expiresInDays": 42, "willExpire": true, "trashedAt": null}

# Set a sample to never expire.
curl -X PATCH "https://app.strandai.com/api/v1/samples/$SAMPLE_ID/expiration" \
  -H "Authorization: Bearer $STRAND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expiresAt": null, "reason": "Active research project"}'

# Bulk: set 50 samples to expire on a fixed date.
curl -X PATCH "https://app.strandai.com/api/v1/samples/expiration" \
  -H "Authorization: Bearer $STRAND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sampleIds": ["...", "..."], "expiresAt": "2026-12-31T00:00:00Z"}'

# Restore a sample from Trash within the 7-day window.
curl -X POST "https://app.strandai.com/api/v1/samples/$SAMPLE_ID/restore" \
  -H "Authorization: Bearer $STRAND_API_KEY"

library(strandai)
client <- strand_client()

# Read a sample; expiration is a field group on it (read-only).
s <- strand_samples_get(client, sample_id)
if (s$will_expire) message("expires in ", s$expires_in_days, " days")

# Set a single sample to never expire.
strand_set_expiration(client, sample_id, expires_at = NULL,
                      reason = "Active research project")

# Expire on a specific date.
strand_set_expiration(client, sample_id,
                      expires_at = as.POSIXct("2026-12-31", tz = "UTC"))

# Bulk: set never-expire.
strand_set_expiration_bulk(client, c(id1, id2, id3), expires_at = NULL)

# Restore from Trash.
strand_restore(client, sample_id)