Create setup token (legacy alias)

Default lifetime is 10 minutes and default limit is one device. Setup credentials can only attach devices; attachment does not grant function access.

POST/v1/sdk-tokens

Authorization

AuthorizationBearer token (Clerk owner session) · headerrequired

Owner identity required.

Request body

requiredapplication/json

namestringrequired

min length 1 · max length 64

ttlSecondsinteger

min 60 · max 86400 · default: 600

deviceLimitinteger

min 1 · max 20 · default: 1

Responses

201

Created; setup token is returned once

dataNewConnectionrequired

Show properties

idstring<uuid>required

principalstringrequired

namestringrequired

expiresAtinteger | nullrequired

revokedbooleanrequired

accessstringrequired

Allowed:readact

oauthobject

Show properties

applicationIdstringrequired

clientIdstringrequired

redirectUrisstring<uri>[]required

publicbooleanrequired

purposestringrequired

Allowed:agentdevice-setup

canAttachbooleanrequired

deviceLimitintegerrequired

attachedDeviceCountinteger

tokenstringrequired

Returned once. Store securely; never log or commit.

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

Bodyapplication/json

namestring*ttlSecondsintegerdeviceLimitinteger

Request

curl -X POST 'https://www.openlaunch.dev/v1/sdk-tokens' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "bench device",
  "ttlSeconds": 600,
  "deviceLimit": 1
}'

const response: Response = await fetch("https://www.openlaunch.dev/v1/sdk-tokens", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"bench device\",\n  \"ttlSeconds\": 600,\n  \"deviceLimit\": 1\n}"
});

import requests

response = requests.post(
    "https://www.openlaunch.dev/v1/sdk-tokens",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"name\": \"bench device\",\n  \"ttlSeconds\": 600,\n  \"deviceLimit\": 1\n}",
)

package main

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

func main() {
	body := strings.NewReader("{\n  \"name\": \"bench device\",\n  \"ttlSeconds\": 600,\n  \"deviceLimit\": 1\n}")
	req, err := http.NewRequest("POST", "https://www.openlaunch.dev/v1/sdk-tokens", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer YOUR_TOKEN")
	req.Header.Set("Content-Type", "application/json")

	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": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "principal": "string",
    "name": "string",
    "expiresAt": 0,
    "revoked": true,
    "access": "read",
    "oauth": {
      "applicationId": "string",
      "clientId": "string",
      "redirectUris": [
        "http://example.com"
      ],
      "public": true
    },
    "purpose": "agent",
    "canAttach": true,
    "deviceLimit": 0,
    "attachedDeviceCount": 0,
    "token": "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"
      }
    ]
  }
}