--- title: "Get creative projects" method: GET path: "/api/v1/alpha/creative-projects/{id}" tags: ["alpha"] --- # Get creative projects `GET /api/v1/alpha/creative-projects/{id}` ## Request - Base URL: `https://point11.ai` - URL: `https://point11.ai/api/v1/alpha/creative-projects/{id}` - Auth: OAuth 2 (authorization code, authorization URL `https://auth.point11.ai/oauth2/authorize`, token URL `https://auth.point11.ai/oauth2/token`) Read a saved creative project and one page of its rounds, newest first (roundsCursor continues with nextRoundsCursor): each round's request, any refusal, and its immutable alternatives; and deliveredFileCount, the distinct files every round of the project delivered, whichever page is read. A project whose conversation was deleted is not found. ## Path parameters - `id` string, uuid, required ## Query parameters - `roundsCursor` string ## Headers - `Point11-Organization` string, uuid ## Response `200` Success. - AlphaCreativeProjectsGetResponse - `project` AlphaCreativeProjectsSelectResponse, required - `id` string, uuid, required - `conversationId` string, uuid, required - `name` string, required - `brief` AlphaBrief, required - `mode` 'channels' | 'assets' - `direction` string, required - `channels` string[], required - `assets` object[], required - `id` string, required - `label` string, required - `platforms` string[], required - `formats` string[], required - `specifications` object[], required - `revisionId` string, uuid, required - `output` AlphaOutputsItem, required - `id` string, required - `assetId` 'image-ad' | 'video-ad' | 'landing-page' | 'search-ad' | 'carousel-ad' | 'collection-ad' | 'email' | 'social-post' | 'product-image' | 'display-banner' | 'demo' | 'presentation' | 'document' | 'case-study' | 'website-section' | 'message' | 'lead-form' | 'thumbnail' | 'audio' | 'brand-graphic' | 'print' | 'music' | 'interactive', required - `label` string, required - `format` string, required - `platforms` string[], required - `placement` string, required - `ratio` string - `size` string - `note` string - `sources` object[], required - … - `restrictions` string[], required - `medium` 'text' | 'image' | 'video' | 'audio' | 'document' | 'presentation' | 'page' - `unit` 'feed' | 'story' | 'in-stream' | 'shorts' | 'search' | 'sitelinks' | 'display-banner' | 'responsive-display' | 'carousel' | 'collection' | 'pin' | 'gmail' | 'discover' | 'audio-spot' | 'podcast' | 'in-feed-video' | 'text-ad' | 'document-ad' | 'thumbnail' - `exports` object[] - … - `slots` object[] - … - `medium` 'text' | 'image' | 'video' | 'audio' | 'document' | 'presentation' | 'page' - `exports` object[] - `id` string, required - `role` 'main' | 'card' | 'cover' | 'tile' | 'logo' | 'companion' | 'thumbnail', required - `medium` 'text' | 'image' | 'video' | 'audio' | 'document' | 'presentation' | 'page', required - `width` integer - `height` integer - `ratio` string - `minWidth` integer - `minHeight` integer - `pixelDensity` integer - `formats` string[] - `maxBytes` integer - `minSeconds` number - `maxSeconds` number - `recommendedSeconds` number - `minCount` integer - `maxCount` integer - `loudnessLufs` number - `safeTop` number - `safeBottom` number - `safeSides` number - `slots` object[] - `slot` 'primaryText' | 'headline' | 'longHeadline' | 'description' | 'businessName' | 'callToAction' | 'displayUrl' | 'path1' | 'path2' | 'sitelinkText' | 'sitelinkDescription' | 'cardHeadline' | 'cardDescription' | 'hashtags' | 'subject' | 'preheader' | 'body' | 'script' | 'caption' | 'altText', required - `maxChars` integer - `minCount` integer, required - `maxCount` integer, required - `attachmentIds` string[], required - `models` AlphaModels - `research.ask_data` AlphaSelection - `modelId` string, required - `reasoning` union, required - object - … - object - … - object - … - object - … - object - … - `fallback` object, nullable - `modelId` string, required - `reasoning` union, required - … - `research.ask_data_creation` AlphaSelection - `modelId` string, required - `reasoning` union, required - object - … - object - … - object - … - object - … - object - … - `fallback` object, nullable - `modelId` string, required - `reasoning` union, required - … - `research.alpha_create_image` AlphaSelection - `modelId` string, required - `reasoning` union, required - object - … - object - … - object - … - object - … - object - … - `fallback` object, nullable - `modelId` string, required - `reasoning` union, required - … - `research.alpha_edit_image` AlphaSelection - `modelId` string, required - `reasoning` union, required - object - … - object - … - object - … - object - … - object - … - `fallback` object, nullable - `modelId` string, required - `reasoning` union, required - … - `revision` integer, required - `brandKitArtifactId` string, uuid, nullable, required - `selectedArtifactId` string, uuid, nullable, required - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `rounds` object[], required - `id` string, uuid, required - `projectId` string, uuid, required - `ordinal` integer, required - `mode` 'variants' | 'edit' | 'exact', required - `baseArtifactId` string, uuid, nullable, required - `instruction` string, required - `target` union, required - object - `artifactId` string, uuid, required - `region` object - `x` number, required - `y` number, required - `width` number, required - `height` number, required - object - `artifactId` string, uuid, required - `edits` object, required - `trimStartSeconds` number - `trimEndSeconds` number - `playbackRate` number - `volume` number - `fadeInSeconds` number - `fadeOutSeconds` number - `crop` object - `x` number, required - `y` number, required - `width` number, required - `height` number, required - `rotate` union - 0 - 90 - 180 - 270 - `flipHorizontal` boolean - `flipVertical` boolean - `brightness` number - `contrast` number - `saturation` number - `resize` object - `width` integer, required - `height` integer, required - `fit` 'cover' | 'contain', required - `background` 'black' | 'white' | 'transparent' - `format` 'png' | 'jpeg' | 'webp' | 'mp4' | 'mp3' | 'wav' - `maxBytes` integer - `loudnessLufs` number - `turnId` string, uuid, nullable, required - `pricingPolicy` 'studio-api-v1', nullable, required - `models` AlphaModels - `research.ask_data` AlphaSelection - `modelId` string, required - `reasoning` union, required - object - `type` 'provider-default', required - object - `type` 'enabled', required - object - `type` 'disabled', required - object - `type` 'effort', required - `effort` string, required - object - `type` 'budget-tokens', required - `budgetTokens` integer, required - `fallback` object, nullable - `modelId` string, required - `reasoning` union, required - object - … - object - … - object - … - object - … - object - … - `research.ask_data_creation` AlphaSelection - `modelId` string, required - `reasoning` union, required - object - `type` 'provider-default', required - object - `type` 'enabled', required - object - `type` 'disabled', required - object - `type` 'effort', required - `effort` string, required - object - `type` 'budget-tokens', required - `budgetTokens` integer, required - `fallback` object, nullable - `modelId` string, required - `reasoning` union, required - object - … - object - … - object - … - object - … - object - … - `research.alpha_create_image` AlphaSelection - `modelId` string, required - `reasoning` union, required - object - `type` 'provider-default', required - object - `type` 'enabled', required - object - `type` 'disabled', required - object - `type` 'effort', required - `effort` string, required - object - `type` 'budget-tokens', required - `budgetTokens` integer, required - `fallback` object, nullable - `modelId` string, required - `reasoning` union, required - object - … - object - … - object - … - object - … - object - … - `research.alpha_edit_image` AlphaSelection - `modelId` string, required - `reasoning` union, required - object - `type` 'provider-default', required - object - `type` 'enabled', required - object - `type` 'disabled', required - object - `type` 'effort', required - `effort` string, required - object - `type` 'budget-tokens', required - `budgetTokens` integer, required - `fallback` object, nullable - `modelId` string, required - `reasoning` union, required - object - … - object - … - object - … - object - … - object - … - `refusal` object, nullable, required - `code` string, required - `message` string, required - `createdAt` string, date-time, required - `result` object, required - `status` 'unsubmitted' | 'refused' | 'reserved' | 'running' | 'succeeded' | 'failed' | 'unavailable', required - `alternatives` object[], required - `artifactId` string, uuid, required - `title` string, required - `kind` 'markdown' | 'slides' | 'image' | 'audio' | 'video' | 'brand_kit' | 'presentation' | 'spreadsheet' | 'word' | 'pdf' | 'csv' | 'page', required - `mediaType` 'text/markdown' | 'application/vnd.point11.slides+json' | 'image/png' | 'image/jpeg' | 'image/webp' | 'audio/mpeg' | 'audio/wav' | 'video/mp4' | 'video/webm' | 'application/vnd.point11.brand-kit+json' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/pdf' | 'text/csv' | 'text/html' | 'application/vnd.point11.website+json', required - `byteLength` number, required - `previewArtifactId` string, uuid - `isPackage` boolean - `deliverables` AlphaDeliverablesItem[] - `assetId` string, required - `format` string, required - `platforms` string[], required - `artifactIds` string[], required - `fileRoles` string[] - `primaryText` string - `headline` string - `longHeadline` string - `description` string - `businessName` string - `callToAction` string - `displayUrl` string - `destinationUrl` string - `path1` string - `path2` string - `headlines` string[] - `descriptions` string[] - `sitelinkTexts` string[] - `sitelinkDescriptions` string[] - `cardHeadlines` string[] - `cardDescriptions` string[] - `hashtags` string[] - `subjects` string[] - `preheader` string - `body` string - `messages` string[] - `script` string - `caption` string - `altText` string - `deliverableFiles` object[] - `artifactId` string, uuid, required - `title` string, required - `kind` 'markdown' | 'slides' | 'image' | 'audio' | 'video' | 'brand_kit' | 'presentation' | 'spreadsheet' | 'word' | 'pdf' | 'csv' | 'page', required - `mediaType` 'text/markdown' | 'application/vnd.point11.slides+json' | 'image/png' | 'image/jpeg' | 'image/webp' | 'audio/mpeg' | 'audio/wav' | 'video/mp4' | 'video/webm' | 'application/vnd.point11.brand-kit+json' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/pdf' | 'text/csv' | 'text/html' | 'application/vnd.point11.website+json', required - `byteLength` number - `billing` object, nullable, required - `runId` string, uuid, required - `pricingPolicy` 'studio-api-v1', required - `state` 'pending' | 'settled' | 'absorbed', required - `amountUsd` string, nullable, required - `knownSubtotalUsd` string, required - `unresolvedCount` integer, required - `settledAt` string, date-time, nullable, required - `delivery` object, nullable, required - `hourStart` string, date-time, required - `state` 'unreported' | 'accepted' | 'verified' | 'expired', required - `nextRoundsCursor` string, nullable, required - `deliveredFileCount` integer, required ## Other responses - `400`: The input, query, or Idempotency-Key is invalid. - `401`: The bearer is missing, expired, or not accepted. - `403`: The credential lacks the operation's scope or role, or the operation needs a different door. - `404`: The resource or organization does not exist for this caller. - `405`: This path takes another HTTP method, named in `Allow`. - `409`: The request conflicts with current state or with prior use of its Idempotency-Key. - `413`: The request, or the answer it asks for, is too large; narrow it. - `429`: The credential's rate budget is spent; retry after `Retry-After` seconds. - `500`: An unexpected server failure; retry later. Only `request_id` identifies it. - `503`: A dependency is temporarily unavailable; retry after `Retry-After` seconds. - `default`: Another status a product answers for its own refusal (for example `415` for an unsupported attachment); branch on `code`. --- [API](https://skmtc.dev/point11/apis/point11-api.md) · [All operations](https://skmtc.dev/point11/apis/point11-api/llms.txt) · [OpenAPI document](https://skmtc.dev/point11/apis/point11-api/revisions/36a84c7aca11?raw)