@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/adCreatives.d.ts

@@ -0,0 +1,996 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.adCreatives` (Ad Creatives): 40 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"apply_ad_creative_review_findings_ad_creatives__creative_id__ai_review_apply_post">;
+ *
+ * Reference with examples: adCreatives.md
+ */
+/* eslint-disable */
+
+/** `g8.api.adCreatives.<member>` -> the operationId it calls. */
+export interface AdCreativesMembers {
+  applyAdCreativeReviewFindings: "apply_ad_creative_review_findings_ad_creatives__creative_id__ai_review_apply_post";
+  chatEditAdCreative: "chat_edit_ad_creative_ad_creatives__creative_id__chat_edit_post";
+  continueVideoClip: "continue_video_clip_ad_creatives_video_clips__clip_id__continue_post";
+  createAdCreative: "create_ad_creative_ad_creatives_post";
+  createAdCreativeSet: "create_ad_creative_set_ad_creatives_batch_post";
+  createAdCreativeSizeSet: "create_ad_creative_size_set_ad_creatives__creative_id__size_set_post";
+  createVideoAdCreative: "create_video_ad_creative_ad_creatives_video_post";
+  deleteAdCreative: "delete_ad_creative_ad_creatives__creative_id__delete";
+  discardVideoClip: "discard_video_clip_ad_creatives_video_clips__clip_id__delete";
+  editAdCreativeImageAtPoint: "edit_ad_creative_image_at_point_ad_creatives__creative_id__image_edit_at_point_post";
+  editAdCreativeImageElement: "edit_ad_creative_image_element_ad_creatives__creative_id__image_element_post";
+  enhanceVideoClipPrompt: "enhance_video_clip_prompt_ad_creatives_video_clips_prompt_enhance_post";
+  extendVideoClip: "extend_video_clip_ad_creatives_video_clips__clip_id__extend_post";
+  generateAdConcepts: "generate_ad_concepts_ad_creatives_concepts_post";
+  generateVideoClip: "generate_video_clip_ad_creatives_video_clips_post";
+  getAdCreative: "get_ad_creative_ad_creatives__creative_id__get";
+  getAdCreativeConversation: "get_ad_creative_conversation_ad_creatives__creative_id__conversation_get";
+  getAdCreativeSpecs: "get_ad_creative_specs_ad_creatives_specs_get";
+  getAdCreativeStatus: "get_ad_creative_status_ad_creatives__creative_id__status_get";
+  getVideoClip: "get_video_clip_ad_creatives_video_clips__clip_id__get";
+  listAdCreativeImageElements: "list_ad_creative_image_elements_ad_creatives__creative_id__image_elements_get";
+  listAdCreativeRevisions: "list_ad_creative_revisions_ad_creatives__creative_id__revisions_get";
+  listAdCreatives: "list_ad_creatives_ad_creatives_get";
+  listVideoAdTemplates: "list_video_ad_templates_ad_creatives_video_templates_get";
+  listVideoClips: "list_video_clips_ad_creatives_video_clips_get";
+  moveAdCreativeToDraft: "move_ad_creative_to_draft_ad_creatives__creative_id__move_to_draft_post";
+  moveAdCreativeToGallery: "move_ad_creative_to_gallery_ad_creatives__creative_id__move_to_gallery_post";
+  readAdCreativeThroughPersona: "read_ad_creative_through_persona_ad_creatives__creative_id__persona_lens_post";
+  regenerateAdCreativeCopy: "regenerate_ad_creative_copy_ad_creatives__creative_id__regenerate_copy_post";
+  regenerateAdCreativeImage: "regenerate_ad_creative_image_ad_creatives__creative_id__regenerate_image_post";
+  regenerateVideoClip: "regenerate_video_clip_ad_creatives_video_clips__clip_id__regenerate_post";
+  reskinAdCreative: "reskin_ad_creative_ad_creatives__creative_id__reskin_post";
+  restoreAdCreativeRevision: "restore_ad_creative_revision_ad_creatives__creative_id__restore_revision_post";
+  retryAdCreativeGeneration: "retry_ad_creative_generation_ad_creatives__creative_id__retry_post";
+  reviewAdCreative: "review_ad_creative_ad_creatives__creative_id__ai_review_post";
+  rewriteAdCreativeField: "rewrite_ad_creative_field_ad_creatives__creative_id__rewrite_field_post";
+  saveAdCreativeAsTemplate: "save_ad_creative_as_template_ad_creatives__creative_id__save_as_template_post";
+  setAdCreativeImage: "set_ad_creative_image_ad_creatives__creative_id__set_image_post";
+  setAdCreativeImageFocus: "set_ad_creative_image_focus_ad_creatives__creative_id__set_image_focus_post";
+  updateAdCreative: "update_ad_creative_ad_creatives__creative_id__patch";
+}
+
+/** Input and output of every `g8.api.adCreatives` operation, keyed by operationId. */
+export interface AdCreativesOperations {
+  /**
+   * POST /ad-creatives/{creative_id}/ai-review/apply
+   * Apply Ad Creative Review Findings
+   * tier: write · scope: campaigns:write
+   */
+  apply_ad_creative_review_findings_ad_creatives__creative_id__ai_review_apply_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ApplyFindingsRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/chat-edit
+   * Chat Edit Ad Creative
+   * tier: billable · scope: campaigns:run
+   */
+  chat_edit_ad_creative_ad_creatives__creative_id__chat_edit_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: AdCreativeChatEditRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/video/clips/{clip_id}/continue
+   * Continue Video Clip
+   * tier: billable · scope: campaigns:run
+   */
+  continue_video_clip_ad_creatives_video_clips__clip_id__continue_post: {
+    input: {
+    path: {
+      /** Video clip id. */
+      clip_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ContinueVideoClipRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives
+   * Create Ad Creative
+   * tier: billable · scope: campaigns:run
+   */
+  create_ad_creative_ad_creatives_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateAdCreativeRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/batch
+   * Create Ad Creative Set
+   * tier: billable · scope: campaigns:run
+   */
+  create_ad_creative_set_ad_creatives_batch_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateAdCreativeSetRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/size-set
+   * Create Ad Creative Size Set
+   * tier: billable · scope: campaigns:run
+   */
+  create_ad_creative_size_set_ad_creatives__creative_id__size_set_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: SizeSetRequest | null;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/video
+   * Create Video Ad Creative
+   * tier: write · scope: campaigns:write
+   */
+  create_video_ad_creative_ad_creatives_video_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: CreateVideoCreativeRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * DELETE /ad-creatives/{creative_id}
+   * Delete Ad Creative
+   * tier: destructive · scope: campaigns:delete
+   */
+  delete_ad_creative_ad_creatives__creative_id__delete: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * DELETE /ad-creatives/video/clips/{clip_id}
+   * Discard Video Clip
+   * tier: destructive · scope: campaigns:delete
+   */
+  discard_video_clip_ad_creatives_video_clips__clip_id__delete: {
+    input: {
+    path: {
+      /** Video clip id. */
+      clip_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/image-edit-at-point
+   * Edit Ad Creative Image At Point
+   * tier: billable · scope: campaigns:run
+   */
+  edit_ad_creative_image_at_point_ad_creatives__creative_id__image_edit_at_point_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ImagePointEditRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/image-element
+   * Edit Ad Creative Image Element
+   * tier: write · scope: campaigns:write
+   */
+  edit_ad_creative_image_element_ad_creatives__creative_id__image_element_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: EditImageElementRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/video/clips/prompt-enhance
+   * Enhance Video Clip Prompt
+   * tier: billable · scope: campaigns:run
+   */
+  enhance_video_clip_prompt_ad_creatives_video_clips_prompt_enhance_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: VideoPromptEnhanceRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/video/clips/{clip_id}/extend
+   * Extend Video Clip
+   * tier: billable · scope: campaigns:run
+   */
+  extend_video_clip_ad_creatives_video_clips__clip_id__extend_post: {
+    input: {
+    path: {
+      /** Video clip id. */
+      clip_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/concepts
+   * Generate Ad Concepts
+   * tier: billable · scope: campaigns:run
+   */
+  generate_ad_concepts_ad_creatives_concepts_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ConceptsRequest;
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * POST /ad-creatives/video/clips
+   * Generate Video Clip
+   * tier: billable · scope: campaigns:run
+   */
+  generate_video_clip_ad_creatives_video_clips_post: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: GenerateVideoClipRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /ad-creatives/{creative_id}
+   * Get Ad Creative
+   * tier: read · scope: campaigns:read
+   */
+  get_ad_creative_ad_creatives__creative_id__get: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /ad-creatives/{creative_id}/conversation
+   * Get Ad Creative Conversation
+   * tier: read · scope: campaigns:read
+   */
+  get_ad_creative_conversation_ad_creatives__creative_id__conversation_get: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /ad-creatives/specs
+   * Get Ad Creative Specs
+   * tier: read · scope: campaigns:read
+   */
+  get_ad_creative_specs_ad_creatives_specs_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /ad-creatives/{creative_id}/status
+   * Get Ad Creative Status
+   * tier: read · scope: campaigns:read
+   */
+  get_ad_creative_status_ad_creatives__creative_id__status_get: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /ad-creatives/video/clips/{clip_id}
+   * Get Video Clip
+   * tier: read · scope: campaigns:read
+   */
+  get_video_clip_ad_creatives_video_clips__clip_id__get: {
+    input: {
+    path: {
+      /** Video clip id. */
+      clip_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * GET /ad-creatives/{creative_id}/image-elements
+   * List Ad Creative Image Elements
+   * tier: read · scope: campaigns:read
+   */
+  list_ad_creative_image_elements_ad_creatives__creative_id__image_elements_get: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /ad-creatives/{creative_id}/revisions
+   * List Ad Creative Revisions
+   * tier: read · scope: campaigns:read
+   */
+  list_ad_creative_revisions_ad_creatives__creative_id__revisions_get: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /ad-creatives
+   * List Ad Creatives
+   * tier: read · scope: campaigns:read
+   */
+  list_ad_creatives_ad_creatives_get: {
+    input: {
+    query?: {
+      /** Filter by status. */
+      status?: string | null;
+      /** Filter to one platform. */
+      platform?: string | null;
+      /** Filter to one format - landscape, square, portrait, ... */
+      ad_format?: string | null;
+      /** List reusable TEMPLATES instead of working creatives. */
+      templates?: boolean;
+      limit?: number;
+      offset?: number;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /ad-creatives/video-templates
+   * List Video Ad Templates
+   * tier: read · scope: campaigns:read
+   */
+  list_video_ad_templates_ad_creatives_video_templates_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * GET /ad-creatives/video/clips
+   * List Video Clips
+   * tier: read · scope: campaigns:read
+   */
+  list_video_clips_ad_creatives_video_clips_get: {
+    input: {
+    query?: {
+      /** Only the clips attached to this creative. */
+      creative_id?: string | null;
+      /** Include clips you discarded. */
+      include_discarded?: boolean;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentListPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/move-to-draft
+   * Move Ad Creative To Draft
+   * tier: write · scope: campaigns:write
+   */
+  move_ad_creative_to_draft_ad_creatives__creative_id__move_to_draft_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/move-to-gallery
+   * Move Ad Creative To Gallery
+   * tier: write · scope: campaigns:write
+   */
+  move_ad_creative_to_gallery_ad_creatives__creative_id__move_to_gallery_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/persona-lens
+   * Read Ad Creative Through Persona
+   * tier: billable · scope: campaigns:run
+   */
+  read_ad_creative_through_persona_ad_creatives__creative_id__persona_lens_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: PersonaLensRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/regenerate-copy
+   * Regenerate Ad Creative Copy
+   * tier: billable · scope: campaigns:run
+   */
+  regenerate_ad_creative_copy_ad_creatives__creative_id__regenerate_copy_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/regenerate-image
+   * Regenerate Ad Creative Image
+   * tier: billable · scope: campaigns:run
+   */
+  regenerate_ad_creative_image_ad_creatives__creative_id__regenerate_image_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/video/clips/{clip_id}/regenerate
+   * Regenerate Video Clip
+   * tier: billable · scope: campaigns:run
+   */
+  regenerate_video_clip_ad_creatives_video_clips__clip_id__regenerate_post: {
+    input: {
+    path: {
+      /** Video clip id. */
+      clip_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/reskin
+   * Reskin Ad Creative
+   * tier: write · scope: campaigns:write
+   */
+  reskin_ad_creative_ad_creatives__creative_id__reskin_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: ReskinRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/restore-revision
+   * Restore Ad Creative Revision
+   * tier: write · scope: campaigns:write
+   */
+  restore_ad_creative_revision_ad_creatives__creative_id__restore_revision_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RestoreRevisionRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/retry
+   * Retry Ad Creative Generation
+   * tier: billable · scope: campaigns:run
+   */
+  retry_ad_creative_generation_ad_creatives__creative_id__retry_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/ai-review
+   * Review Ad Creative
+   * tier: billable · scope: campaigns:run
+   */
+  review_ad_creative_ad_creatives__creative_id__ai_review_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body?: AdAIReviewRequest | null;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/rewrite-field
+   * Rewrite Ad Creative Field
+   * tier: billable · scope: campaigns:run
+   */
+  rewrite_ad_creative_field_ad_creatives__creative_id__rewrite_field_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: RewriteFieldRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/save-as-template
+   * Save Ad Creative As Template
+   * tier: write · scope: campaigns:write
+   */
+  save_ad_creative_as_template_ad_creatives__creative_id__save_as_template_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/set-image
+   * Set Ad Creative Image
+   * tier: write · scope: campaigns:write
+   */
+  set_ad_creative_image_ad_creatives__creative_id__set_image_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SetImageRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * POST /ad-creatives/{creative_id}/set-image-focus
+   * Set Ad Creative Image Focus
+   * tier: write · scope: campaigns:write
+   */
+  set_ad_creative_image_focus_ad_creatives__creative_id__set_image_focus_post: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: SetImageFocusRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+  /**
+   * PATCH /ad-creatives/{creative_id}
+   * Update Ad Creative
+   * tier: write · scope: campaigns:write
+   */
+  update_ad_creative_ad_creatives__creative_id__patch: {
+    input: {
+    path: {
+      /** Ad creative id. */
+      creative_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+    body: UpdateAdCreativeRequest;
+  };
+    output: ApiResponse_StudioContentPayload_;
+  };
+}
+
+// 30 schemas referenced above (the same as G8Contract.<Name>).
+
+/**
+ * Run a review pass over the creative. SPENDS CREDIT.
+ *
+ * `deep` defaults FALSE here and TRUE on the landing-page review. That
+ * asymmetry is the app's and is preserved rather than smoothed over: the two
+ * passes cost differently.
+ */
+export interface AdAIReviewRequest {
+  deep?: boolean;
+}
+
+/** A natural-language edit to one creative. SPENDS CREDIT - a model runs. */
+export interface AdCreativeChatEditRequest {
+  instruction: string;
+}
+
+export interface ApiResponse_StudioContentListPayload_ {
+  data: StudioContentListPayload;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_StudioContentPayload_ {
+  data: StudioContentPayload;
+  pagination?: PaginationMeta | null;
+}
+
+/** Apply review findings DETERMINISTICALLY. Spends nothing. */
+export interface ApplyFindingsRequest {
+  finding_ids: Array<string>;
+}
+
+/** A buyer persona, as the lens pass needs to see it. */
+export interface CampaignSetPersona {
+  id?: string | null;
+  summary?: string | null;
+  title: string;
+}
+
+/** One colour replaced by another, both as hex. */
+export interface ColorSwap {
+  from_color: string;
+  to_color: string;
+}
+
+/**
+ * Cheap creative directions to react to BEFORE generating. SPENDS CREDIT.
+ *
+ * One LLM call for 3-6 directions, which is the point: it is far cheaper
+ * than generating that many creatives and throwing five away.
+ */
+export interface ConceptsRequest {
+  brief?: string | null;
+  count?: number;
+}
+
+/** Generate the NEXT shot, starting from this clip's last frame. SPENDS CREDIT. */
+export interface ContinueVideoClipRequest {
+  duration_seconds?: 4 | 6 | 8;
+  prompt_final?: string | null;
+  prompt_inputs: VideoClipPromptInputs;
+}
+
+/**
+ * Generate an ad creative. SPENDS CREDIT - copy and, by default, imagery.
+ *
+ * `image_source` 'ai' generates the image; 'library' takes
+ * `library_image_id` from the image library instead and is the cheaper of
+ * the two.
+ */
+export interface CreateAdCreativeRequest {
+  ad_format: string;
+  campaign_id?: string | null;
+  /** 'ai' generates an image; 'library' reuses one. */
+  image_source?: string;
+  library_image_id?: string | null;
+  name?: string | null;
+  platform: string;
+  prompt?: string | null;
+  reference_image_ids?: Array<string> | null;
+}
+
+/**
+ * Generate a persona x platform (x variant) matrix of creatives. SPENDS CREDIT.
+ *
+ * One full creative per cell: `len(personas) * len(platforms) *
+ * variants_per_cell`, capped at 24 per batch (a larger matrix is a 422).
+ * AI imagery only - `image_source` is fixed to `ai`.
+ */
+export interface CreateAdCreativeSetRequest {
+  brief?: string | null;
+  /** Platform -> ad_format override. Omit for each platform's default. */
+  formats?: Record<string, unknown> | null;
+  image_source?: "ai";
+  personas: Array<CampaignSetPersona>;
+  platforms: Array<string>;
+  variants_per_cell?: number;
+}
+
+/**
+ * Assemble clips into a video ad on a template. Spends nothing itself -
+ * the clips were paid for when they were generated.
+ */
+export interface CreateVideoCreativeRequest {
+  campaign_id?: string | null;
+  name?: string | null;
+  storyboard: VideoStoryboard;
+  template_id: string;
+}
+
+/**
+ * Deterministic in-image edit. NO MODEL RUNS, nothing is spent.
+ *
+ * At least one of `text` / `fill` / `font_size` must be present; `index`
+ * identifies which element, from `GET /ad-creatives/{id}/image-elements`.
+ */
+export interface EditImageElementRequest {
+  fill?: string | null;
+  font_size?: number | null;
+  index: number;
+  text?: string | null;
+}
+
+/** Generate one video clip. SPENDS CREDIT - priced per second of footage. */
+export interface GenerateVideoClipRequest {
+  aspect_ratio?: "16:9" | "9:16";
+  creative_id?: string | null;
+  duration_seconds?: 4 | 6 | 8;
+  prompt_final?: string | null;
+  prompt_inputs: VideoClipPromptInputs;
+  reference_image_urls?: Array<string>;
+  start_image_url?: string | null;
+}
+
+/** Pin a point on the image and say what changes there. SPENDS CREDIT. */
+export interface ImagePointEditRequest {
+  instruction: string;
+  x: number;
+  y: number;
+}
+
+export interface PaginationMeta {
+  /** Whether there are more pages */
+  has_next: boolean;
+  /** Items per page */
+  limit: number;
+  /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
+  next_cursor?: string | null;
+  /** Current page number (1-indexed) */
+  page: number;
+  /** Total number of items */
+  total: number;
+}
+
+/**
+ * Read the ad through a persona's eyes. SPENDS CREDIT.
+ *
+ * Read-only against the creative - it returns a critique and changes
+ * nothing - but a model still runs, so it still costs.
+ */
+export interface PersonaLensRequest {
+  persona: CampaignSetPersona;
+}
+
+/** Swap the creative's palette. Deterministic, spends nothing. */
+export interface ReskinRequest {
+  swaps: Array<ColorSwap>;
+}
+
+/** Roll back to a snapshot. The restore is itself snapshotted first. */
+export interface RestoreRevisionRequest {
+  index: number;
+}
+
+/** Rewrite ONE copy field with AI. SPENDS CREDIT. */
+export interface RewriteFieldRequest {
+  field: string;
+  instruction: string;
+}
+
+/** Move the crop focal point, 0-1 in each axis. Spends nothing. */
+export interface SetImageFocusRequest {
+  focus_x?: number;
+  focus_y?: number;
+}
+
+/** Point the creative at an image already in the library. Spends nothing. */
+export interface SetImageRequest {
+  library_image_id: string;
+}
+
+/**
+ * Fan one creative out into the platform's other formats. SPENDS CREDIT.
+ *
+ * Copy is locked verbatim; the imagery is re-laid-out per format, so the
+ * cost scales with how many formats you ask for. Omit `formats` for the
+ * platform's full set.
+ */
+export interface SizeSetRequest {
+  formats?: Array<string> | null;
+}
+
+/**
+ * A LIST result, open-shaped, with `items` always present.
+ *
+ * The app returns a bare list from some routes and a named key from others
+ * (`pages`, `grids`, `images`, `creatives`, `reports`, `items`). Both are
+ * published: the original key is preserved AND mirrored onto `items`, so a
+ * client can page any Studio collection the same way without a per-route
+ * lookup table.
+ */
+export interface StudioContentListPayload {
+  items?: Array<unknown>;
+  [key: string]: unknown;
+}
+
+/** One Studio object, open-shaped. See the module docstring. */
+export type StudioContentPayload = Record<string, unknown>;
+
+/** Edit the copy by hand. No model runs, nothing is spent. */
+export interface UpdateAdCreativeRequest {
+  cta?: string | null;
+  description?: string | null;
+  headline?: string | null;
+  name?: string | null;
+  primary_text?: string | null;
+}
+
+/** The structured shot description. `subject` is the only required field. */
+export interface VideoClipPromptInputs {
+  camera?: string | null;
+  lighting?: string | null;
+  negative?: string | null;
+  setting?: string | null;
+  style?: string | null;
+  subject: string;
+}
+
+/** Turn the structured shot form into one generation prompt. SPENDS CREDIT (small). */
+export interface VideoPromptEnhanceRequest {
+  prompt_inputs: VideoClipPromptInputs;
+}
+
+/** One clip on the storyboard, optionally trimmed. */
+export interface VideoShot {
+  clip_id: string;
+  in_s?: number | null;
+  out_s?: number | null;
+}
+
+/** The ordered shots (1-5) and the copy for the template's text slots. */
+export interface VideoStoryboard {
+  /** Copy slot id (headline, subline, cta, ...) -> text. */
+  copy?: Record<string, string>;
+  shots?: Array<VideoShot>;
+}