PRpremai-io
Chats
dev-api

Execute Tool

Changed on

Execute a specific tool by passing encrypted parameters.

post/tools/{id}

Request

  • Base URL
    https://gateway.prem.io
  • Auth
    HTTP bearer and API key in header Authorization

Path parameters

idstring required

The tool identifier (e.g., generateImage, audioGenerateFromText, createFileForUser)

Request body

OR
OR
OR

Example request

{
  "title": "Web Search Request",
  "value": {
    "cipherText": "a1b2c3d4e5f6...",
    "encryptedParams": "9f8e7d6c5b4a...",
    "nonce": "1a2b3c4d5e6f..."
  }
}

Response

Tool executed successfully with encrypted response

status200 | 201 | 202 required

Status code of the response

errorstring nullable

Error message of the response, human readable

messagestring nullable required

Message of the response, human readable

env'development' | 'production' required

API environment

support_idstring uuid nullable

Support ID linked to the response, used to identify it when talking with our team.

Example response

{
  "status": 200,
  "data": {
    "id": "123"
  },
  "error": null,
  "log": null,
  "validator": null,
  "support_id": null,
  "message": "Resource created successfully",
  "env": "development"
}

Changes

  • d46bc3931b34Revision changes
    • warning

      added the new 405.00 enum value to the / response property for the response status

    • warning

      added the new 405.00 enum value to the / response property for the response status

    • warning

      added the new 405.00 enum value to the / response property for the response status

    • warning

      added the new 405.00 enum value to the response property for the response status

    • warning

      added the new 409.00 enum value to the / response property for the response status

    • warning

      added the new 409.00 enum value to the / response property for the response status

    • warning

      added the new 409.00 enum value to the / response property for the response status

    • warning

      added the new 409.00 enum value to the response property for the response status

    • warning

      added the new 500.00 enum value to the / response property for the response status

    • warning

      added the new 500.00 enum value to the / response property for the response status

    • warning

      added the new 500.00 enum value to the / response property for the response status

    • warning

      added the new 500.00 enum value to the response property for the response status

  • d5b1beb33be5Revision changes
    • info

      endpoint added