> ## Documentation Index > Fetch the complete documentation index at: https://docs.patch.gg/llms.txt > Use this file to discover all available pages before exploring further. # Set a take the person picked as the cover or tall cover > A wide take becomes the cover and a tall one the tall cover, replacing the old one once it's ready. It's published like any media: `processing` for a few seconds while Patch makes its copies, then `ready`. It's marked as made by an image model (`generated`). Only set one the person picked. ## OpenAPI ````yaml /api-reference/openapi.json post /projects/{owner}/{slug}/covers/takes/{take}/set openapi: 3.1.0 info: title: Patch API version: 1.0.0 description: >- The public API behind patch.gg, the desktop app and pch. Changes within v1 are additive only. Errors are { error: { code, message, details } }; branch on code. servers: - url: https://patch.gg/api/v1 security: [] paths: /projects/{owner}/{slug}/covers/takes/{take}/set: post: tags: - Covers summary: Set a take the person picked as the cover or tall cover description: >- A wide take becomes the cover and a tall one the tall cover, replacing the old one once it's ready. It's published like any media: `processing` for a few seconds while Patch makes its copies, then `ready`. It's marked as made by an image model (`generated`). Only set one the person picked. parameters: - schema: type: string example: patch required: true name: owner in: path - schema: type: string example: demo-mod required: true name: slug in: path - schema: type: string format: uuid required: true name: take in: path requestBody: content: application/json: schema: type: object properties: as: type: string enum: - cover - tall_cover required: - as responses: '200': description: The media, making its copies or ready content: application/json: schema: type: object properties: media: $ref: '#/components/schemas/Media' allowance: $ref: '#/components/schemas/CoversAllowance' required: - media - allowance '308': description: Renamed; follow the Location header '400': description: Invalid request content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Not signed in content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Not allowed content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearer: [] components: schemas: Media: type: object properties: id: type: string format: uuid kind: type: string enum: - cover - screenshot - clip - tall_cover - hover_clip description: >- cover: the wide 16:9 key art every card shows (one). screenshot: up to 20. clip: up to 5, for the game page. tall_cover: the tall 2:3 key art for where games stand as tall tiles (one). hover_clip: 4 to 8 seconds of play, no UI, that cards fade into while pointed at (one, at most 20 MB). A new cover, tall cover or hover clip replaces the old once it's ready. status: type: string enum: - pending - processing - ready - failed description: >- pending until its upload is completed. processing while its smaller copies are made: a few seconds for a picture and, for a clip, about as long as it plays. ready once they and the file are public, which is when it shows. failed when they couldn't be made, with why in `error`: complete it again to try again. Only its managers see it before it's ready. url: type: string description: Where it's served from, once it's ready levels: $ref: '#/components/schemas/MediaLevels' content_type: type: string sha256: type: string size: type: integer width: type: - integer - 'null' height: type: - integer - 'null' alt: type: - string - 'null' error: type: - string - 'null' description: Why its copies couldn't be made, when it's failed position: type: integer description: Order among media of the same kind generated: type: boolean description: >- Made by an image model: a cover or tall cover that's key art built from the game's real frames job_id: type: - string - 'null' format: uuid description: The covers job whose take it is, when Patch's free covers made it created_at: type: string required: - id - kind - status - url - levels - content_type - sha256 - size - width - height - alt - error - position - generated - job_id - created_at CoversAllowance: type: object properties: free: type: boolean enum: - true note: type: string description: >- Plain words for people and agents: Patch pays, and it costs the creator nothing takes_per_game: type: integer fixes_per_game: type: integer takes_used: type: integer fixes_used: type: integer takes_left: type: integer fixes_left: type: integer stopped: type: - string - 'null' description: >- Why none can be made now: covers_paused, covers_need_release (no release yet, not even a draft) or covers_allowance_used. Null when they can. required: - free - note - takes_per_game - fixes_per_game - takes_used - fixes_used - takes_left - fixes_left - stopped Error: type: object properties: error: type: object properties: code: type: string example: version_exists message: type: string details: {} required: - code - message required: - error MediaLevels: type: array items: type: object properties: width: type: integer url: type: string required: - width - url description: >- Smaller copies of a picture (WebP) or a clip (MP4, H.264, without sound), smallest first, each at its own address that never changes. Show the smallest that's sharp where it goes. Empty for animated pictures, for flat art and short clips with no smaller copy, and for media from before Patch made copies until theirs are made: then use the file itself. securitySchemes: bearer: type: http scheme: bearer description: An API key (pch_...) or the token from pch login. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.