Overview

This document provides detailed information on how to work with the Common Ninja API to interact with and extend our extensive collection of widgets. The API provides access to read and update widget data, read personal basic data (email, name), and read project data.

Error Responses

When a request fails, the API responds with a JSON body containing a message field that describes what went wrong:

{
  "message": "Widget 894f5aed-29f5-46c5-9f26-022bfccc5292 not found"
}

Status	Meaning
401	Missing, invalid, or expired access token. See Authentication.
404	The requested resource (widget, project, contact, submission) doesn't exist — or it exists but isn't accessible with the authenticated account's permissions.
500	Unexpected server error. If the problem persists, please contact support.

Please Note

A 404 is returned both for resources that don't exist and for resources owned by a different account. If a widget renders publicly but the API returns 404, verify you're authenticating with the account that owns the widget.