---
search:
  tags:
    - Operations
    - PUT
seo:
  description: >-
    Uses an uploaded image as the link card's image. It stays through Refresh…
    Reference for the PUT /v1/cards/{cardId}/thumbnail endpoint in the Teak API.
sidebar:
  label: Replace a link's image
  badge: PUT
title: Replace a link's image
type: openapi-operation
---
Uses an uploaded image as the link card's image. It stays through Refresh details and new link previews until it is reset.

`PUT /v1/cards/{cardId}/thumbnail`

**Request body** (`application/json`)

- `fileKey` (string, required) — From POST /v1/cards/{cardId}/thumbnail/upload, for this card

Request body example:

```json
{
  "fileKey": "string"
}
```

**Responses**

- `200` — The card, showing the new image as linkPreviewImageUrl with thumbnailOverridden true
- `400` — TYPE\_MISMATCH: not a link card. UNSUPPORTED\_TYPE: not an accepted image type (JPEG, PNG, WebP, GIF (its first frame) or AVIF. SVG and HEIC are refused.). INVALID\_INPUT: the image couldn't be read, or is over 10,000 pixels on a side
- `404` — The card, or the upload for it, was not found
- `409` — The card is in Trash
- `413` — FILE\_TOO\_LARGE: images must be under 20 MB
- `429` — RATE\_LIMITED: 20 image changes a minute; \`retryAt\` and Retry-After say when to try again

Response example, 200:

```json
{
  "aiSummary": "string",
  "aiTags": [
    "string"
  ],
  "aiTranscript": "string",
  "appUrl": "http://example.com",
  "compactUrl": "string",
  "content": "string",
  "isDeleted": true,
  "metadataStatus": "string",
  "processingStatus": {},
  "linkPreviewDescription": "string",
  "linkFacts": [
    {
      "label": "string",
      "value": "string"
    }
  ],
  "linkPreviewTitle": "string",
  "linkPrice": {
    "amount": 0,
    "currency": "string"
  },
  "linkFaviconUrl": "string",
  "fileWidth": 0,
  "fileHeight": 0,
  "audioWaveform": {
    "detail": [
      0
    ],
    "grid": [
      0
    ]
  },
  "videoScrub": {
    "frameHeight": 0,
    "frameWidth": 0,
    "frames": 0,
    "url": "string"
  },
  "colors": [
    {
      "hex": "string",
      "name": "string"
    }
  ],
  "createdAt": 0,
  "detailUrl": "string",
  "fileExtension": "string",
  "fileKind": "string",
  "fileLanguage": "string",
  "fileName": "string",
  "filePreview": {},
  "fileSize": 0,
  "fileUrl": "string",
  "id": "string",
  "archivedAt": 0,
  "folderIds": [
    "string"
  ],
  "isArchived": true,
  "isFavorited": true,
  "linkPreviewImageUrl": "string",
  "linkPreviewMedia": [
    {
      "type": "image",
      "url": "string",
      "contentType": "string",
      "width": 0,
      "height": 0,
      "posterUrl": "string",
      "posterContentType": "string",
      "posterWidth": 0,
      "posterHeight": 0
    }
  ],
  "linkSiteName": "string",
  "linkAuthor": "string",
  "linkPublisher": "string",
  "linkPublishedAt": "string",
  "metadataDescription": "string",
  "metadataTitle": "string",
  "mimeType": "string",
  "notes": "string",
  "placeholderUrl": "string",
  "screenshotUrl": "string",
  "tags": [
    "string"
  ],
  "thumbnailOverridden": true,
  "thumbnailUrl": "string",
  "type": "string",
  "updatedAt": 0,
  "url": "string"
}
```