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.
badge
Boolean specifying whether to enable the colophon badge on the kit, defaults to "true"
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 badge=false -F domains[]=example.com https://typekit.com/api/v1/json/kits | jsonpretty
{
  "kit": {
    "name": "Example",
    "id": "nfx3ygt",
    "analytics": false,
    "badge": "false",
    "domains": [
      "example.com"
    ],
    "families": [

    ]
  }
}

Creating a new kit with a font family:

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