Xano

https://docs.xano.com
Admin
Xano is a visual-first unified backend that provides data, APIs, logic, authentication, queues, and...
Tokens:991,914
Snippets:7,600
Trust Score:10
Update:2 days ago
Show doc for...
Tokens:
Raw
### cli_docs examples

Source: https://docs.xano.com/developer-mcp/tools

Example calls to the cli_docs tool for getting started, integration guidance, and workspace commands.

```javascript
// Get started
cli_docs({ topic: "start" })

// When to use CLI vs Meta API
cli_docs({ topic: "integration" })

// Full workspace commands
cli_docs({ topic: "workspace", detail_level: "detailed" })
```

--------------------------------

### run_api_docs examples

Source: https://docs.xano.com/developer-mcp/tools

Example calls to the run_api_docs tool for getting started, full execution docs, and session examples.

```javascript
// Get started
run_api_docs({ topic: "start" })

// Full execution docs
run_api_docs({ topic: "run", detail_level: "detailed" })

// Session examples
run_api_docs({ topic: "session", detail_level: "examples" })
```

--------------------------------

### Go example to retrieve workspace details

Source: https://docs.xano.com/api-reference/workspace/retrieve-detailed-information-about-a-specific-workspace

Go example using net/http to GET workspace details. Replace {workspace_id} and <token> as needed.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### xano static_host build get examples

Source: https://docs.xano.com/xano-cli/command-reference

Gets build details for a static host. Requires --build_id.

```bash
xano static_host build get my-site --build_id 52
xano static_host build get my-site --build_id 52 -o json
```

--------------------------------

### Go example to retrieve table details

Source: https://docs.xano.com/api-reference/table/retrieve-detailed-information-for-a-specific-table

Go example using net/http to GET table details. Prints the response body.

```Go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/table/{table_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### Go example to retrieve a tool by ID

Source: https://docs.xano.com/api-reference/tool/retrieve-a-specific-tool-by-id

Go example using net/http to GET a tool by ID. Prints the response body.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/tool/{tool_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### meta_api_docs usage examples

Source: https://docs.xano.com/developer-mcp/tools

Shows how to call meta_api_docs with different topics and options. The first call retrieves getting-started docs, the second gets detailed table management docs, the third gets API examples without schemas, and the fourth retrieves workflow guides.

```javascript
// Get started
meta_api_docs({ topic: "start" })

// Full table management docs
meta_api_docs({ topic: "table", detail_level: "detailed" })

// API examples without schemas
meta_api_docs({ topic: "api", detail_level: "examples", include_schemas: false })

// Workflow guides
meta_api_docs({ topic: "workflows" })
```

--------------------------------

### Go example to retrieve all branches

Source: https://docs.xano.com/api-reference/branch/retrieve-all-branches-in-a-workspace

Go example using net/http to GET all branches. Requires a bearer token.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/branch"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### Go example to retrieve a workspace addon

Source: https://docs.xano.com/api-reference/addon/retrieve-a-workspace-addon

Go example using net/http to GET the workspace addon. Replace the URL and token. Prints the response body.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/addon/{addon_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### Go example for middleware history

Source: https://docs.xano.com/api-reference/request-history/retrieve-middleware-request-history

Go example using net/http to GET middleware history. Replace the URL and token as needed.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/middleware_history"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### xano static_host get examples

Source: https://docs.xano.com/xano-cli/command-reference

Gets details for a single static host, including description, git config, and dev/prod URLs. Supports JSON output.

```bash
xano static_host get marketing
xano static_host get marketing -w 40 -o json
```

--------------------------------

### xano static_host create examples

Source: https://docs.xano.com/xano-cli/command-reference

Creates a new static host. Optionally set a description and workspace ID.

```bash
xano static_host create marketing
xano static_host create marketing --description "Marketing site" -w 40
```

--------------------------------

### Build and push frontend with static hosting

Source: https://docs.xano.com/xano-cli/guide-from-scratch

Build your frontend and push the output directory to Xano static hosting. The CLI zips it for you, deploying your frontend alongside your Xano backend.

```bash
xano static_host build push
```

--------------------------------

### get filter examples

Source: https://docs.xano.com/xanoscript/filter-reference/manipulation

The get filter retrieves a value from an object by key, with an optional default. Examples show retrieving 'name' and returning 'unknown' when missing.

```xanoscript
{"name":"John"}|get:"name":"unknown"     // Returns "John"
{}|get:"name":"unknown"                  // Returns "unknown"
```

--------------------------------

### xano static_host build list examples

Source: https://docs.xano.com/xano-cli/command-reference

Lists all builds for a static host. Supports pagination and JSON output.

```bash
xano static_host build list my-site
xano static_host build list my-site -w 40 -o json
```

--------------------------------

### Go example to retrieve workspace files

Source: https://docs.xano.com/api-reference/file/retrieve-workspace-files

Go example using net/http to retrieve workspace files. Prints the response body.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/file"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### Prompt for AI Coding Agent to Set Up Xano Development Workflow

Source: https://docs.xano.com/vs-code-deprecation

Paste this prompt into your AI coding agent to handle the setup for the new Xano development workflow. It directs the agent to access Xano's Get Started prompt at the provided URL.

```text
Access Xano's Get Started prompt at https://go.xano.co/start-xano-skill. It will walk us through installing the Xano Developer Tools and the Xano development workflow.
```

--------------------------------

### return function example with $api_response

Source: https://docs.xano.com/xanoscript/function-reference/utility-functions

Example returning a value from an API response using the get method.

```xanoscript
return {
  value = $api_response|get:"data"
}
```

--------------------------------

### Go example to retrieve all tables

Source: https://docs.xano.com/api-reference/table/retrieve-all-tables-in-a-workspace

Uses net/http to send a GET request with Bearer token authentication and prints the response body.

```Go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/table"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### Ruby example to retrieve all branches

Source: https://docs.xano.com/api-reference/branch/retrieve-all-branches-in-a-workspace

Ruby example using net/http to GET all branches. Requires a bearer token.

```ruby
require 'uri'
require 'net/http'

url = URI("https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/branch")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

--------------------------------

### xano static_host deploy examples

Source: https://docs.xano.com/xano-cli/command-reference

Promote a build to a host environment. Requires --build_id and --env.

```bash
xano static_host deploy my-site --build_id 52 --env dev
xano static_host deploy my-site --build_id 52 --env prod
```

--------------------------------

### Go example to create a branch

Source: https://docs.xano.com/api-reference/branch/create-a-new-branch-by-cloning-an-existing-branch

Uses net/http to POST the JSON payload. Prints the response body.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/branch"

	payload := strings.NewReader("{\n  \"source_branch\": \"v1\",\n  \"label\": \"feature-branch\",\n  \"description\": \"A new feature branch\",\n  \"color\": \"#ebc346\"\n}")

	req, _ := http.NewRequest("POST", 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))

}

```

--------------------------------

### Parameter examples for instructions, tags, and tools

Source: https://docs.xano.com/xanoscript/mcp-servers

Examples of the `instructions`, `tags`, and `tools` parameters as shown in the parameter definition table. These illustrate the expected format for each parameter.

```XanoScript
instructions = "This MCP server is designed to handle basic database operations, such as retrieving, updating, adding, and deleting records. Process user queries with the available tools to complete their request to the best of your ability. Do not assume anything about the operation the user is requesting; ask for clarification before execution if necessary."
```

```XanoScript
tags = ["database"]
```

```XanoScript
tools = [{name: "get_user_record"}]
```

--------------------------------

### Java Unirest example to retrieve all branches

Source: https://docs.xano.com/api-reference/branch/retrieve-all-branches-in-a-workspace

Java example using Unirest to GET all branches. Requires a bearer token.

```java
HttpResponse<String> response = Unirest.get("https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/branch")
  .header("Authorization", "Bearer <token>")
  .asString();
```

--------------------------------

### PHP cURL example to retrieve all branches

Source: https://docs.xano.com/api-reference/branch/retrieve-all-branches-in-a-workspace

PHP example using cURL to GET all branches. Requires a bearer token.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/branch",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

--------------------------------

### JavaScript fetch example to retrieve all branches

Source: https://docs.xano.com/api-reference/branch/retrieve-all-branches-in-a-workspace

JavaScript example using fetch to GET all branches. Requires a bearer token.

```javascript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/branch', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

--------------------------------

### Go example to retrieve all workspace triggers

Source: https://docs.xano.com/api-reference/workspace-trigger/retrieve-all-workspace-triggers

Uses the net/http package to send a GET request. Requires a bearer token. Prints the response body.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/trigger"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### Ruby example to retrieve table details

Source: https://docs.xano.com/api-reference/table/retrieve-detailed-information-for-a-specific-table

Ruby example using net/http to GET table details. Prints the response body.

```Ruby
require 'uri'
require 'net/http'

url = URI("https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/table/{table_id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

--------------------------------

### Go example for updating addon security settings

Source: https://docs.xano.com/api-reference/addon/update-addon-security-settings

Go example using net/http to send a PUT request. It constructs the payload as a string reader, sets headers, and prints the response body.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/addon/{addon_id}/security"

	payload := strings.NewReader("{\n  \"guid\": \"<string>\",\n  \"include_xanoscript\": 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))

}
```

--------------------------------

### Python requests example to retrieve all branches

Source: https://docs.xano.com/api-reference/branch/retrieve-all-branches-in-a-workspace

Python example using the requests library to GET all branches. Requires a bearer token.

```python
import requests

url = "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/branch"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

--------------------------------

### Go example to create a tool using XanoScript

Source: https://docs.xano.com/api-reference/tool/create-a-new-tool-using-xanoscript

Uses the net/http package to POST a XanoScript payload to the tool creation endpoint. Requires a Bearer token and Content-Type header.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/tool"

	payload := strings.NewReader("tool foo {\n  input {\n    int score\n  }\n  stack {\n    var $x1 {\n      value = $input.score + 1\n    }\n  }\n  response = $x1\n}\n")

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

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "text/x-xanoscript")

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

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

	fmt.Println(string(body))

}

```

--------------------------------

### Ruby example to retrieve a tool by ID

Source: https://docs.xano.com/api-reference/tool/retrieve-a-specific-tool-by-id

Ruby example using Net::HTTP to GET a tool by ID. Prints the response body.

```ruby
require 'uri'
require 'net/http'

url = URI("https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/tool/{tool_id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

--------------------------------

### xano tenant snapshot list example

Source: https://docs.xano.com/xano-cli/command-reference

Lists a tenant's snapshots. Snapshots are tagged ORIGINAL (initial database) and LIVE (currently served database).

```bash
xano tenant snapshot list t1234-abcd-xyz1
```

--------------------------------

### Java Unirest example to retrieve a tool by ID

Source: https://docs.xano.com/api-reference/tool/retrieve-a-specific-tool-by-id

Java example using Unirest to GET a tool by ID. Returns the response as a string.

```java
HttpResponse<String> response = Unirest.get("https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/tool/{tool_id}")
  .header("Authorization", "Bearer <token>")
  .asString();
```

--------------------------------

### Go example for updating static hosting environment

Source: https://docs.xano.com/api-reference/static-host/update-static-hosting-environment

Uses the net/http package to POST to the endpoint. The payload is an empty JSON string, and the response body is printed.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/static_host/{static_host}/build/{build_id}/env"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", 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))

}
```

--------------------------------

### Java Unirest example to retrieve table details

Source: https://docs.xano.com/api-reference/table/retrieve-detailed-information-for-a-specific-table

Java example using Unirest to GET table details. Returns the response as a string.

```Java
HttpResponse<String> response = Unirest.get("https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/table/{table_id}")
  .header("Authorization", "Bearer <token>")
  .asString();
```

--------------------------------

### Example with environment variable and dynamic path

Source: https://docs.xano.com/xanoscript/function-reference/cloud-services/google-cloud-storage

Practical example using $env.GCP_SERVICE_ACCOUNT for the service account, a static bucket name, and a dynamic filePath built with add. Retrieves object metadata and aliases the result as file_metadata.

```xanoscript
cloud.google.storage.get_file_info {
  service_account = $env.GCP_SERVICE_ACCOUNT
  bucket = "media-files"
  filePath = "videos/"|add:$video.id
} as file_metadata
```

--------------------------------

### Go example to create a table reference column

Source: https://docs.xano.com/api-reference/table-schema-type/create-a-table-reference-column

Uses Go's net/http to send a POST request with a JSON payload. Prints the response body.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/table/{table_id}/schema/type/tableref"

	payload := strings.NewReader("{\n  \"name\": \"user_id\",\n  \"tableref_id\": 101\n}")

	req, _ := http.NewRequest("POST", 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))

}
```

--------------------------------

### Ruby example for middleware history

Source: https://docs.xano.com/api-reference/request-history/retrieve-middleware-request-history

Ruby example using Net::HTTP to GET middleware history. Replace the URL and token as needed.

```ruby
require 'uri'
require 'net/http'

url = URI("https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/middleware_history")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

--------------------------------

### Go example

Source: https://docs.xano.com/api-reference/api-group-api/generate-openapi-specification-for-a-specific-api-endpoint

Uses net/http to send a GET request with the Authorization header. Prints the response body.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/apigroup/{apigroup_id}/api/{api_id}/openapi"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### Java Unirest example for middleware history

Source: https://docs.xano.com/api-reference/request-history/retrieve-middleware-request-history

Java example using Unirest to GET middleware history. Replace the URL and token as needed.

```java
HttpResponse<String> response = Unirest.get("https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/middleware_history")
  .header("Authorization", "Bearer <token>")
  .asString();
```

--------------------------------

### Go example to retrieve all MCP servers

Source: https://docs.xano.com/api-reference/mcp-server/retrieve-all-mcp-servers-in-a-workspace

Uses net/http to send a GET request with Bearer authentication and prints the response body.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/mcp_server"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### PHP cURL example for middleware history

Source: https://docs.xano.com/api-reference/request-history/retrieve-middleware-request-history

PHP example using cURL to GET middleware history. Replace the URL and token as needed.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/middleware_history",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

--------------------------------

### Go example for retrieving workflow tests

Source: https://docs.xano.com/api-reference/workflow_test/retrieve-all-workflow-tests

Uses net/http to send a GET request with an Authorization header and prints the response body.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/workflow_test"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### JavaScript fetch example for middleware history

Source: https://docs.xano.com/api-reference/request-history/retrieve-middleware-request-history

JavaScript example using fetch to GET middleware history. Replace the URL and token as needed.

```javascript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/middleware_history', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

--------------------------------

### Full URL example

Source: https://docs.xano.com/the-function-stack/functions/file-storage

Example of a complete URL formed by prepending the Xano instance URL to the path from the metadata.

```text
https://my-xano-instance.xano.io/vault/T3q1DKy7/MA_gz1v6HaNQnLEf6xZqVtrOVII/1Rl7QA../form_submission_1741703680742.pdf
```

--------------------------------

### Ruby example to retrieve an agent trigger by ID

Source: https://docs.xano.com/api-reference/agent-trigger/retrieve-an-agent-trigger-by-id

Ruby example using net/http to perform a GET request. Prints the response body.

```Ruby
require 'uri'
require 'net/http'

url = URI("https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/agent/trigger/{trigger_id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

--------------------------------

### db.set_datasource - Example with Staging

Source: https://docs.xano.com/xanoscript/function-reference/utility-functions

Example that switches the active datasource to 'staging'.

```xanoscript
db.set_datasource {
  value = "staging"
}
```

--------------------------------

### Go example to retrieve an agent trigger by ID

Source: https://docs.xano.com/api-reference/agent-trigger/retrieve-an-agent-trigger-by-id

Go example using net/http to perform a GET request. Prints the response body.

```Go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/agent/trigger/{trigger_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}
```

--------------------------------

### Azure Blob Storage: Get File Metadata - Example

Source: https://docs.xano.com/xanoscript/function-reference/cloud-services/azure-blob-storage

Example using environment variables and dynamic file path. Retrieves metadata into `file_metadata`.

```xanoscript
cloud.azure.storage.get_file_info {
  account_name = $env.AZURE_ACCOUNT_NAME
  account_key = $env.AZURE_ACCOUNT_KEY
  container_name = "archives"
  filePath = "backup/"|add:$file.name
} as file_metadata
```

--------------------------------

### Go example for bulk content creation

Source: https://docs.xano.com/api-reference/table-content/create-multiple-records-in-a-single-batch-operation

Uses net/http to send a POST request with a JSON payload to the bulk endpoint. Sets Authorization and Content-Type headers, reads the response body, and prints it.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/table/{table_id}/content/bulk"

	payload := strings.NewReader("{\n  \"items\": [\n    {\n      \"name\": \"test name\"\n    }\n  ],\n  \"allow_id_field\": false\n}")

	req, _ := http.NewRequest("POST", 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))

}
```

--------------------------------

### xano release deploy examples

Source: https://docs.xano.com/xano-cli/command-reference

Deploys a release to a new branch. The first example deploys with default settings. The second forces deployment. The third deploys to a specific branch and sets it live. The fourth specifies workspace and JSON output with force.

```bash
xano release deploy "v1.0"
xano release deploy "v1.0" --force
xano release deploy "v1.0" -b "restore-v1" --set_live
xano release deploy "v1.0" -w 40 -o json --force
```

--------------------------------

### Ruby example to retrieve workspace details

Source: https://docs.xano.com/api-reference/workspace/retrieve-detailed-information-about-a-specific-workspace

Ruby example using Net::HTTP to GET workspace details. Replace {workspace_id} and <token> as needed.

```ruby
require 'uri'
require 'net/http'

url = URI("https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

--------------------------------

### Go example to retrieve agent by ID

Source: https://docs.xano.com/api-reference/agent/retrieve-a-specific-agent-by-id

Go example using net/http. Requires a valid Bearer token and the workspace and agent IDs.

```go
package main

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

func main() {

	url := "https://your-xano-instance.xano.io/api:meta/workspace/{workspace_id}/agent/{agent_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}
```
Tokens:
Raw