# info.description
Official public REST API, developer resources, and agent tools for Dr. Amit Puri (amitpuri). Provides structured programmatic endpoints for executive bio, advisory services, publications, health checks, and deprecation policies. Official developer resources for amitpuri include OpenAPI 3.1.0 specifications, authentication guides, webhooks, Model Context Protocol (MCP) server, CLI tools, and LLM context files.

# info.x-versioning-strategy
URL path versioning (/v1/, /v2/) and API-Version header parameter. The current stable release is v1, available under /api/v1/* and aliased at /api/*.

# info.x-deprecation-policy
Deprecated endpoints will carry a Sunset header (RFC 8594) indicating the removal date and a Deprecation header (RFC 9745) with a deprecation timestamp. Deprecation policy page is published at https://www.amitpuri.com/deprecation with a minimum 90-day transition notice.

# info.x-rate-limit-policy
60 requests per minute per IP. Requests exceeding the limit receive a 429 Too Many Requests response with a Retry-After header. Headers RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and RateLimit-Policy are returned on all API responses.

# servers[].description
Versioned Production Server (v1 — current stable)

# servers[].description
Production Server (latest stable v1 aliased)

# components.parameters.ApiVersionHeader.description
API version string (e.g. 'v1'). Defaults to latest stable version (v1).

# components.parameters.FormatQuery.description
Desired response representation format. Defaults to 'json'.

# components.schemas.Problem.description
RFC 9457 application/problem+json error model. Returned on all 4xx and 5xx responses.

# components.schemas.Problem.properties.type.description
A URI reference that identifies the problem type.

# components.schemas.Problem.properties.title.description
A short, human-readable summary of the problem type.

# components.schemas.Problem.properties.detail.description
A human-readable explanation specific to this occurrence of the problem.

# components.schemas.Problem.properties.instance.description
A URI reference that identifies the specific occurrence of the problem.

# components.schemas.Problem.properties.code.description
A unique, machine-readable error code for programmatic handling.

# components.schemas.Problem.properties.invalid_params.description
If applicable, a list of invalid parameters causing the error.

# components.schemas.SocialLinks.description
Verified social profiles for Dr. Amit Puri

# components.schemas.Profile.description
Executive profile and professional bio for Dr. Amit Puri

# components.schemas.Profile.properties.title.example
Enterprise Cloud & AI Architect, Author, Advisor

# components.schemas.Profile.properties.title.description
Professional title and primary advisory roles

# components.schemas.Profile.properties.bio.description
Executive biography summarizing 25+ years experience in enterprise architecture and AI transformation

# components.schemas.Profile.properties.bio.example
Executive Cloud & AI Architect, Author, and Advisor helping organizations modernize enterprise architectures with AI.

# components.schemas.Profile.properties.expertise.description
List of core subject matter expertise and advisory domains

# components.schemas.Profile.properties.experience_years.description
Total cumulative years of professional technology experience

# components.schemas.ServiceItem.description
Individual advisory or mentorship offering

# components.schemas.ServiceItem.properties.type.description
Engagement type (e.g. Advisory, Mentorship, Strategy)

# components.schemas.ServiceItem.properties.description.description
Summary of what is covered in the session

# components.schemas.ServiceItem.properties.description.example
Expert consultation on enterprise AI strategy and multi-agent implementation.

# components.schemas.ServiceItem.properties.booking_url.description
Direct Topmate URL to book this specific session

# components.schemas.ServicesResponse.description
Catalog of advisory services and booking URLs for Dr. Amit Puri

# components.schemas.ServicesResponse.properties.services.description
List of available consultation offerings

# components.schemas.ProjectItem.properties.tagline.example
Democratizing Artificial General Intelligence and Agentic Architectures

# components.schemas.ProjectsResponse.description
Portfolio of key initiatives, research publications, and open platforms

# components.schemas.ProjectsResponse.properties.initiatives.description
List of published initiatives and knowledge bases

# components.schemas.HealthResponse.description
API health check, active versioning, and documentation index

# components.schemas.DeprecationPolicy.description
Detailed deprecation signaling standards and timeline guarantees

# components.schemas.DeprecationPolicy.properties.minimum_notice_days.description
Minimum advance notice period in days before removing a deprecated endpoint

# components.schemas.DeprecationPolicy.properties.sunset_header.description
Header communicating endpoint retirement date

# components.schemas.DeprecationPolicy.properties.link_header.description
Link header pointing to successor documentation

# components.schemas.DeprecationResponse.description
API Versioning and Deprecation Policy response payload

# components.schemas.DeprecationResponse.properties.versioning_strategy.example
URL path versioning (/v1/, /v2/) and API-Version header parameter.

# components.headers.RateLimit-Limit.description
Maximum number of requests allowed per 60-second window.

# components.headers.RateLimit-Remaining.description
Number of requests remaining in the current window.

# components.headers.RateLimit-Reset.description
Seconds or timestamp until the rate-limit window resets.

# components.headers.Retry-After.description
Number of seconds to wait before retrying a rate-limited request.

# components.headers.Sunset.description
RFC 8594 Sunset date when a deprecated endpoint will be removed.

# components.headers.Deprecation.description
RFC 9745 Deprecation date when an endpoint was marked deprecated.

# components.responses.BadRequest.description
Bad Request (RFC 9457). The request parameters were malformed or invalid.

# components.responses.Unauthorized.description
Unauthorized (RFC 9457). Valid Bearer Token required for private or webhook endpoints.

# components.responses.Unauthorized.content.application/problem+json.example.detail
Authentication required. Provide a valid Bearer Token.

# components.responses.Forbidden.description
Forbidden (RFC 9457). The authenticated user or agent does not have access to this resource.

# components.responses.Forbidden.content.application/problem+json.example.detail
Access to the requested resource is denied.

# components.responses.NotFound.content.application/problem+json.example.detail
The requested API endpoint does not exist on amitpuri.com.

# components.responses.TooManyRequests.description
Rate Limit Exceeded (RFC 9457). Self-throttle using Retry-After header.

# components.responses.TooManyRequests.content.application/problem+json.example.detail
Rate limit of 60 requests per minute exceeded. Please self-throttle.

# components.responses.InternalServerError.content.application/problem+json.example.detail
An unexpected error occurred. Please contact info@amitpuri.com.

# components.responses.DefaultError.description
Default unexpected error response (RFC 9457).

# paths./api/profile.json.get.description
Retrieves verified professional biography, titles, social media channels, expertise domains, and booking coordinates for Dr. Amit Puri (amitpuri). Suitable for agent tool calls and entity resolution.

# paths./api/profile.json.get.parameters[].description
Optional comma-separated list of profile fields to retrieve (e.g. 'name,title,bio,expertise,booking_url').

# paths./api/v1/profile.json.get.description
Versioned endpoint returning executive bio, contact endpoints, and expertise for Dr. Amit Puri (amitpuri).

# paths./api/v1/profile.json.get.parameters[].description
Optional comma-separated list of profile fields to retrieve.

# paths./api/services.json.get.description
Returns full catalog of advisory sessions, 1:1 mentorship bookings, workshops, and direct Topmate booking URLs for Dr. Amit Puri (amitpuri).

# paths./api/services.json.get.parameters[].description
Filter services by category type (e.g. 'all', 'advisory', 'mentorship', 'cloud', 'ai').

# paths./api/v1/services.json.get.description
Versioned endpoint returning advisory catalog and booking URLs for Dr. Amit Puri.

# paths./api/projects.json.get.description
Returns open initiatives, research knowledge bases (Open AGI, Citizen Developer, Open Cloud, designpattern.fyi), and published books for Dr. Amit Puri (amitpuri).

# paths./api/projects.json.get.parameters[].description
Filter initiatives by category (e.g. 'all', 'ai', 'governance', 'cloud', 'patterns').

# paths./api/v1/projects.json.get.description
Versioned endpoint returning portfolio initiatives and publications for Dr. Amit Puri.

# paths./api/health.json.get.description
Returns operational health status, active API version, timestamp, and developer resource links for amitpuri.com.

# paths./api/health.json.get.parameters[].description
Optional component check identifier (e.g. 'all', 'ping', 'version').

# paths./api/v1/health.json.get.description
Versioned endpoint returning API operational health and version metadata.

# paths./api/deprecation.json.get.description
Retrieves official semantic versioning roadmap, Sunset/Deprecation header specifications, and 90-day grace period policies for amitpuri APIs.

# paths./api/deprecation.json.get.responses.200.description
Versioning and deprecation policy document

# paths./api/v1/deprecation.json.get.summary
API Versioning & Deprecation Policy (v1 Stable)

# paths./api/v1/deprecation.json.get.description
Versioned endpoint returning API deprecation and version lifecycle policies for Dr. Amit Puri.

# paths./api/v1/deprecation.json.get.responses.200.description
Versioning and deprecation policy document

# paths./api/404.json.get.summary
RFC 9457 API Not Found Error Demonstration

# paths./api/404.json.get.description
Demonstration error endpoint returning an RFC 9457 Problem Details error payload with machine-readable error codes.

# paths./llms.txt.get.description
Standardized llmstxt.org markdown guidance file for AI agents, multi-agent systems, and LLMs.

# paths./llms.txt.get.responses.200.content.text/plain.schema.description
UTF-8 Markdown text per llmstxt.org specification