Proompty — Prompt

naftiko: 1.0.0-alpha2
info:
  label: Proompty — Prompt
  description: 'Proompty — Prompt. 4 operations. Lead operation: Retrieve details about a specific prompt within a designated
    topic in the Proompty API. By sending a GET request to this endpoint with the corresponding topicId and promptId parameters,
    users can access information such as the prompt''s content, creation date, and any associated metadata. The API responds
    with the prompt object in JSON format, contai'
  tags:
  - Proompty
  - Prompt
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    PROOMPTY_API_KEY: PROOMPTY_API_KEY
capability:
  consumes:
  - type: http
    namespace: proompty-prompt
    baseUri: https://app.proompty.com/api
    description: Proompty — Prompt business capability. Self-contained, no shared references.
    resources:
    - name: topics-topicId-prompts-promptId
      path: /topics/{topicId}/prompts/{promptId}
      operations:
      - name: get
        method: GET
        description: Retrieve details about a specific prompt within a designated topic in the Proompty API. By sending a
          GET request to this endpoint with the corresponding topicId and promptId parameters, users can access information
          such as the prompt's cont
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: topicId
          in: path
          type: string
          required: true
        - name: promptId
          in: path
          type: string
          required: true
      - name: put
        method: PUT
        description: Proompty Update a specific prompt within a designated topic. Users can send a PUT request to this endpoint
          with the corresponding topicId and promptId parameters, along with a JSON payload containing the updated prompt
          information. This ena
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: topicId
          in: path
          type: string
          required: true
        - name: promptId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: delete
        method: DELETE
        description: Remove a specific prompt associated with a particular topic. To utilize this endpoint, users send a DELETE
          request with the relevant topicId and promptId parameters. Upon successful execution, the specified prompt is permanently
          deleted fro
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: topicId
          in: path
          type: string
          required: true
        - name: promptId
          in: path
          type: string
          required: true
    - name: topics-topicId-prompts-promptId-chat
      path: /topics/{topicId}/prompts/{promptId}/chat
      operations:
      - name: post
        method: POST
        description: Retrieves user information within the Proompty API system. By sending a GET request to this endpoint,
          users can obtain detailed data pertaining to their profile and associated claims. This includes essential user attributes
          such as email, f
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: topicId
          in: path
          type: string
          required: true
        - name: promptId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
  exposes:
  - type: rest
    namespace: proompty-prompt-rest
    port: 8080
    description: REST adapter for Proompty — Prompt. One Spectral-compliant resource per consumed operation, prefixed with
      /v1.
    resources:
    - path: /v1/topics/{topicid}/prompts/{promptid}
      name: topics-topicid-prompts-promptid
      description: REST surface for topics-topicId-prompts-promptId.
      operations:
      - method: GET
        name: get
        description: Retrieve details about a specific prompt within a designated topic in the Proompty API. By sending a
          GET request to this endpoint with the corresponding topicId and promptId parameters, users can access information
          such as the prompt's cont
        call: proompty-prompt.get
        with:
          topicId: rest.topicId
          promptId: rest.promptId
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: put
        description: Proompty Update a specific prompt within a designated topic. Users can send a PUT request to this endpoint
          with the corresponding topicId and promptId parameters, along with a JSON payload containing the updated prompt
          information. This ena
        call: proompty-prompt.put
        with:
          topicId: rest.topicId
          promptId: rest.promptId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: delete
        description: Remove a specific prompt associated with a particular topic. To utilize this endpoint, users send a DELETE
          request with the relevant topicId and promptId parameters. Upon successful execution, the specified prompt is permanently
          deleted fro
        call: proompty-prompt.delete
        with:
          topicId: rest.topicId
          promptId: rest.promptId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/topics/{topicid}/prompts/{promptid}/chat
      name: topics-topicid-prompts-promptid-chat
      description: REST surface for topics-topicId-prompts-promptId-chat.
      operations:
      - method: POST
        name: post
        description: Retrieves user information within the Proompty API system. By sending a GET request to this endpoint,
          users can obtain detailed data pertaining to their profile and associated claims. This includes essential user attributes
          such as email, f
        call: proompty-prompt.post
        with:
          topicId: rest.topicId
          promptId: rest.promptId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: proompty-prompt-mcp
    port: 9090
    transport: http
    description: MCP adapter for Proompty — Prompt. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: retrieve-details-about-specific-prompt
      description: Retrieve details about a specific prompt within a designated topic in the Proompty API. By sending a GET
        request to this endpoint with the corresponding topicId and promptId parameters, users can access information such
        as the prompt's cont
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: proompty-prompt.get
      with:
        topicId: tools.topicId
        promptId: tools.promptId
      outputParameters:
      - type: object
        mapping: $.
    - name: proompty-update-specific-prompt-within
      description: Proompty Update a specific prompt within a designated topic. Users can send a PUT request to this endpoint
        with the corresponding topicId and promptId parameters, along with a JSON payload containing the updated prompt information.
        This ena
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: proompty-prompt.put
      with:
        topicId: tools.topicId
        promptId: tools.promptId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: remove-specific-prompt-associated-particular
      description: Remove a specific prompt associated with a particular topic. To utilize this endpoint, users send a DELETE
        request with the relevant topicId and promptId parameters. Upon successful execution, the specified prompt is permanently
        deleted fro
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: proompty-prompt.delete
      with:
        topicId: tools.topicId
        promptId: tools.promptId
      outputParameters:
      - type: object
        mapping: $.
    - name: retrieves-user-information-within-proompty
      description: Retrieves user information within the Proompty API system. By sending a GET request to this endpoint, users
        can obtain detailed data pertaining to their profile and associated claims. This includes essential user attributes
        such as email, f
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: proompty-prompt.post
      with:
        topicId: tools.topicId
        promptId: tools.promptId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.