Skip to content

Function routes: update, delete

The Function Verbs update, delete as api.sb routes, with inputs, result, refusals and an example.

Reference for Function, one group of Function routes.

Function.update

Changes the given properties of a Function. Verb page.

Text
PATCH /{namespace}/functions/{id}

Path: id. Body, as JSON: the other inputs. Emits Function.updated.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Function.
kindstringOne of code, generative, agentic, or human.
cascadestring[]Kinds tried in order when one declines, such as code, then a Human.
instructionstextFor a generative or agentic Function, what it does and how.
modelstringFor a generative or agentic Function, the model it runs on.
toolslist of VerbFor an agentic Function, the Verbs it may call; Permissions and Limits apply to each.
maxStepsintegerFor an agentic Function, the most steps one Action may take.
budgetmoneyThe most one Action may spend; the Mandate’s Limits apply as well.
roleRoleFor a human Function, the Role its Tasks go to.
formjsonFor a human Function, the form; generated from the Verb’s inputs and outputs when absent.
slastringFor a human Function, how long a Task may wait, as an ISO 8601 duration.
escalateToRoleFor a human Function, the Role a Task moves to when the service level passes.

Returns

OutputTypeRequiredDescription
functionFunctionrequiredThe Function.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
curl -X PATCH https://api.sb/leaseline.app/functions/function_6nvaxFYImd \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"code"}'
JSON
{
  "api": "https://api.sb/leaseline.app",
  "function": {
    "$id": "https://api.sb/leaseline.app/functions/function_6nvaxFYImd",
    "$type": "Function",
    "kind": "code"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "Function.update",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}

Function.delete

Deletes a Function: a soft delete that keeps its history, undone by Thing.restore. Verb page.

Text
DELETE /{namespace}/functions/{id}

Path: id. Emits Function.deleted.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Function.

Returns

OutputTypeRequiredDescription
functionFunctionrequiredThe Function.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
curl -X DELETE https://api.sb/leaseline.app/functions/function_6nvaxFYImd \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"
JSON
{
  "api": "https://api.sb/leaseline.app",
  "function": {
    "$id": "https://api.sb/leaseline.app/functions/function_6nvaxFYImd",
    "$type": "Function",
    "kind": "code"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "Function.delete",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}