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 stora

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 Pint

Create up to 50 scheduled posts in one call. Each item takes the same shape as aidelly_create_post. Returns HTTP 201 when every item was accepted and 207 when some failed, with a per-item results array carrying index, status, and either the created post or an error — inspect it rather than assuming

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

Create a report for a date range and synchronously build its analytics snapshot from the workspace connected accounts. Requires an Idempotency-Key header.

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

Create a new report schedule. Soft-capped at 10 active schedules per workspace.

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 new task in 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}

Soft-delete a report schedule (sets active=false, idempotent).

Soft-delete a task (hidden but can be restored).

Delete a webhook subscription by 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 /workspaces/{workspaceId}/approval-settings — read the require_member_approval workspace gate. Public API preview.

GET /approvals

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.

Retrieve a single report by ID (workspace-scoped).

Retrieve a single report schedule by ID (workspace-scoped).

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 full details of a task including attachments and activity history.

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

GET /white-label — retrieve the agency's white-label branding configuration including domain verification status and DNS instructions. Domain changes must go through the in-app verification flow to handle ownership validation.

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

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 all report schedules in the workspace with pagination and active status filtering.

List all reports in the workspace with pagination.

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 workspace tasks with optional filtering by status, assignee, or ownership. Supports offset pagination.

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

List webhook subscriptions for post lifecycle events.

List delivery attempts for one webhook so you can verify events actually arrived. status is one of pending, delivered, failed (will be retried at next_attempt_at), or dead_letter (retries exhausted or the webhook was removed — these will never be retried). Cursor-paginated: follow next_cursor until

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

POST /destination-presets/{id}/preview — preview how a preset transforms a source post across channels.

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.

DELETE /workspaces/{workspaceId}/invitations — revoke a pending workspace invitation.

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.

Update a report schedule (idempotent).

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

Update task fields (title, description, status, priority, assignee, due date, or links).

PATCH /white-label — update the agency's white-label branding, email settings, and visibility toggles. Domain changes and verification must go through the in-app flow. Returns the updated configuration with current domain status.

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 any