{
  "openapi": "3.1.0",
  "info": {
    "title": "Osama Khalil content API",
    "version": "1.0.0",
    "summary": "Read-only access to everything published on osama.me.",
    "description": "Profile, work history, initiatives, products, projects, events, writing, and the Markdown of every page on osama.me. No authentication: the data is public and the API is read-only. Every page is also available as Markdown by sending `Accept: text/markdown` or by adding `.md` to its URL.",
    "contact": {
      "name": "Osama Khalil",
      "email": "ok@osama.me",
      "url": "https://osama.me"
    },
    "license": {
      "name": "Content may be cited with attribution",
      "url": "https://osama.me/llms.txt"
    }
  },
  "servers": [
    {
      "url": "https://osama.me",
      "description": "Production"
    }
  ],
  "tags": [
    {
      "name": "Profile",
      "description": "Who Osama Khalil is"
    },
    {
      "name": "Portfolio",
      "description": "Work, initiatives, products, and projects"
    },
    {
      "name": "Content",
      "description": "Events, writing, and page text"
    }
  ],
  "paths": {
    "/api/v1": {
      "get": {
        "operationId": "getApiIndex",
        "summary": "List every endpoint in this API",
        "description": "Discovery endpoint. Returns each available path with a one-line description.",
        "tags": [
          "Profile"
        ],
        "responses": {
          "200": {
            "description": "The endpoint index.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "object"
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/profile": {
      "get": {
        "operationId": "getProfile",
        "summary": "Get the profile",
        "description": "Name, headline, location, contact email, languages, biography paragraphs, social links, and career highlights. Use this to answer \"who is Osama Khalil\" or \"how do I contact him\".",
        "tags": [
          "Profile"
        ],
        "responses": {
          "200": {
            "description": "The profile.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "headline": {
                          "type": "string"
                        },
                        "location": {
                          "type": "string"
                        },
                        "url": {
                          "type": "string",
                          "format": "uri"
                        },
                        "email": {
                          "type": "string",
                          "format": "email"
                        },
                        "languages": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "summary": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "links": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "label": {
                                "type": "string"
                              },
                              "url": {
                                "type": "string",
                                "format": "uri"
                              }
                            }
                          }
                        },
                        "highlights": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/work": {
      "get": {
        "operationId": "listWork",
        "summary": "List work history",
        "description": "Every role held, most recent first, with the achievements listed for each.",
        "tags": [
          "Portfolio"
        ],
        "responses": {
          "200": {
            "description": "Work history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "title": {
                            "type": "string"
                          },
                          "company": {
                            "type": "string"
                          },
                          "organization": {
                            "type": "string"
                          },
                          "start": {
                            "type": "string"
                          },
                          "end": {
                            "type": "string"
                          },
                          "url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "uri"
                          },
                          "highlights": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        }
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/initiatives": {
      "get": {
        "operationId": "listInitiatives",
        "summary": "List community initiatives",
        "description": "Initiatives founded or led, such as Design Battlefield and Design Family, with dates and outcomes.",
        "tags": [
          "Portfolio"
        ],
        "responses": {
          "200": {
            "description": "Initiatives.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "title": {
                            "type": "string"
                          },
                          "company": {
                            "type": "string"
                          },
                          "organization": {
                            "type": "string"
                          },
                          "start": {
                            "type": "string"
                          },
                          "end": {
                            "type": "string"
                          },
                          "url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "format": "uri"
                          },
                          "highlights": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        }
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/products": {
      "get": {
        "operationId": "listProducts",
        "summary": "List products built",
        "description": "Products and experiments built, each with a link and a status.",
        "tags": [
          "Portfolio"
        ],
        "responses": {
          "200": {
            "description": "Products.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "status": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        }
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/projects": {
      "get": {
        "operationId": "listProjects",
        "summary": "List design projects",
        "description": "Client and portfolio design projects, each with a link to the full case.",
        "tags": [
          "Portfolio"
        ],
        "responses": {
          "200": {
            "description": "Projects.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "status": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        }
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/events": {
      "get": {
        "operationId": "listEvents",
        "summary": "List events organized",
        "description": "Every event organized, with date, description, tags, and links to the full page in HTML and Markdown.",
        "tags": [
          "Content"
        ],
        "responses": {
          "200": {
            "description": "Events.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "slug": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "date": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "tags": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "markdown_url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "content": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Full page text as Markdown."
                          }
                        }
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/events/{slug}": {
      "get": {
        "operationId": "getEvent",
        "summary": "Get one event",
        "description": "One event, including the full text of its page as Markdown.",
        "tags": [
          "Content"
        ],
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "The event slug, lowercase letters, digits, and hyphens.",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9-]{1,120}$"
            },
            "example": "farid-omara-in-amman"
          }
        ],
        "responses": {
          "200": {
            "description": "The event.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "slug": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "date": {
                          "type": "string"
                        },
                        "description": {
                          "type": "string"
                        },
                        "tags": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "url": {
                          "type": "string",
                          "format": "uri"
                        },
                        "markdown_url": {
                          "type": "string",
                          "format": "uri"
                        },
                        "content": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Full page text as Markdown."
                        }
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The slug is malformed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "resolution",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "not_found",
                            "invalid_request",
                            "method_not_allowed",
                            "internal_error"
                          ],
                          "description": "Stable machine-readable error code."
                        },
                        "message": {
                          "type": "string",
                          "description": "What went wrong."
                        },
                        "resolution": {
                          "type": "string",
                          "description": "What to do instead."
                        },
                        "status": {
                          "type": "integer",
                          "description": "HTTP status code."
                        },
                        "documentation_url": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No event has that slug.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "resolution",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "not_found",
                            "invalid_request",
                            "method_not_allowed",
                            "internal_error"
                          ],
                          "description": "Stable machine-readable error code."
                        },
                        "message": {
                          "type": "string",
                          "description": "What went wrong."
                        },
                        "resolution": {
                          "type": "string",
                          "description": "What to do instead."
                        },
                        "status": {
                          "type": "integer",
                          "description": "HTTP status code."
                        },
                        "documentation_url": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/posts": {
      "get": {
        "operationId": "listPosts",
        "summary": "List blog posts",
        "description": "Published posts only. Scheduled and draft posts are never returned.",
        "tags": [
          "Content"
        ],
        "responses": {
          "200": {
            "description": "Posts.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "slug": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "description": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "markdown_url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "content": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "Full post text as Markdown."
                          }
                        }
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/posts/{slug}": {
      "get": {
        "operationId": "getPost",
        "summary": "Get one blog post",
        "description": "One post, including its full text as Markdown.",
        "tags": [
          "Content"
        ],
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "description": "The post slug, lowercase letters, digits, and hyphens.",
            "schema": {
              "type": "string",
              "pattern": "^[a-z0-9-]{1,120}$"
            },
            "example": "how-i-built-a-40k-design-community-in-mena"
          }
        ],
        "responses": {
          "200": {
            "description": "The post.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "slug": {
                          "type": "string"
                        },
                        "title": {
                          "type": "string"
                        },
                        "description": {
                          "type": "string"
                        },
                        "url": {
                          "type": "string",
                          "format": "uri"
                        },
                        "markdown_url": {
                          "type": "string",
                          "format": "uri"
                        },
                        "content": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "description": "Full post text as Markdown."
                        }
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The slug is malformed.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "resolution",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "not_found",
                            "invalid_request",
                            "method_not_allowed",
                            "internal_error"
                          ],
                          "description": "Stable machine-readable error code."
                        },
                        "message": {
                          "type": "string",
                          "description": "What went wrong."
                        },
                        "resolution": {
                          "type": "string",
                          "description": "What to do instead."
                        },
                        "status": {
                          "type": "integer",
                          "description": "HTTP status code."
                        },
                        "documentation_url": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No post has that slug.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "resolution",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "not_found",
                            "invalid_request",
                            "method_not_allowed",
                            "internal_error"
                          ],
                          "description": "Stable machine-readable error code."
                        },
                        "message": {
                          "type": "string",
                          "description": "What went wrong."
                        },
                        "resolution": {
                          "type": "string",
                          "description": "What to do instead."
                        },
                        "status": {
                          "type": "integer",
                          "description": "HTTP status code."
                        },
                        "documentation_url": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/media": {
      "get": {
        "operationId": "listMedia",
        "summary": "List press and media appearances",
        "description": "TV segments, interviews, and press coverage, each with a link.",
        "tags": [
          "Content"
        ],
        "responses": {
          "200": {
            "description": "Media appearances.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "title": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "kind": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/pages": {
      "get": {
        "operationId": "listPages",
        "summary": "List every page",
        "description": "Every public page with its HTML URL and its Markdown URL.",
        "tags": [
          "Content"
        ],
        "responses": {
          "200": {
            "description": "Pages.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "markdown_url": {
                            "type": "string",
                            "format": "uri"
                          }
                        }
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/pages/{path}": {
      "get": {
        "operationId": "getPageContent",
        "summary": "Get the Markdown of one page",
        "description": "The full text of any page as Markdown. Equivalent to fetching the page with `Accept: text/markdown`.",
        "tags": [
          "Content"
        ],
        "parameters": [
          {
            "name": "path",
            "in": "path",
            "required": true,
            "description": "The page path without the leading slash, for example `work-with-me`.",
            "schema": {
              "type": "string"
            },
            "example": "work-with-me"
          }
        ],
        "responses": {
          "200": {
            "description": "The page text.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "path": {
                          "type": "string"
                        },
                        "url": {
                          "type": "string",
                          "format": "uri"
                        },
                        "content": {
                          "type": "string"
                        }
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "No page at that path.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "resolution",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "not_found",
                            "invalid_request",
                            "method_not_allowed",
                            "internal_error"
                          ],
                          "description": "Stable machine-readable error code."
                        },
                        "message": {
                          "type": "string",
                          "description": "What went wrong."
                        },
                        "resolution": {
                          "type": "string",
                          "description": "What to do instead."
                        },
                        "status": {
                          "type": "integer",
                          "description": "HTTP status code."
                        },
                        "documentation_url": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/search": {
      "get": {
        "operationId": "searchContent",
        "summary": "Search every page",
        "description": "Substring search across the Markdown of the whole site. Returns the matching pages ranked by match count, each with an excerpt.",
        "tags": [
          "Content"
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "The text to search for.",
            "schema": {
              "type": "string",
              "minLength": 1
            },
            "example": "design battlefield"
          }
        ],
        "responses": {
          "200": {
            "description": "Search results.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "markdown_url": {
                            "type": "string",
                            "format": "uri"
                          },
                          "excerpt": {
                            "type": "string"
                          },
                          "matches": {
                            "type": "integer"
                          }
                        }
                      }
                    },
                    "meta": {
                      "type": "object",
                      "properties": {
                        "version": {
                          "type": "string"
                        },
                        "source": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "The q parameter is missing or empty.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "error"
                  ],
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "resolution",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "enum": [
                            "not_found",
                            "invalid_request",
                            "method_not_allowed",
                            "internal_error"
                          ],
                          "description": "Stable machine-readable error code."
                        },
                        "message": {
                          "type": "string",
                          "description": "What went wrong."
                        },
                        "resolution": {
                          "type": "string",
                          "description": "What to do instead."
                        },
                        "status": {
                          "type": "integer",
                          "description": "HTTP status code."
                        },
                        "documentation_url": {
                          "type": "string",
                          "format": "uri"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "code",
              "message",
              "resolution",
              "status"
            ],
            "properties": {
              "code": {
                "type": "string",
                "enum": [
                  "not_found",
                  "invalid_request",
                  "method_not_allowed",
                  "internal_error"
                ],
                "description": "Stable machine-readable error code."
              },
              "message": {
                "type": "string",
                "description": "What went wrong."
              },
              "resolution": {
                "type": "string",
                "description": "What to do instead."
              },
              "status": {
                "type": "integer",
                "description": "HTTP status code."
              },
              "documentation_url": {
                "type": "string",
                "format": "uri"
              }
            }
          }
        }
      }
    }
  },
  "externalDocs": {
    "description": "Developer resources, including the MCP server and the machine-readable files",
    "url": "https://osama.me/developers"
  }
}