# Common Ninja API Documentation

This is the complete API documentation for connecting to the Common Ninja API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Common Ninja connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/commonNinja/actions/{actionSlug}/run
```

## Common Ninja actions

- POST `create-widget` Create Widget
- DELETE `delete-widget` Delete Widget
- GET `get-contact` Get Contact
- GET `get-project` Get Project
- GET `get-submission` Get Submission
- GET `get-user-details` Get User Details
- GET `get-widget` Get Widget
- GET `get-widget-analytics` Get Widget Analytics
- GET `get-widget-editor-url` Get Widget Editor URL
- GET `get-widget-embed-code` Get Widget Embed Code
- GET `get-widget-type` Get Widget Type
- GET `get-widget-type-schema` Get Widget Type Schema
- GET `list-contacts` List Contacts
- GET `list-projects` List Projects
- GET `list-submissions` List Submissions
- GET `list-widget-types` List Widget Types
- GET `list-widgets` List Widgets
- PUT `update-widget` Update Widget