Create an AI tool | LaunchDarkly

import requests
url = "https://app.launchdarkly.com/api/v2/projects/projectKey/ai-tools"
payload = {
    "key": "key",
    "schema": "{}",
    "maintainerId": "507f1f77bcf86cd799439011",
    "maintainerTeamKey": "example-team-key",
    "description": "description",
    "customParameters": "{}"
}
headers = {
    "Authorization": "<apiKey>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "key": "key",
  "schema": "{}",
  "version": 0,
  "createdAt": 6,
  "_access": {
    "denied": [
      {
        "action": "action",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string",
            "string"
          ],
          "role_name": "role_name"
        }
      },
      {
        "action": "action",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string",
            "string"
          ],
          "role_name": "role_name"
        }
      }
    ],
    "allowed": [
      {
        "action": "action",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string",
            "string"
          ],
          "role_name": "role_name"
        }
      },
      {
        "action": "action",
        "reason": {
          "effect": "allow",
          "resources": [
            "proj/*:env/*;qa_*:/flag/*"
          ],
          "notResources": [
            "notResources",
            "notResources"
          ],
          "actions": [
            "*"
          ],
          "notActions": [
            "string",
            "string"
          ],
          "role_name": "role_name"
        }
      }
    ]
  },
  "_links": {
    "self": {
      "href": "href",
      "type": "type"
    },
    "parent": {
      "href": "href",
      "type": "type"
    }
  },
  "_maintainer": {
    "_id": "string",
    "email": "string",
    "role": "string",
    "kind": "kind"
  },
  "description": "description",
  "customParameters": "{}"
}

Create an AI tool

Authentication

Authorizationstring

API Key authentication via header

Path parameters

projectKeystringRequired

Request

AI tool object to create

keystringRequired

schemaobjectRequired

JSON Schema defining the tool's parameters for LLM consumption

maintainerIdstringOptional

maintainerTeamKeystringOptional

descriptionstringOptional

customParametersobjectOptional

Custom metadata and configuration for application-level use (not sent to LLM)

Response

AI tool created

keystring

schemaobject

JSON Schema defining the tool's parameters for LLM consumption

versioninteger

createdAtlong

_accessobject

_linksobject

The location and content type of related resources

_maintainerobject

descriptionstring

customParametersobject

Custom metadata and configuration for application-level use (not sent to LLM)

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error