YouTube-specific tag normalization for HTML form POSTs. YouTube's Data API caps total tag-list characters at 500 (delimiters counted); we cap

Validate a magic link token *without* consuming it. Used to render the confirmation page on GET so that email link scanners that prefetch the

Metrics that show up in per-post views (table columns, detail drawer). Account-only metrics (follows, subscribers) are filtered out — you can't

Place ``post`` at the queue's earliest slot, laddering others up by one. Comment §2: if the earliest upcoming slot is free, ``post`` takes it and

Idempotently schedule a ``@background`` task to repeat every ``repeat`` seconds. Safe to call from a ``post_migrate`` handler. A fresh DB without

Return the sniffed MIME type for an uploaded-file-like object, or None. Reads the first 32 bytes and matches them against a small allowlist of

Apply a state-machine transition and persist. Wraps ``PlatformPost.transition_to`` (which only mutates the model in memory) with the persiste

Flatten ``AccountMetrics`` into ``{metric_key: value}``. ``platform`` gates per-platform persistence rules (e.g. ``followers`` is only persis

Dispatch to the appropriate platform provider. Resolves credentials, refreshes tokens if needed, builds a PublishContent payload, and

Send notification via webhook (HTTP POST with HMAC-SHA256 signature). The webhook URL is re-validated with is_safe_url at dispatch time (not just

Fetch a Post that belongs to the key's workspace **and** whose every ``PlatformPost`` child targets a ``SocialAccount`` in the key's allowlist

Normalize media IDs from mixed inputs while preserving first-seen order.

Split a comma-separated ``selected_accounts`` value into account IDs. Non-UUID entries are dropped: they can only come from a crafted or corr

The post's PlatformPost child on this channel (or ``None``).

Return ``{platform_post_id: status}`` for HTMX response headers.

Convert a LinkedIn post URN to a web URL. URN format: urn:li:share:123456 or urn:li:ugcPost:123456

Option A: editing an approved post's content sends it back for re-approval. Silently reverts any ``approved`` children to ``pending_review`` so e

Create a PostVersion snapshot.

Serialize a Post for an MCP tool response. Delegates to the same Pydantic schema the REST router returns so the two surfaces cannot drift in

Render a datetime as ISO 8601 with a trailing ``Z`` for UTC. Pydantic's default datetime serialization emits ``+00:00`` for UTC, while Django

Return a 204 response with an HX-Trigger header for slot grid refresh.

Fetch account-level metrics for ``on_date`` and any recent missing days. Walks ``on_date`` and the prior ``_ACCOUNT_METRICS_RECENT_DAYS - 1`` day

Synchronize IdeaMedia rows to match ordered ids and keep cover pointer aligned.

Sync platform post selections from form data. When ``initial_status`` is given, newly-created PlatformPost rows are initialised to that statu

Add a post to a queue (back-compat dispatcher). Routes to the stable-slot ops: ``prioritize`` (top of queue) or ``add_post_next_available`` (

Create a new version of an asset.

Compute derived engagement rate per the design's formula. rate = (sum of engagement parts over period) / denom * 100 Where denom is the firs

Bust the cached ``ApiKey`` row immediately. Used by: * ``revoke_api_key`` (manual revocation) * The ``m2m_changed`` signal on ``ApiKe

Process a newly uploaded media asset: extract metadata and generate thumbnail.

Delete a claimed-but-not-finalized slot so retries can succeed. Call this on the error path inside the route when ``create_post`` or any late

Poll each connected account for new messages.

Return the URL-path slug for ``platform`` (e.g. ``tiktok`` → ``social1``).

Reviewable base content used to detect edits to an approved post.

Build the minimal mocks needed to exercise _dispatch_to_provider's extras-assembly without DB or filesystem side effects. Returns (engine, pl

Build the OAuth callback URL. Platforms with an entry in ``PLATFORM_TO_URL_ALIAS`` (currently only TikTok → ``social1``) use the opaque slug

Create InboxMessage if it doesn't already exist (deduplication).

Percent-encode a LinkedIn URN for use as a URL path segment. LinkedIn rejects path-variable URNs unless their colons (and parens/commas in co

Plain-text body for the HttpError so Ninja's default 429 page renders. The router-level error handler in ``api.py`` rewraps this into the uni

Return set of platform names that have credentials configured.

Allowlist-respecting Post fetch shared by ``get_post`` / ``cancel_post``. Same rule as REST's ``_get_workspace_post``: must be in the key's w

Heuristically detect a video URL by file extension. Uses the URL path only so presigned query strings (R2/S3) don't defeat the check.

Serialize slot writes for a channel within the current transaction. Occupancy is computed from ``PlatformPost`` rows (the publisher's truth),

A minimal stand-in for the message objects providers return.

Org-role options the *viewer* is allowed to assign. Only owners can grant the Admin role (mirrors the owner-only guard in ``services.create_i

Feedback for a failed portal action: an error toast for htmx, 400 otherwise.

204 + HX-Trigger: refresh the portal list (portalAction) and show a toast.

Shared HTMX-tab renderer used by the four `publish_tab_*` endpoints.

Try to parse response as JSON, return empty dict on failure.