APIs.io Engineering Platform Amazon API Gateway — Domainnames

naftiko: 1.0.0-alpha2
info:
  label: APIs.io Engineering Platform Amazon API Gateway — Domainnames
  description: 'APIs.io Engineering Platform Amazon API Gateway — Domainnames. 10 operations. Lead operation: Domainnames.
    Self-contained Naftiko capability covering one Engineering Platform business surface.'
  tags:
  - Engineering Platform
  - Domainnames
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    ENGINEERING_PLATFORM_API_KEY: ENGINEERING_PLATFORM_API_KEY
capability:
  consumes:
  - type: http
    namespace: aws-api-gateway-domainnames
    baseUri: http://apigateway.{region}.amazonaws.com
    description: APIs.io Engineering Platform Amazon API Gateway — Domainnames business capability. Self-contained, no shared
      references.
    resources:
    - name: domainnames
      path: /domainnames
      operations:
      - name: createdomainname
        method: POST
        description: Creates a new domain name.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: getdomainnames
        method: GET
        description: Represents a collection of DomainName resources.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: position
          in: query
          type: string
          description: The current pagination position in the paged result set.
        - name: limit
          in: query
          type: integer
          description: The maximum number of returned results per page. The default value is 25 and the maximum value is 500.
    - name: domainnames-domain_name
      path: /domainnames/{domain_name}
      operations:
      - name: deletedomainname
        method: DELETE
        description: Deletes the DomainName resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: domain_name
          in: path
          type: string
          description: The name of the DomainName resource to be deleted.
          required: true
      - name: getdomainname
        method: GET
        description: Represents a domain name that is contained in a simpler, more intuitive URL that can be called.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: domain_name
          in: path
          type: string
          description: The name of the DomainName resource.
          required: true
      - name: updatedomainname
        method: PATCH
        description: Changes information about the DomainName resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: domain_name
          in: path
          type: string
          description: The name of the DomainName resource to be changed.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: domainnames-domain_name-basepathmappings
      path: /domainnames/{domain_name}/basepathmappings
      operations:
      - name: createbasepathmapping
        method: POST
        description: Creates a new BasePathMapping resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: domain_name
          in: path
          type: string
          description: The domain name of the BasePathMapping resource to create.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: getbasepathmappings
        method: GET
        description: Represents a collection of BasePathMapping resources.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: domain_name
          in: path
          type: string
          description: The domain name of a BasePathMapping resource.
          required: true
        - name: position
          in: query
          type: string
          description: The current pagination position in the paged result set.
        - name: limit
          in: query
          type: integer
          description: The maximum number of returned results per page. The default value is 25 and the maximum value is 500.
    - name: domainnames-domain_name-basepathmappings-base_path
      path: /domainnames/{domain_name}/basepathmappings/{base_path}
      operations:
      - name: deletebasepathmapping
        method: DELETE
        description: Deletes the BasePathMapping resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: domain_name
          in: path
          type: string
          description: The domain name of the BasePathMapping resource to delete.
          required: true
        - name: base_path
          in: path
          type: string
          description: <p>The base path name of the BasePathMapping resource to delete.</p> <p>To specify an empty base path,
            set this parameter to <code>'(none)'</code>.</p>
          required: true
      - name: getbasepathmapping
        method: GET
        description: Describe a BasePathMapping resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: domain_name
          in: path
          type: string
          description: The domain name of the BasePathMapping resource to be described.
          required: true
        - name: base_path
          in: path
          type: string
          description: The base path name that callers of the API must provide as part of the URL after the domain name. This
            value must be unique for all of the mappings across a sin
          required: true
      - name: updatebasepathmapping
        method: PATCH
        description: Changes information about the BasePathMapping resource.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: domain_name
          in: path
          type: string
          description: The domain name of the BasePathMapping resource to change.
          required: true
        - name: base_path
          in: path
          type: string
          description: <p>The base path of the BasePathMapping resource to change.</p> <p>To specify an empty base path, set
            this parameter to <code>'(none)'</code>.</p>
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.ENGINEERING_PLATFORM_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: aws-api-gateway-domainnames-rest
    port: 8080
    description: REST adapter for APIs.io Engineering Platform Amazon API Gateway — Domainnames. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/domainnames
      name: domainnames
      description: REST surface for domainnames.
      operations:
      - method: POST
        name: createdomainname
        description: Creates a new domain name.
        call: aws-api-gateway-domainnames.createdomainname
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getdomainnames
        description: Represents a collection of DomainName resources.
        call: aws-api-gateway-domainnames.getdomainnames
        with:
          position: rest.position
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/domainnames/{domain-name}
      name: domainnames-domain-name
      description: REST surface for domainnames-domain_name.
      operations:
      - method: DELETE
        name: deletedomainname
        description: Deletes the DomainName resource.
        call: aws-api-gateway-domainnames.deletedomainname
        with:
          domain_name: rest.domain_name
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getdomainname
        description: Represents a domain name that is contained in a simpler, more intuitive URL that can be called.
        call: aws-api-gateway-domainnames.getdomainname
        with:
          domain_name: rest.domain_name
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updatedomainname
        description: Changes information about the DomainName resource.
        call: aws-api-gateway-domainnames.updatedomainname
        with:
          domain_name: rest.domain_name
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/domainnames/{domain-name}/basepathmappings
      name: domainnames-domain-name-basepathmappings
      description: REST surface for domainnames-domain_name-basepathmappings.
      operations:
      - method: POST
        name: createbasepathmapping
        description: Creates a new BasePathMapping resource.
        call: aws-api-gateway-domainnames.createbasepathmapping
        with:
          domain_name: rest.domain_name
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getbasepathmappings
        description: Represents a collection of BasePathMapping resources.
        call: aws-api-gateway-domainnames.getbasepathmappings
        with:
          domain_name: rest.domain_name
          position: rest.position
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/domainnames/{domain-name}/basepathmappings/{base-path}
      name: domainnames-domain-name-basepathmappings-base-path
      description: REST surface for domainnames-domain_name-basepathmappings-base_path.
      operations:
      - method: DELETE
        name: deletebasepathmapping
        description: Deletes the BasePathMapping resource.
        call: aws-api-gateway-domainnames.deletebasepathmapping
        with:
          domain_name: rest.domain_name
          base_path: rest.base_path
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getbasepathmapping
        description: Describe a BasePathMapping resource.
        call: aws-api-gateway-domainnames.getbasepathmapping
        with:
          domain_name: rest.domain_name
          base_path: rest.base_path
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: updatebasepathmapping
        description: Changes information about the BasePathMapping resource.
        call: aws-api-gateway-domainnames.updatebasepathmapping
        with:
          domain_name: rest.domain_name
          base_path: rest.base_path
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: aws-api-gateway-domainnames-mcp
    port: 9090
    transport: http
    description: MCP adapter for APIs.io Engineering Platform Amazon API Gateway — Domainnames. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: creates-new-domain-name
      description: Creates a new domain name.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: aws-api-gateway-domainnames.createdomainname
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: represents-collection-domainname-resources
      description: Represents a collection of DomainName resources.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aws-api-gateway-domainnames.getdomainnames
      with:
        position: tools.position
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: deletes-domainname-resource
      description: Deletes the DomainName resource.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: aws-api-gateway-domainnames.deletedomainname
      with:
        domain_name: tools.domain_name
      outputParameters:
      - type: object
        mapping: $.
    - name: represents-domain-name-that-is
      description: Represents a domain name that is contained in a simpler, more intuitive URL that can be called.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aws-api-gateway-domainnames.getdomainname
      with:
        domain_name: tools.domain_name
      outputParameters:
      - type: object
        mapping: $.
    - name: changes-information-about-domainname-resource
      description: Changes information about the DomainName resource.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: aws-api-gateway-domainnames.updatedomainname
      with:
        domain_name: tools.domain_name
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: creates-new-basepathmapping-resource
      description: Creates a new BasePathMapping resource.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: aws-api-gateway-domainnames.createbasepathmapping
      with:
        domain_name: tools.domain_name
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: represents-collection-basepathmapping-resources
      description: Represents a collection of BasePathMapping resources.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aws-api-gateway-domainnames.getbasepathmappings
      with:
        domain_name: tools.domain_name
        position: tools.position
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: deletes-basepathmapping-resource
      description: Deletes the BasePathMapping resource.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: aws-api-gateway-domainnames.deletebasepathmapping
      with:
        domain_name: tools.domain_name
        base_path: tools.base_path
      outputParameters:
      - type: object
        mapping: $.
    - name: describe-basepathmapping-resource
      description: Describe a BasePathMapping resource.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aws-api-gateway-domainnames.getbasepathmapping
      with:
        domain_name: tools.domain_name
        base_path: tools.base_path
      outputParameters:
      - type: object
        mapping: $.
    - name: changes-information-about-basepathmapping-resource
      description: Changes information about the BasePathMapping resource.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: aws-api-gateway-domainnames.updatebasepathmapping
      with:
        domain_name: tools.domain_name
        base_path: tools.base_path
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.