Add a tool endpoint

Adds a route you serve and starts a sync. Sending the same URL again re-syncs that endpoint. A different URL adds another endpoint. Tool calls use signing material derived from a Median key, so this creates no second credential.

Called with a Median key, the endpoint is signed with that key. Called with an OAuth token, it keeps the key it already had, or takes the newest key. An OAuth token needs an admin or owner. Adding or re-pointing an endpoint does not count against the sync limit.

curl -X PUT "https://api.median.sh/v1/tool-endpoints" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://example.com/api/median/tools"
}'

const response = await fetch("https://api.median.sh/v1/tool-endpoints", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "url": "https://example.com/api/median/tools"
})
});

{
  "ok": true,
  "id": "k170abc123"
}

{
  "error": {
    "code": "invalid_url",
    "message": "Use an HTTPS URL, or HTTP on localhost for testing."
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "That Median key does not match any organization. Copy the median_key_ key again from Settings under API."
  }
}

{
  "error": {
    "code": "string",
    "message": "string"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Your organization's API allowance is temporarily full. Please retry shortly."
  }
}