@curviate/sdk 0.41.0 → 0.42.0

package/dist/index.d.ts

@@ -90,6 +90,15 @@ interface RequestArgs {
      */
     query?: Record<string, string | number | boolean | string[] | undefined | null>;
     body?: unknown;
+    /**
+     * A raw (non-JSON) request body with its own `Content-Type`, for the one
+     * route that takes a file as the body (`drafts.uploadAttachment`). Mutually
+     * exclusive with `body`.
+     */
+    rawBody?: {
+        data: Blob | ArrayBuffer | Uint8Array;
+        contentType: string;
+    };
 }
 /** The bound caller a resource receives. */
 type RequestFn = <T = unknown>(args: RequestArgs) => Promise<T>;
@@ -1575,7 +1584,7 @@ interface paths {
         put?: never;
         /**
          * Create a post
-         * @description Publishes a post on the authenticated LinkedIn account. Send application/json; attach files as base64 objects. Post text passes through to the platform and is never stored.
+         * @description Publishes a post now; JSON, files as base64. Text is never stored. A publish record (account, post id, time) is kept, listed by GET /v1/drafts?status=published and removed when the post is deleted. To publish later, create a Draft at POST /v1/drafts.
          */
         post: operations["postV1AccountIdPosts"];
         delete?: never;
@@ -1696,6 +1705,98 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/drafts": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List drafts
+         * @description Lists your Drafts and, with status=published, publish records (account, post id, time; never Drafts). Filter by status, account (or none) and a [from, to) range on each item's own date.
+         */
+        get: operations["getV1Drafts"];
+        put?: never;
+        /**
+         * Create a draft
+         * @description Stores an unpublished post until it is published or deleted. Every field is optional, the account too; a Draft has at most one account and can move between yours. Up to 50 Drafts and 2 GiB of media per account, and per no-account. A retry creates a second Draft.
+         */
+        post: operations["postV1Drafts"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/drafts/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Retrieve a draft
+         * @description Returns one Draft, with a fresh signed link (valid 1 hour) for each attachment.
+         */
+        get: operations["getV1DraftsId"];
+        put?: never;
+        post?: never;
+        /**
+         * Delete a draft
+         * @description Deletes the Draft and its stored media.
+         */
+        delete: operations["deleteV1DraftsId"];
+        options?: never;
+        head?: never;
+        /**
+         * Update a draft
+         * @description Partial update: an omitted field is left as is, null clears it. attachments replaces the whole list ({id} keeps an existing file, a base64 object adds one, anything left out is deleted). account_id moves the Draft to another of your accounts. Editing a failed Draft clears its failure.
+         */
+        patch: operations["patchV1DraftsId"];
+        trace?: never;
+    };
+    "/v1/drafts/{id}/publish": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Publish a draft now
+         * @description Publishes the Draft now, under the same rules as create post, safety limits included. Success deletes the Draft and its media, writes a publish record and returns the post id, no webhook. Failure leaves the Draft unchanged.
+         */
+        post: operations["postV1DraftsIdPublish"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/drafts/{id}/attachments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Upload a draft attachment
+         * @description Adds one file to the Draft as the raw request body, for media too large to send inline: a video (MP4, up to 50 MiB), a PDF (up to 50 MiB) or an image. Content-Type is the file's type, Content-Length is required; kept only if it arrives whole. Same media rules as inline.
+         */
+        post: operations["postV1DraftsIdAttachments"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/{account_id}/recruiter/profiles/{user_id}": {
         parameters: {
             query?: never;
@@ -2611,7 +2712,7 @@ interface paths {
         put?: never;
         /**
          * Create a webhook
-         * @description Registers a new webhook endpoint to receive real-time events. Choose a source (messaging / user / account_status) and supply the target URL. The HMAC signing secret is returned exactly once in the 201 response, store it securely.
+         * @description Registers a new webhook endpoint to receive real-time events. Choose a source (messaging / user / account_status / post) and supply the target URL. The HMAC signing secret is returned exactly once in the 201 response, store it securely.
          */
         post: operations["postV1Webhooks"];
         delete?: never;
@@ -2629,7 +2730,7 @@ interface paths {
         };
         /**
          * List webhook event types
-         * @description Returns the complete canonical event catalogue (27 events) grouped by source: messaging (7), user (2), account_status (15), plus 3 recruiter/sales_nav events. A local catalogue read: no platform call is made.
+         * @description Returns the complete canonical event catalogue (29 events) grouped by source: messaging (7), user (2), account_status (15), post (2), plus 3 recruiter/sales_nav events. A local catalogue read: no platform call is made.
          */
         get: operations["getV1WebhooksEvents"];
         put?: never;
@@ -19781,7 +19882,752 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description The account_id does not belong to this tenant (ACCOUNT_NOT_FOUND), or the target post was not found (RESOURCE_NOT_FOUND). An id whose connection was replaced or removed also stops resolving here, and it is already absent from the list, so re-read `GET /v1/accounts` for the current id. */
+            /** @description The account_id does not belong to this tenant (ACCOUNT_NOT_FOUND), or the target post was not found (RESOURCE_NOT_FOUND). An id whose connection was replaced or removed also stops resolving here, and it is already absent from the list, so re-read `GET /v1/accounts` for the current id. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Rate limited, slow down and retry after the hinted delay. */
+            429: {
+                headers: {
+                    "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                    RateLimit: components["headers"]["RateLimit"];
+                    "Retry-After": components["headers"]["Retry-After"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Internal error. */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Service unavailable. */
+            503: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Gateway timeout. */
+            504: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    getV1Drafts: {
+        parameters: {
+            query?: {
+                /** @description Comma list of draft, scheduled, failed, published. Default draft,scheduled,failed. published items are publish records, never Drafts. */
+                status?: ("draft" | "scheduled" | "failed" | "published")[];
+                /** @description Only items on this account (acc_...), or none for Drafts with no account. Omitted: all of yours. */
+                account_id?: string;
+                /** @description Only items whose date is at or after this instant (inclusive). */
+                from?: string;
+                /** @description Only items whose date is before this instant (exclusive). */
+                to?: string;
+                /** @description Sort by the item's date: desc (default) or asc. */
+                order?: "desc" | "asc";
+                /** @description Max items per page (1-100, default 20). */
+                limit?: number;
+                /** @description Pagination cursor from a previous response; pass it back verbatim with the same filters. */
+                cursor?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Drafts and publish records, ordered by each item's own date: scheduled_at for scheduled, failure.failed_at for failed, published_at for published, updated_at for draft. */
+            200: {
+                headers: {
+                    "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                    RateLimit: components["headers"]["RateLimit"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Response type discriminator.
+                         * @enum {string}
+                         */
+                        object: "draft_list";
+                        /** @description Each item is a draft (object: draft) or a publish record (object: publish_record). Publish records are never Drafts. */
+                        items: ({
+                            /**
+                             * @description Response type discriminator.
+                             * @enum {string}
+                             */
+                            object: "draft";
+                            /** @description Draft id (drf_...). */
+                            id: string;
+                            /** @description The account this Draft will publish as, or null for none yet. */
+                            account_id: string | null;
+                            /**
+                             * @description Derived: failed if failure is set, else scheduled if scheduled_at is set, else draft.
+                             * @enum {string}
+                             */
+                            status: "draft" | "scheduled" | "failed";
+                            /** @description Post body text. May be empty or null while drafting. */
+                            text: string | null;
+                            /** @description Media, in post order. */
+                            attachments: {
+                                /** @description Attachment id (att_...). Send {id} in a PATCH attachments list to keep it. */
+                                id: string;
+                                /** @description The file's type. */
+                                content_type: string;
+                                /** @description File name. */
+                                filename: string;
+                                /** @description Stored size in bytes. */
+                                size_bytes: number;
+                                /** @description Signed download link to the stored file, valid for 1 hour. Read the Draft again for a fresh one. Null when the stored file is unavailable. */
+                                url: string | null;
+                            }[];
+                            /** @description A post to quote or repost when published. */
+                            quoted_post_id?: string | null;
+                            /**
+                             * @description Who can read the post once published.
+                             * @enum {string|null}
+                             */
+                            can_read?: "anyone" | "relations_only" | null;
+                            /**
+                             * @description Who may comment once published.
+                             * @enum {string|null}
+                             */
+                            can_comment?: "anyone" | "relations_only" | "no_one" | null;
+                            /** @description Company page id to post as. */
+                            post_as?: string | null;
+                            /** @description When Curviate publishes the Draft (UTC, whole minute), or null. It goes out up to 20 seconds after this time. A failed Draft has null here; the time that failed is failure.scheduled_at. */
+                            scheduled_at: string | null;
+                            /** @description Why the last scheduled publish failed; present on failed Drafts only. */
+                            failure: {
+                                /**
+                                 * @description Why it failed. outcome_unknown: the platform gave no usable answer, so the post may be live; check the account's posts before you publish again. missed: Curviate could not start within an hour of the time. platform_error and rate_limited: 3 attempts over about 15 minutes all failed.
+                                 * @enum {string}
+                                 */
+                                code?: "platform_error" | "rate_limited" | "account_unavailable" | "media_rejected" | "budget_exhausted" | "outside_activity_window" | "no_active_seat" | "not_publishable" | "platform_rejected" | "missed" | "outcome_unknown";
+                                /** @description What went wrong and what to do next. Never contains post text. */
+                                message?: string;
+                                /** @description When it failed. */
+                                failed_at?: string;
+                                /** @description The time that failed to publish. */
+                                scheduled_at?: string;
+                            } | null;
+                            /** @description Creation time. */
+                            created_at: string;
+                            /** @description Last change. */
+                            updated_at: string;
+                        } | {
+                            /**
+                             * @description Response type discriminator.
+                             * @enum {string}
+                             */
+                            object: "publish_record";
+                            /** @description The published post's id, or null when the platform returned none. */
+                            post_id: string | null;
+                            /** @description The account that published it. */
+                            account_id: string;
+                            /** @description When it was published. */
+                            published_at: string;
+                            /** @description The Draft it came from, or null for a post created directly. */
+                            draft_id: string | null;
+                        })[];
+                        /** @description Pass back as cursor for the next page; null on the last page. */
+                        cursor: string | null;
+                        safety_warning?: components["schemas"]["SafetyWarning"];
+                    };
+                };
+            };
+            /** @description Invalid filter: an unknown status, a malformed date or cursor, or limit out of range. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Missing or invalid API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Rate limited, slow down and retry after the hinted delay. */
+            429: {
+                headers: {
+                    "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                    RateLimit: components["headers"]["RateLimit"];
+                    "Retry-After": components["headers"]["Retry-After"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    postV1Drafts: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description The account (acc_...) this Draft will publish as, or null for none yet. A Draft belongs to at most one account. */
+                    account_id?: string | null;
+                    /** @description When Curviate publishes this Draft: an ISO 8601 date-time with an offset, at least 5 minutes and at most 365 days ahead, stored in UTC truncated to the minute. Scheduling needs an account and text. Curviate publishes it up to 20 seconds after this time, and keeps scheduled posts on one account at least 5 minutes apart. null unschedules. */
+                    scheduled_at?: string | null;
+                    /** @description Post body text, up to 3000 characters. May be empty while drafting; publishing needs at least one character. */
+                    text?: string | null;
+                    /** @description A post to quote or repost when published, the same as on create post. Checked at publish time. */
+                    quoted_post_id?: string | null;
+                    /**
+                     * @description Who can read the post once published.
+                     * @enum {string|null}
+                     */
+                    can_read?: "anyone" | "relations_only" | null;
+                    /**
+                     * @description Who may comment once published.
+                     * @enum {string|null}
+                     */
+                    can_comment?: "anyone" | "relations_only" | "no_one" | null;
+                    /** @description Company page id to post as; the account must administer it. Checked at publish time. */
+                    post_as?: string | null;
+                    /** @description Media as base64 objects: up to 20 images, or one MP4 video, or one PDF, never mixed. 5 MiB per file inline. */
+                    attachments?: {
+                        /** @description Base64-encoded file bytes. */
+                        content: string;
+                        /** @description The file's type: image/jpeg, image/png, image/gif, image/webp, video/mp4 or application/pdf. */
+                        content_type: string;
+                        /** @description File name. */
+                        filename: string;
+                    }[];
+                };
+            };
+        };
+        responses: {
+            /** @description Draft created. With scheduled_at, status is scheduled and Curviate publishes it on its own. With scheduled_at, the response carries safety_warning (reason activity_window) when the time is outside the account's activity window and its posture is warn; under enforce the request is refused instead (429 BUDGET_EXHAUSTED, reason activity_window) and nothing is saved. */
+            201: {
+                headers: {
+                    "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                    RateLimit: components["headers"]["RateLimit"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Response type discriminator.
+                         * @enum {string}
+                         */
+                        object: "draft";
+                        /** @description Draft id (drf_...). */
+                        id: string;
+                        /** @description The account this Draft will publish as, or null for none yet. */
+                        account_id: string | null;
+                        /**
+                         * @description Derived: failed if failure is set, else scheduled if scheduled_at is set, else draft.
+                         * @enum {string}
+                         */
+                        status: "draft" | "scheduled" | "failed";
+                        /** @description Post body text. May be empty or null while drafting. */
+                        text: string | null;
+                        /** @description Media, in post order. */
+                        attachments: {
+                            /** @description Attachment id (att_...). Send {id} in a PATCH attachments list to keep it. */
+                            id: string;
+                            /** @description The file's type. */
+                            content_type: string;
+                            /** @description File name. */
+                            filename: string;
+                            /** @description Stored size in bytes. */
+                            size_bytes: number;
+                            /** @description Signed download link to the stored file, valid for 1 hour. Read the Draft again for a fresh one. Null when the stored file is unavailable. */
+                            url: string | null;
+                        }[];
+                        /** @description A post to quote or repost when published. */
+                        quoted_post_id?: string | null;
+                        /**
+                         * @description Who can read the post once published.
+                         * @enum {string|null}
+                         */
+                        can_read?: "anyone" | "relations_only" | null;
+                        /**
+                         * @description Who may comment once published.
+                         * @enum {string|null}
+                         */
+                        can_comment?: "anyone" | "relations_only" | "no_one" | null;
+                        /** @description Company page id to post as. */
+                        post_as?: string | null;
+                        /** @description When Curviate publishes the Draft (UTC, whole minute), or null. It goes out up to 20 seconds after this time. A failed Draft has null here; the time that failed is failure.scheduled_at. */
+                        scheduled_at: string | null;
+                        /** @description Why the last scheduled publish failed; present on failed Drafts only. */
+                        failure: {
+                            /**
+                             * @description Why it failed. outcome_unknown: the platform gave no usable answer, so the post may be live; check the account's posts before you publish again. missed: Curviate could not start within an hour of the time. platform_error and rate_limited: 3 attempts over about 15 minutes all failed.
+                             * @enum {string}
+                             */
+                            code?: "platform_error" | "rate_limited" | "account_unavailable" | "media_rejected" | "budget_exhausted" | "outside_activity_window" | "no_active_seat" | "not_publishable" | "platform_rejected" | "missed" | "outcome_unknown";
+                            /** @description What went wrong and what to do next. Never contains post text. */
+                            message?: string;
+                            /** @description When it failed. */
+                            failed_at?: string;
+                            /** @description The time that failed to publish. */
+                            scheduled_at?: string;
+                        } | null;
+                        /** @description Creation time. */
+                        created_at: string;
+                        /** @description Last change. */
+                        updated_at: string;
+                        safety_warning?: components["schemas"]["SafetyWarning"];
+                    };
+                };
+            };
+            /** @description Invalid input. Media rules: up to 20 images (JPEG, PNG, GIF, WEBP, at most 6012 x 6012 px), or one MP4 video, or one PDF, never mixed. scheduled_at must be an ISO 8601 date-time with an offset, 5 minutes to 365 days ahead after truncation to the minute. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Missing or invalid API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description The account_id is not one of yours (ACCOUNT_NOT_FOUND). */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description The account is disconnected (REAUTH_REQUIRED). Reconnect it, or choose another account. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A file is over its size limit: 5 MiB per image, and 5 MiB per file sent inline. */
+            413: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description DRAFT_LIMIT_REACHED: the bucket (one account, or Drafts with no account) already holds 50 Drafts. MEDIA_QUOTA_EXCEEDED: the media would take the bucket past its 2 GiB quota; nothing is stored. ACCOUNT_REQUIRED / DRAFT_NOT_PUBLISHABLE: scheduling needs an account and text. SCHEDULE_CONFLICT: another scheduled Draft on the account is less than 5 minutes away; the message names it. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description BUDGET_EXHAUSTED with reason activity_window: the scheduled time is outside the account's activity window and the account enforces it. Nothing is saved. */
+            429: {
+                headers: {
+                    "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                    RateLimit: components["headers"]["RateLimit"];
+                    "Retry-After": components["headers"]["Retry-After"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    getV1DraftsId: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Draft id (drf_...). */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The Draft. */
+            200: {
+                headers: {
+                    "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                    RateLimit: components["headers"]["RateLimit"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Response type discriminator.
+                         * @enum {string}
+                         */
+                        object: "draft";
+                        /** @description Draft id (drf_...). */
+                        id: string;
+                        /** @description The account this Draft will publish as, or null for none yet. */
+                        account_id: string | null;
+                        /**
+                         * @description Derived: failed if failure is set, else scheduled if scheduled_at is set, else draft.
+                         * @enum {string}
+                         */
+                        status: "draft" | "scheduled" | "failed";
+                        /** @description Post body text. May be empty or null while drafting. */
+                        text: string | null;
+                        /** @description Media, in post order. */
+                        attachments: {
+                            /** @description Attachment id (att_...). Send {id} in a PATCH attachments list to keep it. */
+                            id: string;
+                            /** @description The file's type. */
+                            content_type: string;
+                            /** @description File name. */
+                            filename: string;
+                            /** @description Stored size in bytes. */
+                            size_bytes: number;
+                            /** @description Signed download link to the stored file, valid for 1 hour. Read the Draft again for a fresh one. Null when the stored file is unavailable. */
+                            url: string | null;
+                        }[];
+                        /** @description A post to quote or repost when published. */
+                        quoted_post_id?: string | null;
+                        /**
+                         * @description Who can read the post once published.
+                         * @enum {string|null}
+                         */
+                        can_read?: "anyone" | "relations_only" | null;
+                        /**
+                         * @description Who may comment once published.
+                         * @enum {string|null}
+                         */
+                        can_comment?: "anyone" | "relations_only" | "no_one" | null;
+                        /** @description Company page id to post as. */
+                        post_as?: string | null;
+                        /** @description When Curviate publishes the Draft (UTC, whole minute), or null. It goes out up to 20 seconds after this time. A failed Draft has null here; the time that failed is failure.scheduled_at. */
+                        scheduled_at: string | null;
+                        /** @description Why the last scheduled publish failed; present on failed Drafts only. */
+                        failure: {
+                            /**
+                             * @description Why it failed. outcome_unknown: the platform gave no usable answer, so the post may be live; check the account's posts before you publish again. missed: Curviate could not start within an hour of the time. platform_error and rate_limited: 3 attempts over about 15 minutes all failed.
+                             * @enum {string}
+                             */
+                            code?: "platform_error" | "rate_limited" | "account_unavailable" | "media_rejected" | "budget_exhausted" | "outside_activity_window" | "no_active_seat" | "not_publishable" | "platform_rejected" | "missed" | "outcome_unknown";
+                            /** @description What went wrong and what to do next. Never contains post text. */
+                            message?: string;
+                            /** @description When it failed. */
+                            failed_at?: string;
+                            /** @description The time that failed to publish. */
+                            scheduled_at?: string;
+                        } | null;
+                        /** @description Creation time. */
+                        created_at: string;
+                        /** @description Last change. */
+                        updated_at: string;
+                        safety_warning?: components["schemas"]["SafetyWarning"];
+                    };
+                };
+            };
+            /** @description Missing or invalid API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description No Draft with this id among yours (RESOURCE_NOT_FOUND). */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Rate limited, slow down and retry after the hinted delay. */
+            429: {
+                headers: {
+                    "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                    RateLimit: components["headers"]["RateLimit"];
+                    "Retry-After": components["headers"]["Retry-After"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    deleteV1DraftsId: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Draft id (drf_...). */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Draft and its media deleted. No response body. */
+            204: {
+                headers: {
+                    "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                    RateLimit: components["headers"]["RateLimit"];
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Missing or invalid API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description No Draft with this id among yours (RESOURCE_NOT_FOUND). */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description DRAFT_PUBLISHING: a publish of this Draft is in flight. Read it again in a few seconds. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Rate limited, slow down and retry after the hinted delay. */
+            429: {
+                headers: {
+                    "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                    RateLimit: components["headers"]["RateLimit"];
+                    "Retry-After": components["headers"]["Retry-After"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    patchV1DraftsId: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Draft id (drf_...). */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description The account (acc_...) this Draft will publish as, or null for none yet. A Draft belongs to at most one account. */
+                    account_id?: string | null;
+                    /** @description When Curviate publishes this Draft: an ISO 8601 date-time with an offset, at least 5 minutes and at most 365 days ahead, stored in UTC truncated to the minute. Scheduling needs an account and text. Curviate publishes it up to 20 seconds after this time, and keeps scheduled posts on one account at least 5 minutes apart. null unschedules. */
+                    scheduled_at?: string | null;
+                    /** @description Post body text, up to 3000 characters. May be empty while drafting; publishing needs at least one character. */
+                    text?: string | null;
+                    /** @description A post to quote or repost when published, the same as on create post. Checked at publish time. */
+                    quoted_post_id?: string | null;
+                    /**
+                     * @description Who can read the post once published.
+                     * @enum {string|null}
+                     */
+                    can_read?: "anyone" | "relations_only" | null;
+                    /**
+                     * @description Who may comment once published.
+                     * @enum {string|null}
+                     */
+                    can_comment?: "anyone" | "relations_only" | "no_one" | null;
+                    /** @description Company page id to post as; the account must administer it. Checked at publish time. */
+                    post_as?: string | null;
+                    /** @description Replaces the whole list. Each item is {id} to keep an existing attachment, or a new base64 object. Attachments left out are deleted. */
+                    attachments?: ({
+                        /** @description An attachment already on this Draft (att_...), kept as is. */
+                        id: string;
+                    } | {
+                        /** @description Base64-encoded file bytes. */
+                        content: string;
+                        /** @description The file's type: image/jpeg, image/png, image/gif, image/webp, video/mp4 or application/pdf. */
+                        content_type: string;
+                        /** @description File name. */
+                        filename: string;
+                    })[];
+                };
+            };
+        };
+        responses: {
+            /** @description The updated Draft. scheduled_at schedules, reschedules or (null) unschedules; changing it or the account cancels a pending publish and its retries. Unscheduling alone needs no active seat. With scheduled_at, the response carries safety_warning (reason activity_window) when the time is outside the account's activity window and its posture is warn; under enforce the request is refused instead (429 BUDGET_EXHAUSTED, reason activity_window) and nothing is saved. */
+            200: {
+                headers: {
+                    "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                    RateLimit: components["headers"]["RateLimit"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Response type discriminator.
+                         * @enum {string}
+                         */
+                        object: "draft";
+                        /** @description Draft id (drf_...). */
+                        id: string;
+                        /** @description The account this Draft will publish as, or null for none yet. */
+                        account_id: string | null;
+                        /**
+                         * @description Derived: failed if failure is set, else scheduled if scheduled_at is set, else draft.
+                         * @enum {string}
+                         */
+                        status: "draft" | "scheduled" | "failed";
+                        /** @description Post body text. May be empty or null while drafting. */
+                        text: string | null;
+                        /** @description Media, in post order. */
+                        attachments: {
+                            /** @description Attachment id (att_...). Send {id} in a PATCH attachments list to keep it. */
+                            id: string;
+                            /** @description The file's type. */
+                            content_type: string;
+                            /** @description File name. */
+                            filename: string;
+                            /** @description Stored size in bytes. */
+                            size_bytes: number;
+                            /** @description Signed download link to the stored file, valid for 1 hour. Read the Draft again for a fresh one. Null when the stored file is unavailable. */
+                            url: string | null;
+                        }[];
+                        /** @description A post to quote or repost when published. */
+                        quoted_post_id?: string | null;
+                        /**
+                         * @description Who can read the post once published.
+                         * @enum {string|null}
+                         */
+                        can_read?: "anyone" | "relations_only" | null;
+                        /**
+                         * @description Who may comment once published.
+                         * @enum {string|null}
+                         */
+                        can_comment?: "anyone" | "relations_only" | "no_one" | null;
+                        /** @description Company page id to post as. */
+                        post_as?: string | null;
+                        /** @description When Curviate publishes the Draft (UTC, whole minute), or null. It goes out up to 20 seconds after this time. A failed Draft has null here; the time that failed is failure.scheduled_at. */
+                        scheduled_at: string | null;
+                        /** @description Why the last scheduled publish failed; present on failed Drafts only. */
+                        failure: {
+                            /**
+                             * @description Why it failed. outcome_unknown: the platform gave no usable answer, so the post may be live; check the account's posts before you publish again. missed: Curviate could not start within an hour of the time. platform_error and rate_limited: 3 attempts over about 15 minutes all failed.
+                             * @enum {string}
+                             */
+                            code?: "platform_error" | "rate_limited" | "account_unavailable" | "media_rejected" | "budget_exhausted" | "outside_activity_window" | "no_active_seat" | "not_publishable" | "platform_rejected" | "missed" | "outcome_unknown";
+                            /** @description What went wrong and what to do next. Never contains post text. */
+                            message?: string;
+                            /** @description When it failed. */
+                            failed_at?: string;
+                            /** @description The time that failed to publish. */
+                            scheduled_at?: string;
+                        } | null;
+                        /** @description Creation time. */
+                        created_at: string;
+                        /** @description Last change. */
+                        updated_at: string;
+                        safety_warning?: components["schemas"]["SafetyWarning"];
+                    };
+                };
+            };
+            /** @description Invalid input. Media rules: up to 20 images (JPEG, PNG, GIF, WEBP, at most 6012 x 6012 px), or one MP4 video, or one PDF, never mixed. Also: an attachment id that is not on this Draft. scheduled_at must be an ISO 8601 date-time with an offset, 5 minutes to 365 days ahead after truncation to the minute. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Missing or invalid API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description No such Draft (RESOURCE_NOT_FOUND), or the account_id is not one of yours (ACCOUNT_NOT_FOUND). */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -19790,7 +20636,34 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Rate limited, slow down and retry after the hinted delay. */
+            /** @description DRAFT_PUBLISHING: a publish of this Draft is in flight. Read it again in a few seconds. Or the target account is disconnected (REAUTH_REQUIRED). */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description A file is over its size limit: 5 MiB per image, and 5 MiB per file sent inline. */
+            413: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description DRAFT_LIMIT_REACHED: the bucket (one account, or Drafts with no account) already holds 50 Drafts. MEDIA_QUOTA_EXCEEDED: the media would take the bucket past its 2 GiB quota; nothing is stored. ACCOUNT_REQUIRED: a scheduled Draft cannot drop its account; unschedule it first. ACCOUNT_REQUIRED / DRAFT_NOT_PUBLISHABLE: scheduling needs an account and text. SCHEDULE_CONFLICT: another scheduled Draft on the account is less than 5 minutes away; the message names it. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description BUDGET_EXHAUSTED with reason activity_window: the scheduled time is outside the account's activity window and the account enforces it. Nothing is saved. */
             429: {
                 headers: {
                     "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
@@ -19802,8 +20675,42 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Internal error. */
-            500: {
+        };
+    };
+    postV1DraftsIdPublish: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Draft id (drf_...). */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Published. The Draft and its media are deleted and a publish record is written. No webhook is sent: this response is the result. */
+            201: {
+                headers: {
+                    "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                    RateLimit: components["headers"]["RateLimit"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Response type discriminator.
+                         * @enum {string}
+                         */
+                        object: "post_created";
+                        /** @description The published post's id. */
+                        id: string | null;
+                        safety_warning?: components["schemas"]["SafetyWarning"];
+                    };
+                };
+            };
+            /** @description Missing or invalid API key. */
+            401: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -19811,8 +20718,8 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description A temporary upstream error occurred, or the upstream response could not be interpreted. Check `retry_likely_to_succeed`: a temporary error is worth retrying, a response that could not be interpreted is not, and carries `retry_hint: {"kind": "never"}`. */
-            502: {
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
+            403: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -19820,8 +20727,8 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Service unavailable. */
-            503: {
+            /** @description No Draft with this id among yours (RESOURCE_NOT_FOUND). */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -19829,7 +20736,46 @@ interface operations {
                     "application/json": components["schemas"]["Error"];
                 };
             };
-            /** @description Gateway timeout. */
+            /** @description DRAFT_PUBLISHING: a publish of this Draft is in flight. Read it again in a few seconds. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description ACCOUNT_REQUIRED: the Draft has no account. DRAFT_NOT_PUBLISHABLE: a content gap, the message names the field (for example text: empty). The Draft is unchanged. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description An account-safety limit or a platform rate limit refused the publish. The Draft is unchanged. */
+            429: {
+                headers: {
+                    "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                    RateLimit: components["headers"]["RateLimit"];
+                    "Retry-After": components["headers"]["Retry-After"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description The platform refused or failed the publish. The Draft is unchanged; the error says whether a retry can help. */
+            502: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description PLATFORM_ERROR: the platform did not answer in time. The Draft is unchanged, but the post may still have been published: check the account's posts before publishing again. */
             504: {
                 headers: {
                     [name: string]: unknown;
@@ -19840,6 +20786,201 @@ interface operations {
             };
         };
     };
+    postV1DraftsIdAttachments: {
+        parameters: {
+            query: {
+                /** @description The file's name, kept with the attachment. */
+                filename: string;
+            };
+            header?: never;
+            path: {
+                /** @description Draft id (drf_...). */
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "video/mp4": string;
+                "application/pdf": string;
+                "image/jpeg": string;
+                "image/png": string;
+                "image/gif": string;
+                "image/webp": string;
+            };
+        };
+        responses: {
+            /** @description The Draft, with the new attachment last in attachments[]. */
+            201: {
+                headers: {
+                    "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                    RateLimit: components["headers"]["RateLimit"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /**
+                         * @description Response type discriminator.
+                         * @enum {string}
+                         */
+                        object: "draft";
+                        /** @description Draft id (drf_...). */
+                        id: string;
+                        /** @description The account this Draft will publish as, or null for none yet. */
+                        account_id: string | null;
+                        /**
+                         * @description Derived: failed if failure is set, else scheduled if scheduled_at is set, else draft.
+                         * @enum {string}
+                         */
+                        status: "draft" | "scheduled" | "failed";
+                        /** @description Post body text. May be empty or null while drafting. */
+                        text: string | null;
+                        /** @description Media, in post order. */
+                        attachments: {
+                            /** @description Attachment id (att_...). Send {id} in a PATCH attachments list to keep it. */
+                            id: string;
+                            /** @description The file's type. */
+                            content_type: string;
+                            /** @description File name. */
+                            filename: string;
+                            /** @description Stored size in bytes. */
+                            size_bytes: number;
+                            /** @description Signed download link to the stored file, valid for 1 hour. Read the Draft again for a fresh one. Null when the stored file is unavailable. */
+                            url: string | null;
+                        }[];
+                        /** @description A post to quote or repost when published. */
+                        quoted_post_id?: string | null;
+                        /**
+                         * @description Who can read the post once published.
+                         * @enum {string|null}
+                         */
+                        can_read?: "anyone" | "relations_only" | null;
+                        /**
+                         * @description Who may comment once published.
+                         * @enum {string|null}
+                         */
+                        can_comment?: "anyone" | "relations_only" | "no_one" | null;
+                        /** @description Company page id to post as. */
+                        post_as?: string | null;
+                        /** @description When Curviate publishes the Draft (UTC, whole minute), or null. It goes out up to 20 seconds after this time. A failed Draft has null here; the time that failed is failure.scheduled_at. */
+                        scheduled_at: string | null;
+                        /** @description Why the last scheduled publish failed; present on failed Drafts only. */
+                        failure: {
+                            /**
+                             * @description Why it failed. outcome_unknown: the platform gave no usable answer, so the post may be live; check the account's posts before you publish again. missed: Curviate could not start within an hour of the time. platform_error and rate_limited: 3 attempts over about 15 minutes all failed.
+                             * @enum {string}
+                             */
+                            code?: "platform_error" | "rate_limited" | "account_unavailable" | "media_rejected" | "budget_exhausted" | "outside_activity_window" | "no_active_seat" | "not_publishable" | "platform_rejected" | "missed" | "outcome_unknown";
+                            /** @description What went wrong and what to do next. Never contains post text. */
+                            message?: string;
+                            /** @description When it failed. */
+                            failed_at?: string;
+                            /** @description The time that failed to publish. */
+                            scheduled_at?: string;
+                        } | null;
+                        /** @description Creation time. */
+                        created_at: string;
+                        /** @description Last change. */
+                        updated_at: string;
+                        safety_warning?: components["schemas"]["SafetyWarning"];
+                    };
+                };
+            };
+            /** @description Invalid input. Media rules: up to 20 images (JPEG, PNG, GIF, WEBP, at most 6012 x 6012 px), or one MP4 video, or one PDF, never mixed. Also: an empty file, a filename missing, or a body that did not carry exactly its Content-Length (a truncated upload; nothing is kept). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Missing or invalid API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Forbidden. NO_ACTIVE_SEAT: the account is not attached to an active seat. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description No Draft with this id among yours (RESOURCE_NOT_FOUND). */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description DRAFT_PUBLISHING: a publish of this Draft is in flight. Read it again in a few seconds. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description INVALID_REQUEST: Content-Length is required; a chunked upload is not accepted. */
+            411: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description PAYLOAD_TOO_LARGE: the file is over its type's limit: 5 MiB per image, 50 MiB for a video, 50 MiB for a PDF. */
+            413: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description UNSUPPORTED_MEDIA_TYPE: Content-Type is not one of the accepted file types (JSON and multipart bodies included). */
+            415: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description MEDIA_QUOTA_EXCEEDED: the file would take the bucket past its 2 GiB quota; nothing is stored. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+            /** @description Rate limited, slow down and retry after the hinted delay. */
+            429: {
+                headers: {
+                    "RateLimit-Policy": components["headers"]["RateLimit-Policy"];
+                    RateLimit: components["headers"]["RateLimit"];
+                    "Retry-After": components["headers"]["Retry-After"];
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
     getV1AccountIdRecruiterProfilesUserId: {
         parameters: {
             query?: {
@@ -30217,7 +31358,7 @@ interface operations {
                              * @description The event source this webhook subscribes to.
                              * @enum {string}
                              */
-                            source?: "messaging" | "user" | "account_status";
+                            source?: "messaging" | "user" | "account_status" | "post";
                             /** @description The URL that receives delivery POST requests. */
                             request_url?: string;
                             name?: string | null;
@@ -30379,6 +31520,30 @@ interface operations {
                     }[];
                     /** @description Account-status events to subscribe to (default: all 12 lifecycle events) */
                     events?: ("account.created" | "account.connected" | "account.synced" | "account.reconnected" | "account.reconnect_needed" | "account.restricted" | "account.creation_failed" | "account.disconnected" | "account.error" | "account.paused" | "account.connecting" | "account.permission_revoked" | "account.initial_sync.running" | "account.initial_sync.completed" | "account.initial_sync.failed")[];
+                } | {
+                    /** @constant */
+                    source: "post";
+                    /** @description HTTPS URL that receives webhook deliveries. Must be a publicly reachable host on the default https port; private, loopback and link-local addresses are rejected. */
+                    request_url: string;
+                    /** @description Human-readable name for this webhook (1-100 chars) */
+                    name?: string;
+                    /** @description Per-account targeting. Required and non-empty; each id must be an acc_-prefixed id owned by the tenant. */
+                    account_ids: string[];
+                    /**
+                     * @description A disabled webhook is created but delivers nothing
+                     * @default true
+                     */
+                    enabled?: boolean;
+                    /**
+                     * @description Custom headers added to each delivery POST. Names must be valid HTTP header names and values must be printable ASCII (no line breaks or control characters). Reserved names are rejected at registration; they include Content-Type, User-Agent, Host, any Curviate-* or Sec-* name, and the hop-by-hop headers. At most 10 headers, 1024 characters per value, 4096 bytes in total. Custom headers are not covered by the delivery signature, so treat them as a hint, not as proof of origin. Values are encrypted at rest and are never returned by a read. A read shows the header name plus a 8-character keyed fingerprint of the value, which carries no part of the value and no indication of its length. It is deterministic within your account, so a fingerprint confirms a rotation took effect and tells you whether two of your webhooks carry the same credential; fingerprints are not comparable across accounts. The header name is what identifies which credential is configured.
+                     * @default []
+                     */
+                    headers?: {
+                        key: string;
+                        value: string;
+                    }[];
+                    /** @description Post events to subscribe to (default: both post.published and post.publish_failed) */
+                    events?: ("post.published" | "post.publish_failed")[];
                 };
             };
         };
@@ -30403,7 +31568,7 @@ interface operations {
                          * @description The event source this webhook subscribes to.
                          * @enum {string}
                          */
-                        source?: "messaging" | "user" | "account_status";
+                        source?: "messaging" | "user" | "account_status" | "post";
                         /** @description The URL that receives delivery POST requests. */
                         request_url?: string;
                         /** @description Human-readable label. */
@@ -30421,7 +31586,7 @@ interface operations {
                         }[];
                         /** @description Canonical event names this webhook subscribes to. */
                         events?: string[];
-                        /** @description Field-remapping keys for the delivery payload (messaging and user sources only). */
+                        /** @description Field-remapping keys for the delivery payload (messaging and user sources only; post and account_status have none). */
                         data?: string[];
                         /**
                          * @description HMAC signing secret, 64 hexadecimal characters, returned exactly once at creation. Store it securely.
@@ -30523,7 +31688,7 @@ interface operations {
                         object?: "webhook_event_catalogue";
                         /** @description Event types grouped by source. */
                         sources?: {
-                            /** @description Event source group (messaging, user, account_status, recruiter, sales_nav). */
+                            /** @description Event source group (messaging, user, account_status, post, recruiter, sales_nav). */
                             source?: string;
                             events?: {
                                 /** @description Canonical event name. */
@@ -30681,7 +31846,7 @@ interface operations {
                          * @description The event source this webhook subscribes to (immutable).
                          * @enum {string}
                          */
-                        source?: "messaging" | "user" | "account_status";
+                        source?: "messaging" | "user" | "account_status" | "post";
                         /** @description The URL that receives delivery POST requests. */
                         request_url?: string;
                         /** @description Human-readable label. */
@@ -30699,7 +31864,7 @@ interface operations {
                         }[];
                         /** @description Canonical event names this webhook subscribes to. */
                         events?: string[];
-                        /** @description Field-remapping keys for the delivery payload (messaging and user sources only). */
+                        /** @description Field-remapping keys for the delivery payload (messaging and user sources only; post and account_status have none). */
                         data?: string[];
                         /** @description First 8 characters of the signing secret. The full secret is never returned on edit, it is preserved unchanged. */
                         secret_prefix?: string;
@@ -30877,7 +32042,7 @@ interface operations {
                          * @description The event source this webhook subscribes to (immutable).
                          * @enum {string}
                          */
-                        source?: "messaging" | "user" | "account_status";
+                        source?: "messaging" | "user" | "account_status" | "post";
                         /** @description The URL that receives delivery POST requests. */
                         request_url?: string;
                         /** @description Human-readable label. */
@@ -30895,7 +32060,7 @@ interface operations {
                         }[];
                         /** @description Canonical event names this webhook subscribes to. */
                         events?: string[];
-                        /** @description Field-remapping keys for the delivery payload (messaging and user sources only). */
+                        /** @description Field-remapping keys for the delivery payload (messaging and user sources only; post and account_status have none). */
                         data?: string[];
                         /** @description First 8 characters of the signing secret. The full secret is never returned on edit, it is preserved unchanged. */
                         secret_prefix?: string;
@@ -34621,13 +35786,149 @@ declare class WebhooksResource {
     delete(id: string): Promise<WebhookDeleteResult>;
 }
 
+/**
+ * Drafts resource: 7 methods (root-scoped).
+ *
+ * A Draft is a stored, editable, unpublished post. Give it an account and a
+ * `scheduled_at` and Curviate publishes it for you at that time. Scheduling
+ * never changes the id, so one Draft is one object from first save to publish.
+ *
+ * Root-scoped like `webhooks`: a Draft's account is optional, so there is no
+ * `account_id` path segment. `account_id` is a field of the Draft.
+ *
+ * `POST /v1/{account_id}/posts` (`posts.create`) publishes immediately and does
+ * not schedule. To schedule, create a Draft with `scheduled_at`.
+ *
+ * `delete` resolves with nothing (the API answers 204). `list` returns Drafts
+ * and, with `status: ["published"]`, publish records (never Drafts).
+ */
+
+type DraftCreateBody = paths["/v1/drafts"]["post"]["requestBody"]["content"]["application/json"];
+type DraftCreateResult = paths["/v1/drafts"]["post"]["responses"]["201"]["content"]["application/json"];
+type DraftListParams = NonNullable<paths["/v1/drafts"]["get"]["parameters"]["query"]>;
+type DraftListResult = paths["/v1/drafts"]["get"]["responses"]["200"]["content"]["application/json"];
+type DraftGetResult = paths["/v1/drafts/{id}"]["get"]["responses"]["200"]["content"]["application/json"];
+type DraftUpdateBody = paths["/v1/drafts/{id}"]["patch"]["requestBody"]["content"]["application/json"];
+type DraftUpdateResult = paths["/v1/drafts/{id}"]["patch"]["responses"]["200"]["content"]["application/json"];
+/** Delete-draft resolves with nothing: the API answers 204 with no body. */
+type DraftDeleteResult = void;
+type DraftPublishResult = paths["/v1/drafts/{id}/publish"]["post"]["responses"]["201"]["content"]["application/json"];
+/** The file types the upload route accepts as the raw body. */
+type DraftAttachmentContentType = keyof NonNullable<paths["/v1/drafts/{id}/attachments"]["post"]["requestBody"]>["content"];
+type DraftUploadResult = paths["/v1/drafts/{id}/attachments"]["post"]["responses"]["201"]["content"]["application/json"];
+/** Options for {@link DraftsResource.uploadAttachment}. */
+interface DraftUploadOptions {
+    /** The file's name, kept with the attachment. 1 to 255 characters. */
+    filename: string;
+    /**
+     * The file's type. Optional when `data` is a `Blob`/`File` that carries one.
+     * Anything outside {@link DraftAttachmentContentType} is refused with
+     * `415 UNSUPPORTED_MEDIA_TYPE`.
+     */
+    contentType?: DraftAttachmentContentType;
+}
+declare class DraftsResource {
+    protected readonly ctx: RequestContext;
+    constructor(ctx: RequestContext);
+    /**
+     * Store a Draft. Every field is optional, `account_id` and `text` included.
+     * `POST /v1/drafts`
+     *
+     * With `scheduled_at` (ISO 8601 with offset, between 5 minutes and 365 days
+     * ahead) the Draft is scheduled in the same call and needs an account and
+     * publishable text. Up to 50 Drafts and 2 GiB of media per account, and per
+     * no-account. A retry creates a second Draft.
+     *
+     * @example
+     * const draft = await curviate.drafts.create({
+     *   account_id: "acc_01J8Z3K9P0Q1R2S3T4V5W6X7Y8",
+     *   text: "Three things we learned shipping our first agent integration.",
+     *   scheduled_at: "2026-10-12T09:00:00+02:00",
+     * });
+     * // draft.status === "scheduled"
+     */
+    create(body?: DraftCreateBody): Promise<DraftCreateResult>;
+    /**
+     * List Drafts, cursor-paginated. `GET /v1/drafts`
+     *
+     * `status` defaults to `["draft", "scheduled", "failed"]`; add `"published"`
+     * to include publish records (`object: "publish_record"`, never Drafts).
+     * `account_id` is an `acc_` id or `"none"`. `from`/`to` are a half-open
+     * `[from, to)` range on each item's own date.
+     *
+     * @example
+     * const page = await curviate.drafts.list({ status: ["scheduled"], order: "asc" });
+     */
+    list(params?: DraftListParams): Promise<DraftListResult>;
+    /**
+     * Return one Draft, with a fresh signed link (valid 1 hour) per attachment.
+     * `GET /v1/drafts/{id}`
+     *
+     * @example
+     * const draft = await curviate.drafts.get("drf_01J8Z3K9P0Q1R2S3T4V5W6X7Y8");
+     */
+    get(id: string): Promise<DraftGetResult>;
+    /**
+     * Partial update: an omitted field is left as is, `null` clears it.
+     * `PATCH /v1/drafts/{id}`
+     *
+     * `attachments` replaces the whole list (`{ id }` keeps a file, a base64
+     * object adds one, anything left out is deleted). `scheduled_at` schedules,
+     * reschedules or, with `null`, unschedules. Editing a `failed` Draft clears
+     * its `failure`. A Draft being published answers `409 DRAFT_PUBLISHING`.
+     *
+     * @example
+     * await curviate.drafts.update(id, { scheduled_at: null }); // unschedule
+     */
+    update(id: string, body: DraftUpdateBody): Promise<DraftUpdateResult>;
+    /**
+     * Delete the Draft and its stored media (bodyless, 204).
+     * `DELETE /v1/drafts/{id}`
+     *
+     * @example
+     * await curviate.drafts.delete(id);
+     */
+    delete(id: string): Promise<DraftDeleteResult>;
+    /**
+     * Publish the Draft now, under the same rules and safety limits as
+     * `posts.create`. `POST /v1/drafts/{id}/publish`
+     *
+     * Success deletes the Draft and its media, writes a publish record and
+     * returns `{ object: "post_created", id }`; no webhook is sent. A known
+     * failure leaves the Draft unchanged. A `504` or `502` whose message says
+     * the outcome is unknown means the post may be live: check the account's
+     * posts before retrying.
+     *
+     * @example
+     * const { id: postId } = await curviate.drafts.publish(draftId);
+     */
+    publish(id: string): Promise<DraftPublishResult>;
+    /**
+     * Add one file to the Draft as the raw request body, for media too large to
+     * send inline: an MP4 video or a PDF, each up to 50 MiB. An image is capped at 5 MiB on
+     * every route. One file per call.
+     * `POST /v1/drafts/{id}/attachments?filename=...`
+     *
+     * Small files (up to 5 MiB) can instead ride inline in `create` / `update`
+     * as base64. Resolves with the Draft, the new attachment last.
+     *
+     * @example
+     * const bytes = await readFile("clip.mp4");
+     * const draft = await curviate.drafts.uploadAttachment(id, bytes, {
+     *   filename: "clip.mp4",
+     *   contentType: "video/mp4",
+     * });
+     */
+    uploadAttachment(id: string, data: Blob | ArrayBuffer | Uint8Array, options: DraftUploadOptions): Promise<DraftUploadResult>;
+}
+
 /**
  * Resource namespace assembly.
  *
  * The surface is split cleanly in two, with no overlap:
- * - **Root-scoped** (`accounts`, `auth`, `webhooks`) hang off the root client
- *   only. Connected-account management, connect/reconnect, and webhook
- *   registration are tenant-wide concerns, not per-account ones; they carry no
+ * - **Root-scoped** (`accounts`, `auth`, `webhooks`, `drafts`) hang off the root client
+ *   only. Connected-account management, connect/reconnect, webhook
+ *   registration and Drafts (a Draft's account is optional) are tenant-wide concerns, not per-account ones; they carry no
  *   `account_id` path segment.
  * - **Account-scoped** (everything else) hang off `curviate.account(id)` only.
  *   Every one of their paths leads with the fixed `account_id` segment, so they
@@ -34657,13 +35958,14 @@ interface ResourceNamespaces {
     jobs: JobsResource;
     companies: CompaniesResource;
     webhooks: WebhooksResource;
+    drafts: DraftsResource;
 }
 /**
- * The account-scoped accessor surface, every namespace except the three
- * root-only ones (`accounts`, `auth`, `webhooks`). The fixed `account_id` is
+ * The account-scoped accessor surface, every namespace except the four
+ * root-only ones (`accounts`, `auth`, `webhooks`, `drafts`). The fixed `account_id` is
  * injected by the bound context as the leading path segment.
  */
-type AccountScopedNamespaces = Omit<ResourceNamespaces, "accounts" | "auth" | "webhooks">;
+type AccountScopedNamespaces = Omit<ResourceNamespaces, "accounts" | "auth" | "webhooks" | "drafts">;
 
 /**
  * The Curviate client.
@@ -34684,6 +35986,7 @@ declare class Curviate {
     readonly accounts: AccountsResource;
     readonly auth: AuthResource;
     readonly webhooks: WebhooksResource;
+    readonly drafts: DraftsResource;
     constructor(config: CurviateConfig);
     /**
      * Return an account-scoped accessor that fixes `account_id` on every call,
@@ -34787,7 +36090,7 @@ declare class Curviate {
  * A code the API NEVER emitted is a different case and goes immediately, since
  * no deployment can be sending it: `RATE_LIMITED` went that way in 0.30.0.
  */
-declare const ERROR_CODES: readonly ["UNAUTHORIZED", "INVALID_REQUEST", "UNSUPPORTED_MEDIA_TYPE", "PAYLOAD_TOO_LARGE", "ACCOUNT_NOT_FOUND", "ACCOUNT_RESTRICTED", "ACCOUNT_ALREADY_LINKED", "RESOURCE_NOT_FOUND", "NOT_STORED", "RESOURCE_ACCESS_RESTRICTED", "FILTER_CANDIDATES_REQUIRED", "NO_ACTIVE_SEAT", "LINKEDIN_FEATURE_NOT_SUBSCRIBED", "BETA_NOT_ENABLED", "RATE_LIMIT_ACCOUNT", "RATE_LIMIT_TENANT", "PLATFORM_RATE_LIMIT", "BUDGET_EXHAUSTED", "PLATFORM_ERROR", "PLATFORM_NOT_IMPLEMENTED", "LINKEDIN_OPERATION_NOT_SUPPORTED", "CHECKPOINT_NOT_FOUND", "CHECKPOINT_EXPIRED", "CHECKPOINT_INVALID_CODE", "CHECKPOINT_MAX_ATTEMPTS", "CHECKPOINT_ALREADY_RESOLVED", "CHECKPOINT_UNSUPPORTED", "CONNECTION_IN_PROGRESS", "CONNECTION_LOCATION_REQUIRED", "CONNECTION_LOCATION_UNAVAILABLE", "REAUTH_REQUIRED", "LINKEDIN_AUTH_FAILED", "LINKEDIN_SESSION_EVICTED", "LINKEDIN_RATE_LIMITED", "LINKEDIN_COOKIE_INVALID", "LINKEDIN_SERVICE_UNAVAILABLE", "MESSAGE_WINDOW_EXPIRED", "RECIPIENT_UNREACHABLE", "CONNECTION_REQUEST_CONFLICT", "PAYMENT_REQUIRED", "PAYMENT_FAILED", "SUBSCRIPTION_BUSY", "SUBSCRIPTION_NOT_FOUND", "SEAT_NOT_FOUND", "SEAT_CANCELLED", "NOT_FOUND", "REACTION_NOT_FOUND", "SUBSTRATE_LINK_FAILED", "SUBSTRATE_CAP_REACHED", "BILLING_CHECKOUT_FAILED", "BILLING_PORTAL_UNAVAILABLE", "ACCOUNT_DISPUTED", "ACCOUNT_LINKING_DISABLED", "PERIOD_LOCKED", "SEAT_NOT_EMPTY", "SEAT_PROVISIONAL", "SUBSCRIPTION_ALREADY_EXISTS", "ALREADY_CANCELLED", "CANCELLATION_ALREADY_EFFECTIVE", "INVALID_CANCELLATION_SOURCE", "TRIAL_EXPIRED", "TRIAL_SEAT_LIMIT", "TRIAL_ACTIVE_SEAT_LIMIT", "TRIAL_IDENTITY_ALREADY_USED", "TRIAL_IDENTITY_UNRESOLVED", "ADMIN_BYPASS", "STRIPE_DRIFT_DETECTED", "INTERNAL"];
+declare const ERROR_CODES: readonly ["UNAUTHORIZED", "INVALID_REQUEST", "UNSUPPORTED_MEDIA_TYPE", "PAYLOAD_TOO_LARGE", "ACCOUNT_NOT_FOUND", "ACCOUNT_RESTRICTED", "ACCOUNT_ALREADY_LINKED", "RESOURCE_NOT_FOUND", "NOT_STORED", "RESOURCE_ACCESS_RESTRICTED", "FILTER_CANDIDATES_REQUIRED", "NO_ACTIVE_SEAT", "LINKEDIN_FEATURE_NOT_SUBSCRIBED", "BETA_NOT_ENABLED", "RATE_LIMIT_ACCOUNT", "RATE_LIMIT_TENANT", "PLATFORM_RATE_LIMIT", "BUDGET_EXHAUSTED", "PLATFORM_ERROR", "PLATFORM_NOT_IMPLEMENTED", "LINKEDIN_OPERATION_NOT_SUPPORTED", "CHECKPOINT_NOT_FOUND", "CHECKPOINT_EXPIRED", "CHECKPOINT_INVALID_CODE", "CHECKPOINT_MAX_ATTEMPTS", "CHECKPOINT_ALREADY_RESOLVED", "CHECKPOINT_UNSUPPORTED", "CONNECTION_IN_PROGRESS", "CONNECTION_LOCATION_REQUIRED", "CONNECTION_LOCATION_UNAVAILABLE", "REAUTH_REQUIRED", "LINKEDIN_AUTH_FAILED", "LINKEDIN_SESSION_EVICTED", "LINKEDIN_RATE_LIMITED", "LINKEDIN_COOKIE_INVALID", "LINKEDIN_SERVICE_UNAVAILABLE", "MESSAGE_WINDOW_EXPIRED", "RECIPIENT_UNREACHABLE", "CONNECTION_REQUEST_CONFLICT", "PAYMENT_REQUIRED", "PAYMENT_FAILED", "SUBSCRIPTION_BUSY", "SUBSCRIPTION_NOT_FOUND", "SEAT_NOT_FOUND", "SEAT_CANCELLED", "NOT_FOUND", "REACTION_NOT_FOUND", "SUBSTRATE_LINK_FAILED", "SUBSTRATE_CAP_REACHED", "BILLING_CHECKOUT_FAILED", "BILLING_PORTAL_UNAVAILABLE", "ACCOUNT_DISPUTED", "ACCOUNT_LINKING_DISABLED", "PERIOD_LOCKED", "SEAT_NOT_EMPTY", "SEAT_PROVISIONAL", "SUBSCRIPTION_ALREADY_EXISTS", "ALREADY_CANCELLED", "CANCELLATION_ALREADY_EFFECTIVE", "INVALID_CANCELLATION_SOURCE", "TRIAL_EXPIRED", "TRIAL_SEAT_LIMIT", "TRIAL_ACTIVE_SEAT_LIMIT", "TRIAL_IDENTITY_ALREADY_USED", "TRIAL_IDENTITY_UNRESOLVED", "ADMIN_BYPASS", "STRIPE_DRIFT_DETECTED", "DRAFT_LIMIT_REACHED", "MEDIA_QUOTA_EXCEEDED", "ACCOUNT_REQUIRED", "DRAFT_NOT_PUBLISHABLE", "SCHEDULE_CONFLICT", "DRAFT_PUBLISHING", "INTERNAL"];
 /**
  * The complete set of error codes observable by API callers.
  *
@@ -35086,6 +36389,31 @@ interface AccountPayload extends EventPayloadBase {
      */
     external_id?: string | null;
 }
+/**
+ * Payload of `post.published`: a scheduled Draft went out. Carries ids and
+ * times only, never the post text or media.
+ */
+interface PostPublishedPayload extends EventPayloadBase {
+    draft_id: string;
+    /** The published post's id; `null` when none was returned. */
+    post_id: string | null;
+    scheduled_at: string;
+    published_at: string;
+    /** Present when a warn-posture safety limit was breached by this publish. */
+    safety_warning?: unknown;
+}
+/**
+ * Payload of `post.publish_failed`: a scheduled Draft could not be published.
+ * `failure_code` `outcome_unknown` means the post may be live: check the
+ * account's posts before retrying. Never carries the post text or media.
+ */
+interface PostPublishFailedPayload extends EventPayloadBase {
+    draft_id: string;
+    /** The time that failed (the Draft's own `scheduled_at` is cleared on failure). */
+    scheduled_at: string;
+    failure_code: string;
+    failure_message: string;
+}
 /**
  * Delivery metadata that accompanies every Curviate webhook event.
  *
@@ -35219,6 +36547,12 @@ type CurviateEvent = CurviateEventEnvelope & ({
 } | {
     event: "account.initial_sync.failed";
     data: AccountPayload;
+} | {
+    event: "post.published";
+    data: PostPublishedPayload;
+} | {
+    event: "post.publish_failed";
+    data: PostPublishFailedPayload;
 });
 /**
  * Options for {@link constructEvent}.
@@ -35278,4 +36612,4 @@ interface ConstructEventOptions {
  */
 declare function constructEvent(rawBody: string | Buffer, signatureHeader: string, secret: string, opts?: ConstructEventOptions): Promise<CurviateEvent>;
 
-export { type AccountDetail, type AccountListPage, type AccountListParams, type AccountPayload, type AccountScopedNamespaces, type AccountUpdateBody, type AccountUpdateResult, type AuthIntentBody, type ConnectionCountry, type ConnectionLocation, type ConnectionLocationSource, type ConnectionPayload, type ConstructEventOptions, Curviate, type CurviateConfig, CurviateError, type CurviateErrorInit, type CurviateErrorJSON, type CurviateEvent, type CurviateEventEnvelope, ERROR_CODES, type ErrorCode, type EventPayloadBase, type MessagePayload, type ResolvedConfig, type ResourceNamespaces, type RetryHint, type SafetyHint, type SafetyReason, type SeatList, WebhookSignatureError, type components, constructEvent, isCurviateError, type operations, type paths };
+export { type AccountDetail, type AccountListPage, type AccountListParams, type AccountPayload, type AccountScopedNamespaces, type AccountUpdateBody, type AccountUpdateResult, type AuthIntentBody, type ConnectionCountry, type ConnectionLocation, type ConnectionLocationSource, type ConnectionPayload, type ConstructEventOptions, Curviate, type CurviateConfig, CurviateError, type CurviateErrorInit, type CurviateErrorJSON, type CurviateEvent, type CurviateEventEnvelope, type DraftAttachmentContentType, type DraftCreateBody, type DraftCreateResult, type DraftDeleteResult, type DraftGetResult, type DraftListParams, type DraftListResult, type DraftPublishResult, type DraftUpdateBody, type DraftUpdateResult, type DraftUploadOptions, type DraftUploadResult, ERROR_CODES, type ErrorCode, type EventPayloadBase, type MessagePayload, type PostPublishFailedPayload, type PostPublishedPayload, type ResolvedConfig, type ResourceNamespaces, type RetryHint, type SafetyHint, type SafetyReason, type SeatList, WebhookSignatureError, type components, constructEvent, isCurviateError, type operations, type paths };