Skip to main content
POST
/
api
/
v1
/
dynamic-tools
Create a new dynamic tool
curl --request POST \
  --url https://neo.api.projectdiscovery.io/api/v1/dynamic-tools \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "<string>",
  "handler_export": "<string>",
  "input_schema": {},
  "name": "<string>",
  "source_code": "<string>",
  "tool_id": "github_get_pr",
  "output_schema": {},
  "pinned": true,
  "tags": [
    "<string>"
  ],
  "timeout_ms": 150500,
  "toolkit_id": "<string>",
  "when_to_use": "<string>"
}
'
{
  "created_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "handler_export": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "input_schema": {},
  "name": "<string>",
  "pinned": true,
  "source_code": "<string>",
  "timeout_ms": 123,
  "tool_id": "<string>",
  "toolkit_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "toolkit_slug": "<string>",
  "output_schema": {},
  "tags": [
    "<string>"
  ],
  "updated_at": "2023-11-07T05:31:56Z",
  "when_to_use": "<string>"
}

Authorizations

​
Authorization
string
header
required

JWT authentication token

Body

application/json
​
description
string
required
​
handler_export
string
required
​
input_schema
object
required
​
name
string
required
​
source_code
string
required
​
tool_id
string
required

Stable slug identifying the tool, unique per user. Lowercase letters and digits with underscores or hyphens; must start with a letter; 1-128 characters. Underscores ARE allowed (snake_case) — unlike toolkit IDs, which are hyphen-only. Prefer prefixing with the toolkit name, e.g. "github_get_pr".

Pattern: ^[a-z][a-z0-9_-]{0,127}$
Example:

"github_get_pr"

​
output_schema
object
​
pinned
boolean
​
tags
string[]
​
timeout_ms
integer
Required range: 1000 <= x <= 300000
​
toolkit_id
string

Kebab-case slug of the target toolkit (hyphen-separated, no underscores). Omit to place the tool in the user's auto-managed "global" toolkit.

​
when_to_use
string

Response

Created

​
created_at
string<date-time>
required
​
description
string
required
​
handler_export
string
required
​
id
string<uuid>
required
​
input_schema
object
required
​
name
string
required
​
pinned
boolean
required
​
source_code
string
required
​
timeout_ms
integer
required
​
tool_id
string
required
​
toolkit_id
string<uuid>
required
​
toolkit_slug
string
required
​
output_schema
object
​
tags
string[]
​
updated_at
string<date-time>
​
when_to_use
string