Appearance
API
The REST API is https://app.intangia.co/api/v1. Send a bearer token issued for that resource. See Authentication.
The machine-readable contract is openapi.yaml.
| Method | Path | Scope |
|---|---|---|
GET | /api/v1/keywords | intangia:read |
GET | /api/v1/keywords/{keywordId} | intangia:read |
GET | /api/v1/keywords/{keywordId}/relations | intangia:read |
GET | /api/v1/projects | intangia:read |
POST | /api/v1/projects | projects:write |
GET | /api/v1/projects/{projectId}/status | intangia:read |
GET | /api/v1/projects/{projectId}/signals | intangia:read |
GET | /api/v1/projects/{projectId}/opportunities | intangia:read |
POST | /api/v1/projects/{projectId}/analyses | analyses:run |
Reports, project setup, project search, and a single assessment are MCP tools. They are not routes on this API.
Names used below are defined in Concepts.
Errors
Missing or invalid tokens, and tokens issued for the MCP resource, return:
json
{ "error": "unauthorized" }Status 401. The WWW-Authenticate header points at the protected-resource metadata for api/v1.
A token that is valid but missing the route's scope returns 403:
json
{ "error": "insufficient_scope", "scope": "intangia:read" }A caller who is not a member of the project returns 403 with No permission to view this project or No permission to modify this project.
Validation failures return 400 and { "error": "..." }. An unexpected failure returns 500 and { "error": "Internal error" }.