intencheck-com API Keys API
API Key Management for your integrations
API Key Management for your integrations
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/intencheck-com:intencheck-com-api-keys-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: IntenCheck API Keys API
description: 'IntenCheck provides a comprehensive suite of Deep NLP text analysis endpoints that detect meta-programs, emotions, moods, and communication styles.
It supports multiple input and output languages natively.
## Quick Start
1. **Get your API Key** from the developer dashboard.
2. **Analyze Text** to get a psychological profile.
3. **Generate a Reply** using the analysis context to match or adjust styles.
## Authentication
All non-demo API endpoints require authentication via an API key. Pass it in your headers:
- `X-API-Key: YOUR_KEY`
- `Authorization: Bearer YOUR_KEY`
## Code Examples
**1. Analyze Text (Python / cURL)**
```bash
curl -X ''POST'' \
''https://intencheck.com/api/v1/analyze'' \
-H ''accept: application/json'' \
-H ''Authorization: Bearer YOUR_API_KEY'' \
-H ''Content-Type: application/json'' \
-d ''{
"text": "I am so frustrated that you never listen to my feedback!",
"features": ["emotions", "communication_style"],
"output_lang": "en"
}''
```
**2. Generate a Reply**
```bash
curl -X ''POST'' \
''https://intencheck.com/api/v1/reply'' \
-H ''accept: application/json'' \
-H ''Authorization: Bearer YOUR_API_KEY'' \
-H ''Content-Type: application/json'' \
-d ''{
"original_text": "I am so frustrated that you never listen to my feedback!",
"analysis_data": { ... result from /analyze ... },
"strategy": "de_escalate",
"mode": "constructive"
}''
```
## Common Error Codes
| Status | Description |
|--------|-------------|
| `400` | Bad Request: Invalid parameters or JSON schema. |
| `401` | Unauthorized: Missing or invalid API Key. |
| `402` | Payment Required: Insufficient prepaid balance. |
| `429` | Too Many Requests: Rate limit exceeded. |
| `500` | Internal Server Error / Upstream AI failure. |'
contact:
name: IntenCheck Developer Support
url: https://intencheck.com/
version: 1.1.0
tags:
- name: API Keys
description: API Key Management for your integrations
paths:
/api/v1/keys/usage:
get:
tags:
- API Keys
summary: Get User Usage Stats
description: Get aggregated usage stats for all API keys of the current user.
operationId: get_user_usage_stats_api_v1_keys_usage_get
security:
- OAuth2PasswordBearer: []
parameters:
- name: access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Access Token
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/UsageSummary'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/keys:
get:
tags:
- API Keys
summary: List Api Keys
description: List all API keys for the current user.
operationId: list_api_keys_api_v1_keys_get
security:
- OAuth2PasswordBearer: []
parameters:
- name: access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Access Token
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ApiKeyOut'
title: Response List Api Keys Api V1 Keys Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
post:
tags:
- API Keys
summary: Create Api Key
description: Create a new API key. The raw key is returned ONCE.
operationId: create_api_key_api_v1_keys_post
security:
- OAuth2PasswordBearer: []
parameters:
- name: access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Access Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ApiKeyCreate'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ApiKeyCreatedResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/keys/{key_id}:
delete:
tags:
- API Keys
summary: Revoke Api Key
description: Revoke (deactivate) an API key.
operationId: revoke_api_key_api_v1_keys__key_id__delete
security:
- OAuth2PasswordBearer: []
parameters:
- name: key_id
in: path
required: true
schema:
type: integer
title: Key Id
- name: access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Access Token
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/keys/{key_id}/rotate:
post:
tags:
- API Keys
summary: Rotate Api Key
description: 'Rotate an API key: revoke the old one and generate a new one with the same name.'
operationId: rotate_api_key_api_v1_keys__key_id__rotate_post
security:
- OAuth2PasswordBearer: []
parameters:
- name: key_id
in: path
required: true
schema:
type: integer
title: Key Id
- name: access_token
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Access Token
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ApiKeyRotateResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ApiKeyOut:
properties:
id:
type: integer
title: Id
name:
type: string
title: Name
key_prefix:
type: string
title: Key Prefix
project_key:
anyOf:
- type: string
- type: 'null'
title: Project Key
scopes_json:
anyOf:
- type: string
- type: 'null'
title: Scopes Json
is_active:
type: boolean
title: Is Active
rate_limit:
type: integer
title: Rate Limit
monthly_quota:
anyOf:
- type: integer
- type: 'null'
title: Monthly Quota
created_at:
type: string
format: date-time
title: Created At
last_used_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Last Used At
type: object
required:
- id
- name
- key_prefix
- is_active
- rate_limit
- created_at
title: ApiKeyOut
UsageSummary:
properties:
total_requests:
type: integer
title: Total Requests
total_tokens:
type: integer
title: Total Tokens
total_cost:
type: number
title: Total Cost
type: object
required:
- total_requests
- total_tokens
- total_cost
title: UsageSummary
ApiKeyRotateResponse:
properties:
new_api_key:
$ref: '#/components/schemas/ApiKeyOut'
raw_key:
type: string
title: Raw Key
type: object
required:
- new_api_key
- raw_key
title: ApiKeyRotateResponse
description: Returned when a key is rotated.
ApiKeyCreate:
properties:
name:
type: string
title: Name
default: Default Key
project_key:
anyOf:
- type: string
- type: 'null'
title: Project Key
scopes:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Scopes
type: object
title: ApiKeyCreate
ApiKeyCreatedResponse:
properties:
api_key:
$ref: '#/components/schemas/ApiKeyOut'
raw_key:
type: string
title: Raw Key
type: object
required:
- api_key
- raw_key
title: ApiKeyCreatedResponse
description: Returned once when a key is created — contains the raw key.
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
securitySchemes:
OAuth2PasswordBearer:
type: oauth2
flows:
password:
scopes: {}
tokenUrl: /api/v1/auth/login