> ## 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.

# Get agent metadata



## OpenAPI

````yaml /openapi/public-gateway.json get /{api_slug}/metadata
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:
  /{api_slug}/metadata:
    get:
      tags:
        - Execution
      summary: Agent metadata
      operationId: getAgentMetadata
      parameters:
        - name: api_slug
          in: path
          required: true
          description: Gateway API slug.
          schema:
            type: string
          example: neural-sync-01
      responses:
        '200':
          description: Agent-native metadata for one API.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentMetadataResponse'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  schemas:
    AgentMetadataResponse:
      type: object
      properties:
        success:
          type: boolean
        status:
          type: string
        api:
          type: object
          properties:
            id:
              type: string
              format: uuid
            slug:
              type: string
            name:
              type: string
            description:
              type: string
            category:
              type: string
              nullable: true
            listing_type:
              type: string
              nullable: true
            gateway_base_url:
              type: string
            origin_url:
              type: string
            docs_url:
              type: string
              nullable: true
        execute:
          type: object
          properties:
            method:
              type: string
              const: POST
            path:
              type: string
              const: /execute
            default_operation:
              type: string
              nullable: true
            request_formats:
              type: array
              items:
                type: object
                properties:
                  type:
                    type: string
                  description:
                    type: string
        metadata_path:
          type: string
        operations:
          type: array
          items:
            $ref: '#/components/schemas/AgentOperation'
        metadata:
          type: object
          additionalProperties: true
        mcp_tool:
          type: object
          additionalProperties: true
        input_schema:
          type: object
          additionalProperties: true
        output_schema:
          type: object
          additionalProperties: true
        cost_per_call:
          type: number
        latency_ms:
          type: integer
        tags:
          type: array
          items:
            type: string
        agent_native:
          type: boolean
        mcp_native:
          type: boolean
    AgentOperation:
      type: object
      properties:
        id:
          type: string
        key:
          type: string
        method:
          type: string
        path:
          type: string
        gateway_url:
          type: string
        execute_url:
          type: string
        payment_required:
          type: boolean
        price_usd:
          type: number
        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
        headers:
          type: object
          additionalProperties: true
          nullable: true
        query_params:
          type: object
          additionalProperties: true
          nullable: true
  responses:
    NotFound:
      description: Resource not found.
      content:
        application/json:
          schema:
            type: object
            additionalProperties: true

````