PUT /v1/functions/{id}

Actualizar una funcion de webhook

curl --request PUT \
  --url https://api.keebai.com/v1/functions/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "display_name": "<string>",
  "description": "<string>",
  "tool_params": [
    {
      "name": "<string>",
      "description": "<string>",
      "type": "string",
      "required": true
    }
  ],
  "tags": [
    "<string>"
  ],
  "is_active": true
}
'

import requests

url = "https://api.keebai.com/v1/functions/{id}"

payload = {
    "name": "<string>",
    "display_name": "<string>",
    "description": "<string>",
    "tool_params": [
        {
            "name": "<string>",
            "description": "<string>",
            "type": "string",
            "required": True
        }
    ],
    "tags": ["<string>"],
    "is_active": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    display_name: '<string>',
    description: '<string>',
    tool_params: [{name: '<string>', description: '<string>', type: 'string', required: true}],
    tags: ['<string>'],
    is_active: true
  })
};

fetch('https://api.keebai.com/v1/functions/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.keebai.com/v1/functions/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'display_name' => '<string>',
    'description' => '<string>',
    'tool_params' => [
        [
                'name' => '<string>',
                'description' => '<string>',
                'type' => 'string',
                'required' => true
        ]
    ],
    'tags' => [
        '<string>'
    ],
    'is_active' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.keebai.com/v1/functions/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"display_name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"tool_params\": [\n    {\n      \"name\": \"<string>\",\n      \"description\": \"<string>\",\n      \"type\": \"string\",\n      \"required\": true\n    }\n  ],\n  \"tags\": [\n    \"<string>\"\n  ],\n  \"is_active\": true\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.keebai.com/v1/functions/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"display_name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"tool_params\": [\n    {\n      \"name\": \"<string>\",\n      \"description\": \"<string>\",\n      \"type\": \"string\",\n      \"required\": true\n    }\n  ],\n  \"tags\": [\n    \"<string>\"\n  ],\n  \"is_active\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.keebai.com/v1/functions/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"display_name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"tool_params\": [\n    {\n      \"name\": \"<string>\",\n      \"description\": \"<string>\",\n      \"type\": \"string\",\n      \"required\": true\n    }\n  ],\n  \"tags\": [\n    \"<string>\"\n  ],\n  \"is_active\": true\n}"

response = http.request(request)
puts response.read_body

{
  "function": {
    "_id": "<string>",
    "name": "<string>",
    "display_name": "<string>",
    "description": "<string>",
    "type": "webhook",
    "tool_params": [
      {
        "name": "<string>",
        "required": true,
        "description": "<string>"
      }
    ],
    "context": {
      "url": "<string>",
      "headers": {
        "Authorization": "***"
      },
      "params": {},
      "timeout": 123,
      "body": {},
      "response_path": "<string>"
    },
    "tags": [
      "<string>"
    ],
    "is_active": true,
    "used_by_blocks": [
      {
        "block_id": "<string>",
        "name": "<string>"
      }
    ],
    "created_at": "<string>",
    "updated_at": "<string>"
  }
}

PUT

functions

{id}

Actualizar una funcion de webhook

curl --request PUT \
  --url https://api.keebai.com/v1/functions/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "display_name": "<string>",
  "description": "<string>",
  "tool_params": [
    {
      "name": "<string>",
      "description": "<string>",
      "type": "string",
      "required": true
    }
  ],
  "tags": [
    "<string>"
  ],
  "is_active": true
}
'

import requests

url = "https://api.keebai.com/v1/functions/{id}"

payload = {
    "name": "<string>",
    "display_name": "<string>",
    "description": "<string>",
    "tool_params": [
        {
            "name": "<string>",
            "description": "<string>",
            "type": "string",
            "required": True
        }
    ],
    "tags": ["<string>"],
    "is_active": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    display_name: '<string>',
    description: '<string>',
    tool_params: [{name: '<string>', description: '<string>', type: 'string', required: true}],
    tags: ['<string>'],
    is_active: true
  })
};

fetch('https://api.keebai.com/v1/functions/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.keebai.com/v1/functions/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'display_name' => '<string>',
    'description' => '<string>',
    'tool_params' => [
        [
                'name' => '<string>',
                'description' => '<string>',
                'type' => 'string',
                'required' => true
        ]
    ],
    'tags' => [
        '<string>'
    ],
    'is_active' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.keebai.com/v1/functions/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"display_name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"tool_params\": [\n    {\n      \"name\": \"<string>\",\n      \"description\": \"<string>\",\n      \"type\": \"string\",\n      \"required\": true\n    }\n  ],\n  \"tags\": [\n    \"<string>\"\n  ],\n  \"is_active\": true\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.keebai.com/v1/functions/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"display_name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"tool_params\": [\n    {\n      \"name\": \"<string>\",\n      \"description\": \"<string>\",\n      \"type\": \"string\",\n      \"required\": true\n    }\n  ],\n  \"tags\": [\n    \"<string>\"\n  ],\n  \"is_active\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.keebai.com/v1/functions/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"display_name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"tool_params\": [\n    {\n      \"name\": \"<string>\",\n      \"description\": \"<string>\",\n      \"type\": \"string\",\n      \"required\": true\n    }\n  ],\n  \"tags\": [\n    \"<string>\"\n  ],\n  \"is_active\": true\n}"

response = http.request(request)
puts response.read_body

{
  "function": {
    "_id": "<string>",
    "name": "<string>",
    "display_name": "<string>",
    "description": "<string>",
    "type": "webhook",
    "tool_params": [
      {
        "name": "<string>",
        "required": true,
        "description": "<string>"
      }
    ],
    "context": {
      "url": "<string>",
      "headers": {
        "Authorization": "***"
      },
      "params": {},
      "timeout": 123,
      "body": {},
      "response_path": "<string>"
    },
    "tags": [
      "<string>"
    ],
    "is_active": true,
    "used_by_blocks": [
      {
        "block_id": "<string>",
        "name": "<string>"
      }
    ],
    "created_at": "<string>",
    "updated_at": "<string>"
  }
}

Partial update: only the fields present in the body change. The subtlety is inside context. Because header and query-string values are masked on read, you cannot round-trip them, so this endpoint merges instead.

What you send	What happens
No `context`	Nothing about the request changes
`context` without `headers`	The stored headers are kept
`context` with `headers`	The whole map is replaced with what you sent
A value equal to `***`	`400 FUNCTION_MASKED_VALUE_WRITE`, naming the keys

The last row exists so the obvious client pattern — GET, change one field, PUT it all back — fails loudly instead of writing the literal string *** over a live credential.

Endpoint

PUT https://api.keebai.com/v1/functions/{id}

Required scope

assistants:write

Headers

Header	Required	Value
`Authorization`	Yes	`Bearer kbai_pk_<token>`
`Content-Type`	Yes	`application/json`

Path parameters

Parameter	Type	Description
`id`	`string`	`ObjectId` of the function.

Body

Every field is optional. context, when present, must carry at least url.

Field	Type	Description
`name`	`string`	Machine name, unique per company.
`display_name`	`string`	Up to 200 characters.
`description`	`string`	Up to 1000 characters.
`context`	`object`	Same shape as on create. Merged per the table above.
`tool_params`	`object[]`	Replaces the whole list.
`tags`	`string[]`	Replaces the whole list.
`is_active`	`boolean`	`false` stops the model being offered the function.

Example request

# Change the URL, keep the stored credentials.
curl -X PUT https://api.keebai.com/v1/functions/6650cccc3333dddd4444eeee \
  -H "Authorization: Bearer kbai_pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "context": {
      "url": "https://erp.example.com/v2/stock/{{sku}}",
      "method": "GET",
      "timeout": 10
    }
  }'

const url = "https://api.keebai.com/v1/functions/6650cccc3333dddd4444eeee";
const headers = {
  Authorization: `Bearer ${process.env.KEEBAI_API_TOKEN}`,
  "Content-Type": "application/json",
};

// Rotating a credential: send the new value explicitly.
await fetch(url, {
  method: "PUT",
  headers,
  body: JSON.stringify({
    context: {
      url: "https://erp.example.com/v2/stock/{{sku}}",
      method: "GET",
      headers: { Authorization: `Bearer ${process.env.ERP_TOKEN_NEW}` },
    },
  }),
});

// Switching it off without changing anything else.
await fetch(url, {
  method: "PUT",
  headers,
  body: JSON.stringify({ is_active: false }),
});

import os, requests

resp = requests.put(
    "https://api.keebai.com/v1/functions/6650cccc3333dddd4444eeee",
    headers={"Authorization": f"Bearer {os.environ['KEEBAI_API_TOKEN']}"},
    json={
        "context": {
            "url": "https://erp.example.com/v2/stock/{{sku}}",
            "method": "GET",
            "timeout": 10,
        }
    },
    timeout=10,
)
if resp.status_code == 400 and resp.json()["error"]["code"] == "FUNCTION_MASKED_VALUE_WRITE":
    ...  # you echoed a *** back; send the real value or omit the field
resp.raise_for_status()

Response

200 OK

The function, same shape as GET /v1/functions/{id}.

400 Bad Request

A field over its limit or an unknown property, plus three specific codes:

FUNCTION_MASKED_VALUE_WRITE — a headers or params value was the literal ***. details.field and details.keys name them.
FUNCTION_URL_NOT_ALLOWED — the URL failed validation. details.reason names the rule.
FUNCTION_TIMEOUT_NOT_ALLOWED — timeout outside 1–30 seconds.

401 Unauthorized

Missing, invalid, revoked, or expired token.

403 Forbidden

The token does not have the assistants:write scope.

404 Not Found

No webhook function with that id in the token’s company.

409 Conflict

The new name is already taken by another function in the company.

502 Bad Gateway

The assistant service is unreachable.

Operational notes

context is replace-within-merge. Fields you omit inside context — method, timeout, body, response_path — go back to their defaults, not to their stored values. Only headers and params are preserved on omission, because they are the ones you cannot read back. Send the whole context you want, minus the secrets.
Updates are read-modify-write, so concurrent writers lose each other. Merging the stored secrets requires reading them first; two overlapping updates to one function leave whichever finished last. Serialise them.
The URL is only re-validated when you send context. A function created before a validation rule existed keeps working until you next touch its URL.
Renaming breaks nothing immediately but changes what the model calls. Blocks reference the function by id, not by name, so the binding survives — but any prompt text mentioning the old name is now wrong.
tool_params and tags replace, they do not append. Read the current values first if you mean to add one.

Authorizations

Authorization

string

header

required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Path Parameters

string

required

Body

application/json

name

string

Maximum string length: 100

display_name

string

Maximum string length: 200

description

string

Maximum string length: 1000

context

object

Show child attributes

tool_params

object[]

Maximum array length: 30

Show child attributes

Response

200 - application/json

function

object

required

Show child attributes

POST functions DELETE functions/:id

Get started

Assistants

Assistant blocks

Block catalogue

Create a block

Block content

Versions

Functions

Reference

PUT /v1/functions/{id}

Endpoint

Required scope

Headers

Path parameters

Body

Example request

Response

200 OK

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

409 Conflict

502 Bad Gateway

Operational notes

Authorizations

Path Parameters

Body

Response

​Endpoint

​Required scope

​Headers

​Path parameters

​Body

​Example request

​Response

​200 OK

​400 Bad Request

​401 Unauthorized

​403 Forbidden

​404 Not Found

​409 Conflict

​502 Bad Gateway

​Operational notes

Authorizations

Path Parameters

Body

Response

Endpoint

Required scope

Headers

Path parameters

Body

Example request

Response

200 OK

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

409 Conflict

502 Bad Gateway

Operational notes