{ "openapi": "3.1.0", "info": { "title": "Ravanan Kudil public read API", "version": "1.0.0", "description": "Keyless retrieval of the journal’s permitted public projection. No writes, credentials or private sources." }, "servers": [ { "url": "https://home.ashwingopalsamy.in" } ], "security": [], "paths": { "/api/v1/site": { "get": { "operationId": "getSite", "summary": "Retrieve journal identity, supported read capabilities and discovery links", "description": "Retrieve journal identity, supported read capabilities and discovery links.", "security": [], "parameters": [], "responses": { "200": { "description": "Public read succeeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Site" }, "example": { "name": "Ravanan Kudil", "origin": "https://home.ashwingopalsamy.in", "description": "A personal home construction journal with recorded costs and day-wise work in Tamil Nadu.", "api_version": "1.0.0", "published_at": "2026-10-04", "authentication": "none; public read only", "pricing": "Free informational access; no checkout", "capabilities": [ "search public normalized records", "read exact INR costs", "read recorded work and attendance uncertainty" ], "links": { "developers": "https://home.ashwingopalsamy.in/developers/", "guide": "https://home.ashwingopalsamy.in/agents.md", "markdown": "https://home.ashwingopalsamy.in/index.md", "openapi": "https://home.ashwingopalsamy.in/openapi.json", "catalog": "https://home.ashwingopalsamy.in/.well-known/api-catalog", "mcp": "https://home.ashwingopalsamy.in/mcp", "auth": "https://home.ashwingopalsamy.in/auth.md" } } } } }, "400": { "description": "Documented HTTP 400 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 400, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "404": { "description": "Documented HTTP 404 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 404, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "405": { "description": "Documented HTTP 405 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 405, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "409": { "description": "Documented HTTP 409 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 409, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "429": { "description": "Documented HTTP 429 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 429, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "rate_limited", "request_id": "example-request" } } } }, "500": { "description": "Documented HTTP 500 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 500, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "503": { "description": "Documented HTTP 503 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 503, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } } } } }, "/api/v1/content": { "get": { "operationId": "listContent", "summary": "List public content in stable ascending ID order using snapshot-bound cursors", "description": "List public content in stable ascending ID order using snapshot-bound cursors.", "security": [], "parameters": [ { "name": "kind", "in": "query", "required": false, "description": "Optional kind filter.", "schema": { "type": "string", "enum": [ "page", "summary", "cost", "work" ] } }, { "name": "limit", "in": "query", "required": false, "description": "Page size; default 20, maximum 100.", "schema": { "default": 20, "description": "Page size; default 20, maximum 100.", "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "description": "Opaque next_cursor from the preceding page; expires after one hour.", "schema": { "description": "Opaque next_cursor from the preceding page; expires after one hour.", "type": "string", "maxLength": 2048 } } ], "responses": { "200": { "description": "Public read succeeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContentPage" }, "example": { "items": [], "next_cursor": null, "snapshot": "example", "limit": 20 } } } }, "400": { "description": "Documented HTTP 400 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 400, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "404": { "description": "Documented HTTP 404 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 404, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "405": { "description": "Documented HTTP 405 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 405, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "409": { "description": "Documented HTTP 409 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 409, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "429": { "description": "Documented HTTP 429 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 429, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "rate_limited", "request_id": "example-request" } } } }, "500": { "description": "Documented HTTP 500 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 500, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "503": { "description": "Documented HTTP 503 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 503, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } } } } }, "/api/v1/content/{id}": { "get": { "operationId": "getContent", "summary": "Retrieve one public journal record with exact values, provenance and freshness", "description": "Retrieve one public journal record with exact values, provenance and freshness.", "security": [], "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Stable public record ID.", "schema": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{0,119}$" }, "example": "journal-summary" } ], "responses": { "200": { "description": "Public read succeeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Content" }, "example": { "id": "journal-summary", "kind": "summary", "title": "Ravanan Kudil construction journal", "description": "Recorded costs: 3132535.00 INR. 80 recorded worked days; at least 356 worker-days. Unknown attendance remains unknown. Costs include construction, paperwork, financing and site improvement; they are not a completion budget.", "canonical": "https://home.ashwingopalsamy.in/", "last_updated": "2026-10-04", "revision": "471cec0b93d1c63e227c67f68e53b5bd1ec4a2186d9416aed1b6d80848dba360", "language": "en", "visibility": "public", "source": [ { "label": "Owner construction history report · September 2026", "url": "https://home.ashwingopalsamy.in/about/#how-to-read-the-record", "recorded_at": "2026-09", "precision": "month" }, { "label": "Owner progress and spend report · 28 September 2026", "url": "https://home.ashwingopalsamy.in/about/#how-to-read-the-record", "recorded_at": "2026-09-28", "precision": "day" }, { "label": "Owner-confirmed March–September account · 3 October 2026", "url": "https://home.ashwingopalsamy.in/about/#how-to-read-the-record", "recorded_at": "2026-10-03", "precision": "day" }, { "label": "Owner-reported omitted costs and scope clarifications · 3 October 2026", "url": "https://home.ashwingopalsamy.in/about/#how-to-read-the-record", "recorded_at": "2026-10-03", "precision": "day" }, { "label": "Owner clarification of curing-water motor and electricity cycles · 3 October 2026", "url": "https://home.ashwingopalsamy.in/about/#how-to-read-the-record", "recorded_at": "2026-10-03", "precision": "day" }, { "label": "Owner-supplied construction terminology and borewell dimensions · 3 October 2026", "url": "https://home.ashwingopalsamy.in/about/#how-to-read-the-record", "recorded_at": "2026-10-03", "precision": "day" }, { "label": "Owner clarification of cost months and site status · recorded 4 October 2026", "url": "https://home.ashwingopalsamy.in/about/#how-to-read-the-record", "recorded_at": "2026-10-04", "precision": "day" } ], "review": null, "text": "Recorded costs: 3132535.00 INR. 80 recorded worked days; at least 356 worker-days. Unknown attendance remains unknown. Costs include construction, paperwork, financing and site improvement; they are not a completion budget.", "summary": { "total": { "currency": "INR", "minor_unit": "paise", "amount_minor": 313253500, "decimal": "3132535.00" }, "monthly": [ { "month": "2026-03", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 65667500, "decimal": "656675.00" } }, { "month": "2026-04", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 13100000, "decimal": "131000.00" } }, { "month": "2026-05", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 32220000, "decimal": "322200.00" } }, { "month": "2026-06", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 34136000, "decimal": "341360.00" } }, { "month": "2026-07", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 48260000, "decimal": "482600.00" } }, { "month": "2026-08", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 43740000, "decimal": "437400.00" } }, { "month": "2026-09", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 74130000, "decimal": "741300.00" } } ], "categories": [ { "id": "civil-labour", "label": "Civil labour", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 88720000, "decimal": "887200.00" } }, { "id": "reinforcement-steel", "label": "Reinforcement steel", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 80470000, "decimal": "804700.00" } }, { "id": "red-brick", "label": "Red bricks", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 27830000, "decimal": "278300.00" } }, { "id": "earthmoving-aggregates-unspecified", "label": "Earthmoving / aggregates, unspecified", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 20700000, "decimal": "207000.00" } }, { "id": "cement", "label": "Cement", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 16960000, "decimal": "169600.00" } }, { "id": "earthmoving", "label": "Earthmoving", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 11590000, "decimal": "115900.00" } }, { "id": "rcc-placement-labour", "label": "Concrete placement labour", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 10120000, "decimal": "101200.00" } }, { "id": "aggregates", "label": "Sand & aggregates", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 8224000, "decimal": "82240.00" } }, { "id": "shed-warehouse", "label": "Shed / warehouse", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 8000000, "decimal": "80000.00" } }, { "id": "borewell", "label": "Borewell work", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 7690000, "decimal": "76900.00" } }, { "id": "commercial-electricity", "label": "Commercial electricity", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 6563500, "decimal": "65635.00" } }, { "id": "loan-charges", "label": "Loan charges", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 4500000, "decimal": "45000.00" } }, { "id": "architect-fees", "label": "Architect fees", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 4175000, "decimal": "41750.00" } }, { "id": "tree-cutting", "label": "Teak tree cutting", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 3000000, "decimal": "30000.00" } }, { "id": "elevation-ring", "label": "Elevation ring", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 2100000, "decimal": "21000.00" } }, { "id": "security-network", "label": "CCTV & Wi-Fi setup", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 2000000, "decimal": "20000.00" } }, { "id": "labour-food", "label": "Labour food & snacks", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 2000000, "decimal": "20000.00" } }, { "id": "cement-blocks", "label": "Cement blocks", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 1500000, "decimal": "15000.00" } }, { "id": "curing-water-motor", "label": "Curing-water motor & cable", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 1500000, "decimal": "15000.00" } }, { "id": "electrical-setup", "label": "Electrical setup", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 1500000, "decimal": "15000.00" } }, { "id": "waterproofing", "label": "Waterproofing", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 1301000, "decimal": "13010.00" } }, { "id": "carpentry-labour", "label": "Carpentry labour", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 1000000, "decimal": "10000.00" } }, { "id": "water-supply", "label": "Tank water supply", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 980000, "decimal": "9800.00" } }, { "id": "minor-concrete-supplies", "label": "Small concrete & shuttering supplies", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 650000, "decimal": "6500.00" } }, { "id": "painting-labour", "label": "Painting labour", "amount": { "currency": "INR", "minor_unit": "paise", "amount_minor": 180000, "decimal": "1800.00" } } ], "work_entries": 80, "worker_days_minimum": 356, "worker_days_is_lower_bound": true, "stage": { "datum": "basement_floor", "lintel_ft_approx": 8, "walls_ft_approx": 11, "roof_cast": false, "basement_ft_stated": 7, "slab_in_stated": 6, "roof_work": "Roof centering, TMT rod placement", "roof_work_as_of": "2026-10-03" } } } } } }, "400": { "description": "Documented HTTP 400 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 400, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "404": { "description": "Documented HTTP 404 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 404, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "405": { "description": "Documented HTTP 405 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 405, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "409": { "description": "Documented HTTP 409 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 409, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "429": { "description": "Documented HTTP 429 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 429, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "rate_limited", "request_id": "example-request" } } } }, "500": { "description": "Documented HTTP 500 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 500, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "503": { "description": "Documented HTTP 503 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 503, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } } } } }, "/api/v1/search": { "get": { "operationId": "searchContent", "summary": "Search literal words in public titles and normalized descriptions; returns no private matches or generated answers", "description": "Search literal words in public titles and normalized descriptions; returns no private matches or generated answers.", "security": [], "parameters": [ { "name": "kind", "in": "query", "required": false, "description": "Optional kind filter.", "schema": { "type": "string", "enum": [ "page", "summary", "cost", "work" ] } }, { "name": "limit", "in": "query", "required": false, "description": "Page size; default 20, maximum 100.", "schema": { "default": 20, "description": "Page size; default 20, maximum 100.", "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "description": "Opaque next_cursor from the preceding page; expires after one hour.", "schema": { "description": "Opaque next_cursor from the preceding page; expires after one hour.", "type": "string", "maxLength": 2048 } }, { "name": "q", "in": "query", "required": true, "description": "Literal words in public titles and normalized descriptions; no regex or generated answers.", "schema": { "type": "string", "minLength": 1, "maxLength": 160, "description": "Literal words in public titles and normalized descriptions; no regex or generated answers." } } ], "responses": { "200": { "description": "Public read succeeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContentPage" }, "example": { "items": [], "next_cursor": null, "snapshot": "example", "limit": 20 } } } }, "400": { "description": "Documented HTTP 400 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 400, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "404": { "description": "Documented HTTP 404 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 404, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "405": { "description": "Documented HTTP 405 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 405, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "409": { "description": "Documented HTTP 409 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 409, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "429": { "description": "Documented HTTP 429 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 429, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "rate_limited", "request_id": "example-request" } } } }, "500": { "description": "Documented HTTP 500 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 500, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } }, "503": { "description": "Documented HTTP 503 problem; follow code and detail.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" }, "example": { "type": "https://home.ashwingopalsamy.in/developers/#errors-and-caching", "title": "Request could not be completed", "status": 503, "detail": "Read the safe resolution hint.", "instance": "/api/v1/content", "code": "invalid_input", "request_id": "example-request" } } } } } } } }, "components": { "schemas": { "Content": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{0,119}$", "description": "Stable published content ID; never a path or URL." }, "kind": { "type": "string", "enum": [ "page", "summary", "cost", "work" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "canonical": { "type": "string", "format": "uri" }, "last_updated": { "type": "string" }, "revision": { "type": "string" }, "language": { "type": "string", "const": "en" }, "visibility": { "type": "string", "const": "public" }, "source": { "type": "array", "items": { "type": "object", "properties": { "label": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "recorded_at": { "type": "string" }, "precision": { "type": "string", "enum": [ "day", "month" ] } }, "required": [ "label", "url", "recorded_at", "precision" ], "additionalProperties": false } }, "review": { "anyOf": [ { "type": "string", "enum": [ "owner_reviewed", "source_checked" ] }, { "type": "null" } ] }, "text": { "type": "string" }, "cost": { "type": "object", "properties": { "amount": { "type": "object", "properties": { "currency": { "type": "string", "const": "INR" }, "minor_unit": { "type": "string", "const": "paise" }, "amount_minor": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "decimal": { "type": "string" } }, "required": [ "currency", "minor_unit", "amount_minor", "decimal" ], "additionalProperties": false }, "category": { "type": "string" }, "scope": { "type": "string" }, "kind": { "type": "string" }, "counted": { "type": "boolean" }, "precision": { "type": "string", "enum": [ "day", "month", "billing_cycle", "undated", "cumulative" ] }, "from": { "type": [ "string", "null" ] }, "to": { "type": [ "string", "null" ] }, "coverage": { "type": "string" } }, "required": [ "amount", "category", "scope", "kind", "counted", "precision", "from", "to", "coverage" ], "additionalProperties": false }, "work": { "type": "object", "properties": { "date": { "type": "string" }, "date_semantics": { "type": "string", "const": "Local calendar day in Asia/Kolkata, not an instant" }, "state": { "type": "string", "enum": [ "worked", "no_work" ] }, "crew": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "crew_precision": { "type": "string", "enum": [ "exact", "minimum", "unknown" ] }, "activities": { "type": "array", "items": { "type": "string" } } }, "required": [ "date", "date_semantics", "state", "crew", "crew_precision", "activities" ], "additionalProperties": false }, "summary": { "type": "object", "properties": { "total": { "type": "object", "properties": { "currency": { "type": "string", "const": "INR" }, "minor_unit": { "type": "string", "const": "paise" }, "amount_minor": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "decimal": { "type": "string" } }, "required": [ "currency", "minor_unit", "amount_minor", "decimal" ], "additionalProperties": false }, "monthly": { "type": "array", "items": { "type": "object", "properties": { "month": { "type": "string" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "const": "INR" }, "minor_unit": { "type": "string", "const": "paise" }, "amount_minor": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "decimal": { "type": "string" } }, "required": [ "currency", "minor_unit", "amount_minor", "decimal" ], "additionalProperties": false } }, "required": [ "month", "amount" ], "additionalProperties": false } }, "categories": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "amount": { "type": "object", "properties": { "currency": { "type": "string", "const": "INR" }, "minor_unit": { "type": "string", "const": "paise" }, "amount_minor": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "decimal": { "type": "string" } }, "required": [ "currency", "minor_unit", "amount_minor", "decimal" ], "additionalProperties": false } }, "required": [ "id", "label", "amount" ], "additionalProperties": false } }, "work_entries": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "worker_days_minimum": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "worker_days_is_lower_bound": { "type": "boolean" }, "stage": { "type": "object", "properties": { "datum": { "type": "string", "const": "basement_floor" }, "lintel_ft_approx": { "type": "number" }, "walls_ft_approx": { "type": "number" }, "roof_cast": { "type": "boolean" }, "basement_ft_stated": { "type": [ "number", "null" ] }, "slab_in_stated": { "type": [ "number", "null" ] }, "roof_work": { "type": [ "string", "null" ] }, "roof_work_as_of": { "type": [ "string", "null" ] } }, "required": [ "datum", "lintel_ft_approx", "walls_ft_approx", "roof_cast", "basement_ft_stated", "slab_in_stated", "roof_work", "roof_work_as_of" ], "additionalProperties": false } }, "required": [ "total", "monthly", "categories", "work_entries", "worker_days_minimum", "worker_days_is_lower_bound", "stage" ], "additionalProperties": false } }, "required": [ "id", "kind", "title", "description", "canonical", "last_updated", "revision", "language", "visibility", "source", "review", "text" ], "additionalProperties": false }, "ContentPage": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]{0,119}$", "description": "Stable published content ID; never a path or URL." }, "kind": { "type": "string", "enum": [ "page", "summary", "cost", "work" ] }, "title": { "type": "string" }, "description": { "type": "string" }, "canonical": { "type": "string", "format": "uri" }, "last_updated": { "type": "string" }, "revision": { "type": "string" } }, "required": [ "id", "kind", "title", "description", "canonical", "last_updated", "revision" ], "additionalProperties": false } }, "next_cursor": { "type": [ "string", "null" ] }, "snapshot": { "type": "string" }, "limit": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "items", "next_cursor", "snapshot", "limit" ], "additionalProperties": false }, "Site": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "name": { "type": "string", "const": "Ravanan Kudil" }, "origin": { "type": "string", "format": "uri" }, "description": { "type": "string" }, "api_version": { "type": "string" }, "published_at": { "type": "string" }, "authentication": { "type": "string", "const": "none; public read only" }, "pricing": { "type": "string", "const": "Free informational access; no checkout" }, "capabilities": { "type": "array", "items": { "type": "string" } }, "links": { "type": "object", "properties": { "developers": { "type": "string", "format": "uri" }, "guide": { "type": "string", "format": "uri" }, "markdown": { "type": "string", "format": "uri" }, "openapi": { "type": "string", "format": "uri" }, "catalog": { "type": "string", "format": "uri" }, "mcp": { "type": "string", "format": "uri" }, "auth": { "type": "string", "format": "uri" } }, "required": [ "developers", "guide", "markdown", "openapi", "catalog", "mcp", "auth" ], "additionalProperties": false } }, "required": [ "name", "origin", "description", "api_version", "published_at", "authentication", "pricing", "capabilities", "links" ], "additionalProperties": false }, "Problem": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "type": { "type": "string", "format": "uri" }, "title": { "type": "string" }, "status": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "detail": { "type": "string" }, "instance": { "type": "string" }, "code": { "type": "string" }, "request_id": { "type": "string" } }, "required": [ "type", "title", "status", "detail", "instance", "code", "request_id" ], "additionalProperties": false } } } }