Knitt
Documentation

Overview

Base URL, versioning, and errors

Authentication

Include your API key in the Authorization header as a Bearer token. See Authentication for details.

Content-Type

Send JSON request bodies with Content-Type: application/json. File uploads use multipart/form-data.

Versioning

The current API version is v1. All endpoints include the version prefix and your tenant ID:

https://api.knitt.co/v1/{resource}/{tenant_id}/...

HTTP Methods

MethodUsage
GETRetrieve resources
POSTCreate new resources
PUTReplace a resource entirely
PATCHPartially update a resource
DELETERemove a resource

Error Format

All errors return a consistent JSON structure:

{
  "error": {
    "code": "not_found",
    "message": "The requested resource was not found."
  }
}

Status Codes

CodeMeaning
200OK
201Created
400Bad Request — invalid parameters
401Unauthorized — missing or invalid API key
403Forbidden — insufficient permissions
404Not Found — resource does not exist
429Too Many Requests — rate limit exceeded
500Internal Server Error

Rate Limiting

API calls are rate limited by your plan's monthly allocation. If you exceed the rate limit, requests return 429 Too Many Requests.

Endpoint Reference

Explore the full API with auto-generated code examples in JavaScript, Python, PHP, and cURL:

Content→Media→Forms→Webhooks→

Last updated: February 7, 2026