POST
Inspect nicola_askAPIs
URSY ORG evidence specialist
Contract
- Version
- 1.0.0
- Base URL
https://ursy.org/wp-json/nicola/v2- Published source
- OpenAPI ↗
Endpoints are extracted from this version. Original snapshots are retained when a source changes.
Authentication
Requirements are recorded per operation. An API can contain both public and protected endpoints.
Read the authentication guide →Endpoints
GET
nicola_capabilities
/capabilitiesRead a bounded page of current source capabilities. Cursors bind the exact capability generation; restart without a cursor after a generation conflict.
GET
Inspect nicola_manifestGET
Inspect nicola_statusInspect the accepted OpenAPI document
{
"openapi": "3.1.0",
"info": {
"title": "URSY ORG evidence specialist",
"version": "1.0.0"
},
"servers": [
{
"url": "https://ursy.org/wp-json/nicola/v2"
}
],
"paths": {
"/ask": {
"post": {
"operationId": "nicola_ask",
"description": "Ask this public-service specialist a bounded natural-language question.",
"responses": {
"200": {
"description": "Source-owned structured public result",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"status",
"answer",
"items"
],
"properties": {
"request_id": {
"type": "string"
},
"status": {
"enum": [
"answered",
"needs_clarification",
"out_of_scope",
"unavailable",
"pending",
"partial",
"no_results"
]
},
"intent": {
"type": "string"
},
"answer": {
"type": "string",
"maxLength": 12000
},
"items": {
"type": "array",
"maxItems": 100,
"items": {
"type": "object"
}
},
"sources": {
"type": "array",
"items": {
"type": "object"
}
},
"freshness": {
"type": "object"
},
"clarification": {
"type": [
"string",
"null"
]
},
"next_actions": {
"type": "array",
"items": {
"type": "object"
}
},
"conversation_ref": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
}
}
},
"default": {
"description": "Bounded source error",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"error",
"request_id"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "object"
}
}
},
"request_id": {
"type": "string"
}
}
}
}
}
}
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"question": {
"type": "string",
"minLength": 1,
"maxLength": 4000
},
"constraints": {
"type": "object"
},
"conversation_ref": {
"type": [
"string",
"null"
]
},
"max_results": {
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"question"
],
"additionalProperties": false
}
}
}
}
}
},
"/manifest": {
"get": {
"operationId": "nicola_manifest",
"description": "Read the approved source manifest.",
"responses": {
"200": {
"description": "Source-owned structured public result",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"site_id",
"name"
],
"properties": {
"site_id": {
"type": "string"
},
"name": {
"type": "string"
},
"origin": {
"type": "string",
"format": "uri"
},
"approved_description": {
"type": "string"
},
"observed_at": {
"type": "string"
},
"valid_until": {
"type": "string"
}
},
"additionalProperties": true
}
}
}
},
"default": {
"description": "Bounded source error",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"error",
"request_id"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "object"
}
}
},
"request_id": {
"type": "string"
}
}
}
}
}
}
}
}
},
"/capabilities": {
"get": {
"operationId": "nicola_capabilities",
"description": "Read a bounded page of current source capabilities. Cursors bind the exact capability generation; restart without a cursor after a generation conflict.",
"responses": {
"200": {
"description": "Source-owned structured public result",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"items",
"next_cursor",
"source_revision"
],
"properties": {
"items": {
"type": "array",
"maxItems": 100,
"items": {
"type": "object"
}
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"source_revision": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
}
}
},
"default": {
"description": "Bounded source error",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"error",
"request_id"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "object"
}
}
},
"request_id": {
"type": "string"
}
}
}
}
}
}
},
"parameters": [
{
"name": "cursor",
"in": "query",
"required": false,
"schema": {
"type": "string",
"pattern": "^(0|v1\\.[a-f0-9]{24}\\.[0-9]{1,4})$"
}
},
{
"name": "limit",
"in": "query",
"required": false,
"schema": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
}
]
}
},
"/status": {
"get": {
"operationId": "nicola_status",
"description": "Read source sync and local availability separately.",
"responses": {
"200": {
"description": "Source-owned structured public result",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"site_id",
"network_state",
"local_assistance"
],
"properties": {
"site_id": {
"type": "string"
},
"network_state": {
"type": "string"
},
"local_assistance": {
"type": "string"
},
"snapshot_projected_at": {
"type": [
"string",
"null"
]
},
"last_worker_at": {
"type": [
"string",
"null"
]
},
"last_projected_at": {
"type": [
"string",
"null"
]
},
"source_observed_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": true
}
}
}
},
"default": {
"description": "Bounded source error",
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"error",
"request_id"
],
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message",
"retryable"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"retryable": {
"type": "boolean"
},
"details": {
"type": "object"
}
}
},
"request_id": {
"type": "string"
}
}
}
}
}
}
}
}
}
},
"components": {
"schemas": [],
"securitySchemes": []
}
}