List callable functions

Returns built-in and custom functions the caller currently has grants to invoke; owner sees available workspace functions. Every invocation is checked again against current grants and device argument schema.

GET/v1/functions

Authorization

AuthorizationBearer token (Clerk owner session) · headerrequired

Owner identity required.

AuthorizationBearer token (ol_agent token) · headerrequired

Owner-issued agent API connection; access ceiling and live device grants are checked separately.

AuthorizationBearer token (OAuth access token) · headerrequired

OAuth read/act scope is a ceiling. Scopes do not create device grants.

Responses

200

Successful response

dataFunction[]required

Show properties

Array of Function

deviceIdstring<uuid>required

deviceNamestringrequired

kindstringrequired

definitionFunctionDefinitionrequired

Show properties

namestringrequired

min length 1 · max length 64 · matches ^[a-z][a-z0-9_]*(?:\.[a-z][a-z0-9_]*)*$

titlestringrequired

min length 1 · max length 64

descriptionstringrequired

min length 1 · max length 240

accessstringrequired

Allowed:readwrite

inputSchemaobjectrequired

Show properties

typestringrequired

propertiesobjectrequired

requiredstring[]required

max items 16

additionalPropertiesbooleanrequired

guidestringrequired

400

Invalid request or validation failure

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

401

Missing or invalid credential

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

403

Insufficient access or grant

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

404

Resource not found

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

413

Request body exceeds the 16 KiB limit

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

429

Rate limit or workspace capacity limit

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

500

Internal error

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

503

Service or required integration is not configured

errorobjectrequired

Show properties

codestringrequired

messagestring

issuesobject[]

Show properties

Array of object

pathstring

messagestring

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (Clerk owner session)Remember on this deviceInclude my values in samples

Request

ol functions list

import { createClient } from "@openlaunch/sdk";
const agent = createClient({ url: process.env.OPENLAUNCH_URL ?? "https://www.openlaunch.dev", token: process.env.OPENLAUNCH_AGENT_TOKEN! });
const functions = await agent.listFunctions();

curl -X GET 'https://www.openlaunch.dev/v1/functions' \
  -H 'Authorization: Bearer YOUR_TOKEN'

const response: Response = await fetch("https://www.openlaunch.dev/v1/functions", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://www.openlaunch.dev/v1/functions",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

package main

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

func main() {
	req, err := http.NewRequest("GET", "https://www.openlaunch.dev/v1/functions", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_TOKEN")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

Response

{
  "data": [
    {
      "deviceId": "4de4adb9-21ee-47e3-aeb4-8cf8ed6c109a",
      "deviceName": "string",
      "kind": "string",
      "definition": {
        "name": "string",
        "title": "string",
        "description": "string",
        "access": "read",
        "inputSchema": {
          "type": "object",
          "properties": {
            "property1": {
              "type": "string",
              "description": "string",
              "minLength": 0,
              "maxLength": 0,
              "enum": [
                "string"
              ]
            },
            "property2": {
              "type": "string",
              "description": "string",
              "minLength": 0,
              "maxLength": 0,
              "enum": [
                "string"
              ]
            }
          },
          "required": [
            "string"
          ],
          "additionalProperties": false
        }
      },
      "guide": "string"
    }
  ]
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "path": "string",
        "message": "string"
      }
    ]
  }
}