Proompty — Prompts

naftiko: 1.0.0-alpha2
info:
  label: Proompty — Prompts
  description: 'Proompty — Prompts. 6 operations. Lead operation: Retrieve a list of all prompts associated with a specific
    topic. Users can send a GET request to this endpoint with the relevant topicId parameter to access comprehensive information
    about each prompt within the specified topic. The API responds with an array of prompt objects in JSON format, containing
    details such as prompt content, creation date'
  tags:
  - Proompty
  - Prompts
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    PROOMPTY_API_KEY: PROOMPTY_API_KEY
capability:
  consumes:
  - type: http
    namespace: proompty-prompts
    baseUri: https://app.proompty.com/api
    description: Proompty — Prompts business capability. Self-contained, no shared references.
    resources:
    - name: topics-topicId-prompts
      path: /topics/{topicId}/prompts
      operations:
      - name: get
        method: GET
        description: Retrieve a list of all prompts associated with a specific topic. Users can send a GET request to this
          endpoint with the relevant topicId parameter to access comprehensive information about each prompt within the specified
          topic. The API res
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: topicId
          in: path
          type: string
          required: true
      - name: post
        method: POST
        description: Create a new prompts within a specified topic. Users can send a POST request to this endpoint, including
          the topicId parameter in the URL path and a JSON payload containing the details of the prompt to be created. This
          payload typically inc
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: topicId
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - 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-prompts-rest
    port: 8080
    description: REST adapter for Proompty — Prompts. One Spectral-compliant resource per consumed operation, prefixed with
      /v1.
    resources:
    - path: /v1/topics/{topicid}/prompts
      name: topics-topicid-prompts
      description: REST surface for topics-topicId-prompts.
      operations:
      - method: GET
        name: get
        description: Retrieve a list of all prompts associated with a specific topic. Users can send a GET request to this
          endpoint with the relevant topicId parameter to access comprehensive information about each prompt within the specified
          topic. The API res
        call: proompty-prompts.get
        with:
          topicId: rest.topicId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: post
        description: Create a new prompts within a specified topic. Users can send a POST request to this endpoint, including
          the topicId parameter in the URL path and a JSON payload containing the details of the prompt to be created. This
          payload typically inc
        call: proompty-prompts.post
        with:
          topicId: rest.topicId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - 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-prompts.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-prompts.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-prompts.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-prompts.post
        with:
          topicId: rest.topicId
          promptId: rest.promptId
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: proompty-prompts-mcp
    port: 9090
    transport: http
    description: MCP adapter for Proompty — Prompts. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: retrieve-list-all-prompts-associated
      description: Retrieve a list of all prompts associated with a specific topic. Users can send a GET request to this endpoint
        with the relevant topicId parameter to access comprehensive information about each prompt within the specified topic.
        The API res
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: proompty-prompts.get
      with:
        topicId: tools.topicId
      outputParameters:
      - type: object
        mapping: $.
    - name: create-new-prompts-within-specified
      description: Create a new prompts within a specified topic. Users can send a POST request to this endpoint, including
        the topicId parameter in the URL path and a JSON payload containing the details of the prompt to be created. This
        payload typically inc
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: proompty-prompts.post
      with:
        topicId: tools.topicId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - 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-prompts.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-prompts.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-prompts.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-prompts.post
      with:
        topicId: tools.topicId
        promptId: tools.promptId
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.