io.github.wilzer/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.

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 the whole batch succeeded. Acceptance is not delivery: poll aidelly_get_post for each created id. Rate limit is charged per post, not per request, so a 20-post batch costs 20 write units — it saves round trips, not quota. The whole batch is rejected before anything is written if it would exceed your daily scheduling limit. LinkedIn document posts attach one PDF (≤100 MB, ≤300 pages) as media[].type = "document"; documents are rejected on every other platform.

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 /calendar/bulk-fill

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 draft — saved as work-in-progress content that never publishes. The draft_planned_for field is a planning date only. Existing API keys need the new `drafts:write` scope added to gain draft access; no implicit grant occurs. Requires `platform` or a non-empty `platforms` array.

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. LinkedIn document posts attach one PDF (≤100 MB, ≤300 pages) as media[].type = "document"; documents are rejected on every other platform.

Create a comment on a post. Text body is required; @mention parsing is automatic. Replies require parent_comment_id pointing to the root comment.

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. LinkedIn document posts attach one PDF (≤100 MB, ≤300 pages) as media[].type = "document"; documents are rejected on every other platform.

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}

Permanently delete a calendar share link so its public /calendar/share/<token> URL stops working. This is irreversible — disable the link in-app instead if you may need it back. Returns 404 for unknown ids and for links in another workspace alike.

Delete a content campaign. Campaigns with no scheduled or published posts are removed outright; campaigns that publish history still references are soft-deleted so the history keeps its grouping (the response's soft_deleted flag says which happened). Either way the campaign stops appearing anywhere. Returns 404 for unknown ids and for campaigns in another workspace alike.

DELETE /content-automations/{id}

Delete a draft by ID. Drafts are work-in-progress content that never publish. Existing API keys need the new `drafts:write` scope added to gain draft access; no implicit grant occurs.

DELETE /inbox/automations/{id}

Soft delete a comment. Only the author or workspace owner can delete comments.

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

Permanently delete a short link. The /l/<slug> redirect stops working and the link's click history is deleted with it, so prefer this only when the link should disappear entirely. Call aidelly_list_short_links first to get the link id. Returns 404 for unknown ids and for links in another workspace alike.

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 workspace AI credit balance snapshot, including plan credits, trial grants, and purchased credits.

GET /analytics/insights

GET /analytics/summary

GET /analytics/unified