---
search:
  tags:
    - Operations
    - PUT
seo:
  description: >-
    Sets the order of the cards pinned to the top of the library. List every
    pinned card's… Reference for the PUT /v1/cards/pinned/order endpoint in the
    Teak API.
sidebar:
  label: Reorder pinned cards
  badge: PUT
title: Reorder pinned cards
type: openapi-operation
---
Sets the order of the cards pinned to the top of the library. List every pinned card's id once, first to last; get them with `GET /v1/cards?pinned=true`.

`PUT /v1/cards/pinned/order`

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

- `cardIds` (string[], required) — Every pinned card's id exactly once, first to last. At most 12.

Request body example:

```json
{
  "cardIds": [
    "string"
  ]
}
```

**Responses**

- `200` — The pinned cards in their new order
- `400` — INVALID\_INPUT: \`cardIds\` doesn't list every pinned card exactly once

Response example, 200:

```json
{
  "items": [
    {
      "aiSummary": "string",
      "aiTags": [
        "string"
      ],
      "aiTranscript": "string",
      "appUrl": "http://example.com",
      "archive": {
        "bytes": 0,
        "capturedAt": 0,
        "kind": "full"
      },
      "article": {
        "readingMinutes": 0,
        "wordCount": 0
      },
      "highlightCount": 0,
      "compactUrl": "string",
      "content": "string",
      "colors": [
        {
          "hex": "string",
          "name": "string"
        }
      ],
      "createdAt": 0,
      "detailUrl": "string",
      "fileName": "string",
      "fileSize": 0,
      "mimeType": "string",
      "fileExtension": "string",
      "fileKind": "string",
      "fileLanguage": "string",
      "filePreview": {},
      "fileHeight": 0,
      "fileWidth": 0,
      "audioWaveform": {
        "detail": [
          0
        ],
        "grid": [
          0
        ]
      },
      "videoScrub": {
        "frameHeight": 0,
        "frameWidth": 0,
        "frames": 0,
        "url": "string"
      },
      "fileUrl": "string",
      "id": "string",
      "isDeleted": true,
      "isArchived": true,
      "completedAt": 0,
      "folderIds": [
        "string"
      ],
      "isFavorited": true,
      "isPinned": true,
      "isHidden": true,
      "linkPreviewImageUrl": "string",
      "linkPreviewDescription": "string",
      "linkFacts": [
        {
          "label": "string",
          "value": "string"
        }
      ],
      "linkFaviconUrl": "string",
      "linkPreviewTitle": "string",
      "linkCategory": "string",
      "linkPrice": {
        "amount": 0,
        "currency": "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",
      "notes": "string",
      "placeholderUrl": "string",
      "metadataStatus": "string",
      "processingStatus": {},
      "savedAt": 0,
      "screenshotUrl": "string",
      "sourceTitle": "string",
      "sourceUrl": "string",
      "tags": [
        "string"
      ],
      "thumbnailOverridden": true,
      "thumbnailUrl": "string",
      "type": "string",
      "updatedAt": 0,
      "url": "string"
    }
  ]
}
```