COcodepen
Versions

List a Pen's saved versions

Saved versions, each with its build and without files. Versions never change once saved, so updated sorts them like created. A Pen made in the classic editor has none.

get/v2/pens/{id}/versions

Request

  • Base URL
    https://api.codepen.io
  • Auth
    • HTTP bearer
    • or API key in header X-API-Key

Query parameters

pageinteger

The page, from 1.

per_pageinteger

Items per page. A value over 100 is reduced to 100, not refused.

sort'created' | 'updated'

The order: by creation or update time.

direction'asc' | 'desc'

desc, the default, lists newest first.

Response

A page of versions.

created_atstring date-time required
deployedboolean required
hashstring required
idstring required
labelstring nullable required
pen_idstring required
preview_urlstring uri nullable required

Null for a dry run's version, or when the key cannot read the Pen.

savedboolean required

False only for a dry run's unsaved version.

Example response

[
  {
    "build": {
      "files": [
        {
          "name": "app.js",
          "path": "/src/app.js"
        }
      ]
    },
    "files": [
      {
        "name": "app.js",
        "path": "/src/app.js"
      }
    ]
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.