> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiosk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update endpoint docs



## OpenAPI

````yaml /openapi/public-gateway.json put /v1/apis/{slug}/endpoints/docs
openapi: 3.1.0
info:
  title: Apiosk Gateway Public API
  version: 1.1.0
  description: >-
    Sanitized public API reference for the Apiosk gateway. This document covers
    the integration contract for discovery, metadata, execution, payments, and
    community API publishing without exposing internal gateway implementation
    details.
servers:
  - url: https://gateway.apiosk.com
    description: Production gateway
security: []
tags:
  - name: Discovery
    description: Browse listing groups, APIs, and listing detail.
  - name: Execution
    description: Call APIs through public metadata and uniform execute routes.
  - name: Payments
    description: 'Public x402 boundary: 402 responses and payment proof header.'
  - name: Publishing
    description: Register, inspect, update, and deactivate community APIs.
  - name: Metrics
    description: Public wallet and traffic summary routes.
paths:
  /v1/apis/{slug}/endpoints/docs:
    put:
      tags:
        - Publishing
      summary: Endpoint docs
      operationId: updateEndpointDocs
      parameters:
        - name: slug
          in: path
          required: true
          description: Gateway API slug.
          schema:
            type: string
          example: my-api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateEndpointDocsRequest'
      responses:
        '200':
          description: Endpoint docs update result.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateEndpointDocsResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
      security:
        - WalletAddress: []
          WalletSignature: []
          WalletTimestamp: []
          WalletNonce: []
components:
  schemas:
    UpdateEndpointDocsRequest:
      type: object
      required:
        - owner_wallet
        - method
        - path
      properties:
        owner_wallet:
          type: string
        method:
          type: string
        path:
          type: string
        description:
          type: string
          nullable: true
        request_body:
          type: object
          additionalProperties: true
          nullable: true
        response_body:
          type: object
          additionalProperties: true
          nullable: true
        request_example:
          nullable: true
        response_example:
          nullable: true
    UpdateEndpointDocsResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
  responses:
    Unauthorized:
      description: Missing or invalid signed wallet headers.
      content:
        application/json:
          schema:
            type: object
            additionalProperties: true
    NotFound:
      description: Resource not found.
      content:
        application/json:
          schema:
            type: object
            additionalProperties: true
  securitySchemes:
    WalletAddress:
      type: apiKey
      in: header
      name: x-wallet-address
      description: Wallet address used for signed management calls.
    WalletSignature:
      type: apiKey
      in: header
      name: x-wallet-signature
      description: Signature over the canonical Apiosk auth message.
    WalletTimestamp:
      type: apiKey
      in: header
      name: x-wallet-timestamp
      description: Unix timestamp used in the signed auth message.
    WalletNonce:
      type: apiKey
      in: header
      name: x-wallet-nonce
      description: Replay-protected nonce used in the signed auth message.

````