aidelly

POST /posts/approvals — approve, reject (with reason), return to draft, or comment on one or many pending posts. Owner/admin only. Public API preview.

Register a competitor root domain to track in the workspace.

Register a creator handle on a specific platform to track.

POST /queues/{id}/items — add content items to queue tail for distribution at next available slots.

Cancel a scheduled post.

DELETE /scheduled-posts/{id} — cancel a scheduled post (and its pending recycles). Public API preview.

POST /ecommerce/stores — connect a new Shopify / WooCommerce / Etsy / Wix store. Verifies credentials then kicks off initial sync. Public API preview.

POST /client-review-links — create a magic-link review portal. Returns the raw token exactly once; store it securely.

Create an OAuth connect link for the workspace.

POST /destination-presets — create a multi-channel fan-out preset with per-platform transformations.

Create a new idea on the workspace's idea board, optionally seeded with an initial body or topic.

Create a signed upload URL and media record for shell-capable clients that can PUT raw bytes to the returned Supabase URL (for example Claude Code or a local CLI). Do NOT use this from browser-sandboxed chat clients such as ChatGPT or Claude.ai: their sandboxes block network egress to Supabase storage, so the byte upload will fail. Those clients must use aidelly_upload_media instead (this tool is hidden automatically for known chat clients).

Upload a photo to a connected platform's media gallery (separate from posts). Today only google_business is wired.

Accept a post for immediate asynchronous publishing or future scheduling. HTTP 201 and ok=true mean accepted, not delivered. For immediate posts, poll aidelly_get_post and only report publication when status is completed and provider_post_id is non-null. Use aidelly_list_pinterest_boards before Pinterest posts and pass content.platform_specific.board_id.

POST /queues — create a new content distribution queue with recurring weekly time slots.

POST /report-links — create a shareable report link (snapshot or live with cadence).

Run a synchronous repurpose job: extract source content, distill, and generate output for one (medium, shape) target.

POST /scheduled-posts — schedule a post with optional auto-recycle entries (up to 3 reposts + 3 reshares). When Team Approvals is on, member submissions land as pending. Public API preview.

Create a manual short link on the workspace.

Create a webhook subscription for post lifecycle events.

POST /workspaces — create a new workspace for the API key owner.

DELETE /calendar/events/{id}

DELETE /content-automations/{id}

DELETE /inbox/automations/{id}

DELETE /workspaces/{workspaceId} — soft-delete a workspace. Requires confirm_name to match the workspace name.

DELETE /ecommerce/stores/{id} — revoke the provider credential and stop future syncs. Imported products remain. Public API preview.

POST /ideas/interview/questions — generate a brand-aware track of interview questions. Default count 8. Public API preview.

GET /agency/overview — cross-workspace agency summary (same data as the dashboard Command Center) — today's queue + next scheduled post, last-24h failures, pending approvals, inbox split by comments/DMs, and credit burn per workspace. Needs a workspace-unscoped key.

GET /analytics/insights

GET /analytics/summary

GET /analytics/unified

GET /approvals

GET /workspaces/{workspaceId}/approval-settings — read the require_member_approval workspace gate. Public API preview.

GET /approvals/{id}

Get the workspace's link-in-bio page configuration and blocks.

GET /brand/profile — retrieve the workspace brand profile, including brand voice.

GET /brand/settings-context

GET /calendar/events

GET /content-automations

GET /content-automations/{id}

GET /ecommerce/stores/{id} — read one connected store. Public API preview.

GET /inbox/automations

GET /inbox/items

Get one post by its UUID. Delivery is confirmed only when status is completed and provider_post_id is non-null. A failed status includes error_code and error.

GET /posts/{id}/analytics — retrieve post performance metrics (views, impressions, likes, comments, shares, saves) with optional daily breakdown.

Get a single repurpose job by id.

GET /scheduled-posts/{id} — read one scheduled post including its recycle plan and approval state. Public API preview.

Get usage metrics and current plan-aware limits for the API key.

GET /workspaces/{workspaceId} — retrieve one accessible workspace.

POST /workspaces/{workspaceId}/invitations — invite a member or client to a workspace. Returns the invitation URL and queues the email by default.

List all postable accounts in a workspace as a flat list, including sub-accounts such as Facebook Pages, Instagram Business accounts, and LinkedIn company pages. Requires workspace_id. Use the id field from each account as the account_id when creating a post. Call this before creating posts to discover available account IDs per platform.

GET /client-review-links — list workspace client review links with metadata (view count, last viewed, revoked status).

List tracked competitor domains for the workspace.

List social connections made through an OAuth connect link.

List the workspace's OAuth connect links.

List tracked creator handles for the workspace.

GET /destination-presets — list workspace destination presets for multi-channel fan-out.

GET /ecommerce/products — list products across the workspace's connected stores. Filter by store, search title/SKU. Public API preview.

GET /ecommerce/stores — list connected Shopify / WooCommerce / Etsy / Wix stores for the workspace. Public API preview.

List ideas on the workspace's idea board, freshest first (pinned first).

List the workspace's saved AI-generated and edited image outputs, freshest first.

GET /posts/approvals — list posts pending sign-off for the current workspace, plus viewer role + canReview flag. Public API preview.

List Pinterest boards available in a workspace. Call this before aidelly_create_post for Pinterest, then pass the selected board id as content.platform_specific.board_id.

GET /posts/approvals/{id}/events — read the approval audit timeline (submitted/approved/rejected/returned_to_draft/commented) for one post. Public API preview.

List posts with optional platform, status, and date-range filters.

GET /queues — list workspace content queues with slot schedules and channel assignments.

GET /report-links — list workspace report share links, optionally filtered by mode (snapshot or live).

List recent repurpose jobs for the workspace.

GET /scheduled-posts — list scheduled posts including compose-time auto-recycle entries and approval state. Public API preview.

List the workspace's first-party short links (active only by default).

List available social connections for publishing.

List discovered viral trends for the workspace, ordered by virality score.

GET /workspaces/{workspaceId}/members — list active members and pending invitations.

List workspace IDs available to this API key. Call this before creating posts when the user has multiple workspaces, then pass the chosen id as workspace_id so Aidelly posts to the exact workspace.

PATCH /analytics/insights

PATCH /calendar/events/{id}

PATCH /inbox/automations/{id}

PATCH /posts/{id}

POST /analytics/insights

POST /approvals/{id}/action

POST /approvals/items/action

POST /content-automations

POST /content-automations/{id}/trigger

POST /inbox/automations

POST /inbox/items/{id}/ai-draft

POST /inbox/items/{id}/respond

PUT /content-automations/{id}

DELETE /workspaces/{workspaceId}/members — remove a workspace member.

DELETE /client-review-links/{id} — revoke a client review link and block further access.

Revoke an OAuth connect link, preventing further use.

DELETE /report-links/{id} — revoke a report share link.

POST /ecommerce/stores/{id}/sync — re-sync the store's catalog. Incremental; only changed products are fetched. Public API preview.

PATCH /workspaces/{workspaceId}/approval-settings — flip the require_member_approval workspace gate. Owner only. Public API preview.

PUT /brand/profile — update workspace brand profile fields such as brand_voice, writing_style, and target_audience.

Update an OAuth connect link's title or enabled status.

PATCH /scheduled-posts/{id} — update caption, schedule, or recycle plan on a scheduled post. Public API preview.

PATCH /workspaces/{workspaceId} — update workspace name, archive state, kind, or mode.

PATCH /workspaces/{workspaceId}/members — update a workspace member role.

Default image-attach path for MCP: upload media in one step, server-side, with no client-to-Supabase connection required. Preferred for all browser-based chat clients (ChatGPT, Claude.ai) and safe for any client. Provide exactly one of source_url (a public HTTPS URL the server fetches — best for anything non-trivial and not subject to a payload size cap), data_url, or file_base64 (small inline images only; large payloads hit the MCP tool-call size limit). Returns media_id and read_url for aidelly_create_post content.media.