sudhanva-me Discovery API

openapi: 3.2.0
info:
  title: sudhanva.me Public Discovery API
  version: 1.2.0
  summary: Read Sudhanva Narayana's public profile and writing metadata, send batch reads, and create profile-insight jobs.
  description: A public API with no authentication for agents, search tools, feed readers, and small integrations. Retrieval and batch operations return only information that is already published on sudhanva.me. The profile-insights operation runs asynchronously and uses the same public data to make temporary, deterministic guidance. It does not accept free-form text, secrets, or private data. The URL carries the stable API version. A breaking change uses a new major path. The API announces the retirement of a version at least 90 days in advance, and it sends Deprecation and Sunset response headers.
  x-api-status: stable
  x-read-only: false
  x-authentication: none
  x-idempotency-policy: POST /profile-insights requires Idempotency-Key. A key is retained for the 24-hour lifetime of its job; replaying the same request returns the same job, while reusing the key with a different request returns 422.
  x-async-jobs: true
  x-versioning-strategy: URL major version
  x-deprecation-policy: https://sudhanva.me/developers/versioning/
  contact:
    name: Sudhanva Narayana
    url: https://sudhanva.me/contact/
    email: nsudhanva@gmail.com
  license:
    name: MIT
    identifier: MIT
servers:
- url: https://sudhanva.me/api/v1
  description: Production API, version 1
- url: https://sudhanva.me/api/sandbox/v1
  description: Sandbox. A free, stateless test environment with the same contract. It needs no credentials and stores no profile-insight jobs. It has no batch endpoint.
security: []
tags:
- name: Discovery
  description: Find the API contract and the available resources.
paths:
  /:
    get:
      operationId: getApiIndex
      summary: Get API discovery information
      description: Returns the API name, version, documentation links, OpenAPI URL, and main endpoint URLs.
      tags:
      - Discovery
      parameters:
      - name: locale
        in: query
        required: false
        description: Response locale. At this time, English is the only published locale.
        schema:
          type: string
          enum:
          - en
          default: en
      responses:
        '200':
          description: API discovery information.
          headers:
            Link:
              $ref: '#/components/headers/DeprecationPolicyLink'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiIndex'
        '405':
          $ref: '#/components/responses/MethodNotAllowed'
        '500':
          description: An unexpected server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        default:
          $ref: '#/components/responses/UnexpectedError'
components:
  headers:
    DeprecationPolicyLink:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
  schemas:
    ApiIndex:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    ErrorEnvelope:
      type: object
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
  responses:
    UnexpectedError:
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    MethodNotAllowed:
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
externalDocs:
  description: Sudhanva API developer documentation
  url: https://sudhanva.me/docs/