kits

A list of kits owned by the authenticating user

Request methods

GET

Returns a list of kits owned by the authenticating user

POST

Creates a new draft kit, returns the updated information

Parameters

POST parameters:

name

Name of the kit

domains

A list of domains the kit will be used on

analytics

Boolean specifying whether to enable Google Analytics on the kit. This parameter has been deprecated, the result will always be "false" regardless of what is supplied.

families

A hash list of families included in the kit. The possible keys for each hash are:

id

The ID of the font family

subset

(optional) Character subset to use ("default" or "all"), defaults to "default"

variations

(optional) A list of font variations to use (formatted as a Font Variation Description), defaults to all available variations

segmented_css_names

Boolean specifying whether families in this kit should use segmented (droid-sans-1 and droid-sans-2) or unsegmented (droid-sans) CSS names. Defaults to "true" (segmented names). Read more about CSS names

Examples

Listing your kits:

$ curl -s -H $tk_auth https://typekit.com/api/v1/json/kits | jsonpretty
{
  "kits": [
    {
      "id": "ajd4dmw",
      "link": "/api/v1/json/kits/ajd4dmw/"
    },
    {
      "id": "ard8twk",
      "link": "/api/v1/json/kits/ard8twk/"
    }
  ]
}

Creating a new kit:

$ curl -s -H $tk_auth -F name=Example -F domains[]=example.com https://typekit.com/api/v1/json/kits | jsonpretty
{
  "kit": {
    "name": "Example",
    "id": "nfx3ygt",
    "analytics": false,
    "domains": [
      "example.com"
    ],
    "families": [

    ]
  }
}

Creating a new kit with a font family:

$ curl -s -H $tk_auth -F name=Example -F domains[]=example.com -F families[0][id]=gkmg https://typekit.com/api/v1/json/kits | jsonpretty
{
  "kit": {
    "name": "Example",
    "id": "nfx3ygt",
    "analytics": false,
    "domains": [
      "example.com"
    ],
    "families": [
      {
        "id": "gkmg",
        "name": "Droid Sans",
        "css_names": [
          "droid-sans-1",
          "droid-sans-2"
        ],
        "variations": [
          "n4",
          "n7"
        ],
        "subset": "default"
      }
    ]
  }
}