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"
  },
  "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 or null

_linksobject or null

The location and content type of related resources

_maintainerobject or null

descriptionstring or null

customParametersobject or null

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

Authentication

Path parameters

Request

Response

Errors