Veryfront

https://veryfront.com/docs
Admin
Veryfront is a platform for building, running, and operating AI apps and agents, providing a...
Tokens:2,864,714
Snippets:14,577
Trust Score:7.7
Update:3 weeks ago
Show doc for...
Tokens:
Raw
### Go example for get release asset manifest

Source: https://veryfront.com/docs/cloud/rest/api-reference/releases-and-asset-manifests/get-release-asset-manifest

Go example using net/http to GET the asset manifest. Prints the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/releases/{version}/asset-manifest"

	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

Source: https://veryfront.com/docs/cloud/rest/api-reference/branch-files/list-branch-file-versions

Go example using net/http to GET branch file versions. Prints the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/branches/{branchName}/files/{filePath}/versions"

	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 get integration

Source: https://veryfront.com/docs/cloud/rest/api-reference/integration-catalog/get-integration

Uses the net/http package to GET an integration and prints the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/integrations/{name}"

	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))

}
```

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

### 200 response schema for get integration

Source: https://veryfront.com/docs/cloud/rest/api-reference/integration-catalog/get-integration

Example JSON response body returned on success (HTTP 200). Shows the structure of an integration object including auth, credential requirements, tools, and setup guide.

```json
{
  "name": "<string>",
  "display_name": "<string>",
  "icon": "<string>",
  "description": "<string>",
  "auth": {
    "type": "oauth2",
    "provider": "<string>",
    "authorization_url": "<string>",
    "token_url": "<string>",
    "scopes": [
      "<string>"
    ],
    "optional_scopes": [
      "<string>"
    ],
    "callback_path": "<string>",
    "required_apis": [
      {
        "name": "<string>",
        "enable_url": "<string>"
      }
    ]
  },
  "credential_env_var_names": [
    "VERCEL_TOKEN"
  ],
  "credential_requirement": {
    "mode": "oauth_connection",
    "managed_oauth": true,
    "byo_oauth_app_override": {
      "supported": true,
      "required": true,
      "client_id_env_var": "<string>",
      "client_secret_env_var": "<string>"
    },
    "mandatory_env_vars": [
      "<string>"
    ]
  },
  "env_vars": [
    {
      "name": "<string>",
      "description": "<string>",
      "required": true,
      "sensitive": true,
      "default": "<string>",
      "docs_url": "<string>"
    }
  ],
  "tools": [
    {
      "id": "<string>",
      "name": "<string>",
      "description": "<string>",
      "requires_write": true
    }
  ],
  "project_connections": {
    "connected": 1,
    "expired": 1,
    "disconnected": 1
  },
  "project_user_connections": {
    "connected": 1,
    "expired": 1,
    "disconnected": 1
  },
  "icon_url": "<string>",
  "prompts": [
    {
      "id": "<string>",
      "title": "<string>",
      "prompt": "<string>",
      "category": "<string>",
      "icon": "<string>"
    }
  ],
  "suggested_with": [
    "<string>"
  ],
  "config_schema": {
    "version": 1,
    "fields": [
      {
        "key": "<string>",
        "type": "select",
        "label": "<string>",
        "description": "<string>",
        "default": "<unknown>",
        "options": [
          {
            "value": "<string>",
            "label": "<string>",
            "description": "<string>"
          }
        ],
        "min": 123,
        "max": 123,
        "step": 123
      }
    ]
  },
  "setup_guide": {
    "steps": [
      {
        "title": "<string>",
        "description": "<string>",
        "step": 123,
        "url": "<string>",
        "docs_url": "<string>",
        "code": "<string>"
      }
    ],
    "title": "<string>",
    "notes": [
      "<string>"
    ],
    "documentation": "<string>"
  }
}
```

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

### Go example for listing project files

Source: https://veryfront.com/docs/cloud/rest/api-reference/project-files/list-project-files

Uses net/http to create a GET request with an Authorization header and prints the response body. Ignores errors for brevity.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/files?limit=20&sort_by=updated_at&sort_order=desc"

	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 listing provider files

Source: https://veryfront.com/docs/cloud/rest/api-reference/connected-storage/list-provider-files

Go example using net/http to GET /providers/{provider}/files. Prints the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/providers/{provider}/files"

	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))

}
```

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

### Install shared project guide with --target agents

Source: https://veryfront.com/docs/code/getting-started/installation

Installs the shared project guide (AGENTS.md) for older projects that do not include starter templates. After installation, run `veryfront dev` to start the dev server and MCP server.

```bash
veryfront install --target agents

```

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

### Go example for installing agent

Source: https://veryfront.com/docs/cloud/rest/api-reference/project-agents/install-agent-for-selected-projects

Ues net/http to send a POST request with the JSON payload. Prints the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/agents/{agent_id}/install-selected"

	payload := strings.NewReader("{\n  \"selected_project_references\": [\n    \"<string>\"\n  ],\n  \"selected_project_ids\": [\n    \"<string>\"\n  ],\n  \"relation\": \"editor\"\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))

}

```

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

### 200 response for GET /agent-templates

Source: https://veryfront.com/docs/cloud/rest/api-reference/agent-templates/browse-agent-templates

Example 200 response body for the GET /agent-templates endpoint. Contains a paginated list of agent templates with fields such as id, name, description, provider, installability, and card details.

```json
{
  "items": [
    {
      "id": "<string>",
      "agent_id": "<string>",
      "kind": "template_agent",
      "name": "<string>",
      "description": "<string>",
      "category_id": "<string>",
      "category_label": "<string>",
      "provider_name": "<string>",
      "provider_url": "<string>",
      "version": "<string>",
      "actions": [
        "fork"
      ],
      "avatar_url": "<string>",
      "model": "<string>",
      "tools": [
        "<string>"
      ],
      "suggestions": [
        "<string>"
      ],
      "template_project": {
        "name": "<string>",
        "project_reference": "<string>",
        "source_path": "<string>"
      },
      "installability": {
        "status": "installable",
        "reason": "<string>"
      },
      "origin": "veryfront",
      "runtime_mode": "push_service",
      "runtime_service_key": "<string>",
      "environment_scope": "development",
      "card": {
        "id": "<string>",
        "name": "<string>",
        "description": "<string>",
        "provider": {
          "name": "<string>",
          "url": "<string>"
        },
        "version": "<string>",
        "runtime_mode": "push_service",
        "runtime_service_key": "<string>",
        "default_input_modes": [
          "<string>"
        ],
        "default_output_modes": [
          "<string>"
        ],
        "skills": [
          {
            "id": "<string>",
            "name": "<string>",
            "description": "<string>"
          }
        ],
        "tools": [
          "<string>"
        ]
      }
    }
  ],
  "total": 123,
  "has_more": true,
  "next_offset": 123
}
```

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

### Go example to list environments

Source: https://veryfront.com/docs/cloud/rest/api-reference/project-environments/list-environments

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

```go
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/environments?limit=20&sort_by=name&sort_order=asc"

	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))

}
```

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

### Python requests example for public MCP tool detail

Source: https://veryfront.com/docs/cloud/rest/api-reference/mcp-discovery/get-public-mcp-tool-detail

Uses the requests library to perform a GET request to the same endpoint. Prints the response text. Requires the requests library to be installed.

```python
import requests

url = "https://api.veryfront.com/mcp/tools/{tool_name}?tool_names=canonical"

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

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

print(response.text)
```

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

### Install AGENTS.md guide with veryfront install --target agents

Source: https://veryfront.com/docs/code/guides/coding-agents

Installs the AGENTS.md guide for coding agents in older projects. Run this command at the project root.

```bash
veryfront install --target agents
```

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

### Go example for listing project integrations

Source: https://veryfront.com/docs/cloud/rest/api-reference/project-integrations/list-project-integrations

Uses the net/http package to send a GET request to the list integrations endpoint. Prints the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/integrations?sort_by=name&sort_order=asc"

	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 for get release asset manifest

Source: https://veryfront.com/docs/cloud/rest/api-reference/releases-and-asset-manifests/get-release-asset-manifest

Ruby example using net/http to GET the asset manifest. Prints the response body.

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

url = URI("https://api.veryfront.com/projects/{project_reference}/releases/{version}/asset-manifest")

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 listing integration connections

Source: https://veryfront.com/docs/cloud/rest/api-reference/integration-catalog/list-integration-connections

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

```go
package main

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

func main() {

	url := "https://api.veryfront.com/integrations/{name}/connections?limit=20&sort_by=project&sort_order=asc"

	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 get release asset manifest

Source: https://veryfront.com/docs/cloud/rest/api-reference/releases-and-asset-manifests/get-release-asset-manifest

Java example using Unirest to GET the asset manifest. Returns an HttpResponse<String>.

```java
HttpResponse<String> response = Unirest.get("https://api.veryfront.com/projects/{project_reference}/releases/{version}/asset-manifest")
  .header("Authorization", "Bearer <token>")
  .asString();
```

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

### Go: Create Account

Source: https://veryfront.com/docs/cloud/rest/api-reference/accounts-and-memberships/create-account

Go example using the standard library to make a POST request to create an account.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/accounts"

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

}

```

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

### PHP cURL example for get release asset manifest

Source: https://veryfront.com/docs/cloud/rest/api-reference/releases-and-asset-manifests/get-release-asset-manifest

PHP example using cURL to GET the asset manifest. Handles errors and prints the response body.

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.veryfront.com/projects/{project_reference}/releases/{version}/asset-manifest",
  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 to list sandbox sessions

Source: https://veryfront.com/docs/cloud/rest/api-reference/sandbox/list-sandbox-sessions

Uses the net/http package to send a GET request with the same URL and authorization header. Reads and prints the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/sandbox-sessions?limit=20&sort_by=created_at&sort_order=desc"

	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 get release asset manifest

Source: https://veryfront.com/docs/cloud/rest/api-reference/releases-and-asset-manifests/get-release-asset-manifest

JavaScript example using fetch to GET the asset manifest. Logs the JSON response or an error to the console.

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

fetch('https://api.veryfront.com/projects/{project_reference}/releases/{version}/asset-manifest', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

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

### Go example for listing tools

Source: https://veryfront.com/docs/cloud/rest/api-reference/integration-tools/list-tools-for-integration

Go example using net/http to list tools for an integration. Creates a GET request with the Authorization header and prints the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/integrations/{integration}/tools"

	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))

}
```

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

### 200 response example for Get account usage warnings

Source: https://veryfront.com/docs/cloud/rest/api-reference/account-usage/get-account-usage-warnings

Example 200 response body for the GET /account/usage/warnings endpoint. Contains a warnings array of human-readable usage warning messages.

```json
{
  "warnings": [
    "<string>"
  ]
}
```

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

### Go example to list environment variables

Source: https://veryfront.com/docs/cloud/rest/api-reference/environment-variables/list-environment-variables

Go program using net/http to perform the GET request with Authorization header, printing the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/environment-variables?limit=20&sort_by=key&sort_order=asc"

	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 listing project chunks

Source: https://veryfront.com/docs/cloud/rest/api-reference/content-chunks/list-project-chunks

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

```go
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/chunks?limit=100"

	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))

}
```

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

### Python requests example for get release asset manifest

Source: https://veryfront.com/docs/cloud/rest/api-reference/releases-and-asset-manifests/get-release-asset-manifest

Python example using the requests library to GET the asset manifest. Requires the requests package and a valid Bearer token.

```python
import requests

url = "https://api.veryfront.com/projects/{project_reference}/releases/{version}/asset-manifest"

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

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

print(response.text)
```

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

### Go example for listing uploads

Source: https://veryfront.com/docs/cloud/rest/api-reference/project-uploads/list-uploads

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

```go
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/uploads?limit=20&sort_by=created_at&sort_order=desc&recursive=true"

	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))

}
```

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

### 200 response example for GET conversation

Source: https://veryfront.com/docs/cloud/rest/api-reference/conversations/get-conversation

Example 200 response body for the GET conversation endpoint. Shows the conversation object with fields like id, type, status, message_count, and participants.

```json
{
  "id": "<string>",
  "type": "chat",
  "status": "active",
  "message_count": 123,
  "created_by": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>",
  "project_id": "<string>",
  "responding_agent_id": null,
  "title": "<string>",
  "summary": "<string>",
  "current_node": "<string>",
  "last_message_at": "<string>",
  "metadata": {},
  "archived_at": "<string>",
  "participants": []
}

```

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

### Go example for listing models

Source: https://veryfront.com/docs/cloud/rest/api-reference/inference/list-models-anthropic-base-url-alias

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

```go
package main

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

func main() {

	url := "https://api.veryfront.com/ai/anthropic/v1/models"

	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))

}
```

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

### 400 error response examples for GET conversation

Source: https://veryfront.com/docs/cloud/rest/api-reference/conversations/get-conversation

Two identical 400 error response examples for the GET conversation endpoint. They show the validation-failed error structure with idempotency details and field errors.

```json
{
  "type": "https://api.veryfront.com/errors/validation-failed",
  "title": "Validation Failed",
  "status": 400,
  "idempotency": {
    "state": "in_progress",
    "operation": "<string>",
    "retryable": true,
    "retry_after_seconds": 1,
    "expires_at": "<string>",
    "recovery": {
      "available": true,
      "description": "<string>",
      "resource_url": "<string>"
    }
  },
  "detail": "The 'email' field must be a valid email address",
  "instance": "/projects/my-project/members",
  "slug": "validation-failed",
  "category": "VALIDATION",
  "suggestion": "Check the request body and query parameters against the API documentation.",
  "errors": [
    {
      "field": "email",
      "message": "Invalid email format",
      "code": "INVALID_FORMAT"
    }
  ]
}

```

```json
{
  "type": "https://api.veryfront.com/errors/validation-failed",
  "title": "Validation Failed",
  "status": 400,
  "idempotency": {
    "state": "in_progress",
    "operation": "<string>",
    "retryable": true,
    "retry_after_seconds": 1,
    "expires_at": "<string>",
    "recovery": {
      "available": true,
      "description": "<string>",
      "resource_url": "<string>"
    }
  },
  "detail": "The 'email' field must be a valid email address",
  "instance": "/projects/my-project/members",
  "slug": "validation-failed",
  "category": "VALIDATION",
  "suggestion": "Check the request body and query parameters against the API documentation.",
  "errors": [
    {
      "field": "email",
      "message": "Invalid email format",
      "code": "INVALID_FORMAT"
    }
  ]
}

```

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

### Create Tool with Go

Source: https://veryfront.com/docs/cloud/rest/api-reference/project-tools/create-tool

Go example using the standard library to create a tool. It constructs a POST request with the required headers and JSON body, sends it, and prints the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/tools"

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

}

```

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

### PHP cURL GET

Source: https://veryfront.com/docs/cloud/rest/api-reference/project-traces/get-project-trace

PHP example using cURL to perform the GET request with a Bearer token.

```PHP
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.veryfront.com/projects/{project_reference}/traces/{trace_id}",
  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;
}
```

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

### Create Skill Go Example

Source: https://veryfront.com/docs/cloud/rest/api-reference/project-skills/create-skill

Go example using net/http to POST a skill creation request. Builds a JSON payload string and prints the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/skills"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"description\": \"<string>\",\n  \"id\": \"<string>\",\n  \"allowed_tools\": [\n    \"<string>\"\n  ],\n  \"instructions\": \"<string>\",\n  \"source\": \"<string>\"\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))

}
```

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

### Example usage of veryfront/integrations

Source: https://veryfront.com/docs/code/api-reference/veryfront/integrations

Example usage of the integration API: list connectors, get a specific connector, get its icon as a raw SVG string, discover remote integration tools, and fetch runtime tool definitions.

```typescript
import {
  createSalesforceServiceAccountToolSource,
  getConnector,
  getIcon,
  getRemoteIntegrationToolDefinitions,
  getRemoteIntegrationToolDiscovery,
  listConnectors,
} from "veryfront/integrations";

const connectors = listConnectors();
const slack = getConnector("slack");
const slackIcon = getIcon("slack"); // raw SVG string
const discovery = await getRemoteIntegrationToolDiscovery();
const runtimeTools = await getRemoteIntegrationToolDefinitions();

```

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

### Install agent with Go

Source: https://veryfront.com/docs/cloud/rest/api-reference/project-agents/install-agent

Uses the net/http package to send the install request. Prints the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/agents/{agent_id}/install"

	payload := strings.NewReader("{\n  \"relation\": \"editor\"\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))

}
```

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

### Get project integration API request examples

Source: https://veryfront.com/docs/cloud/rest/api-reference/project-integrations/get-project-integration

These examples show how to call the Get project integration endpoint using different languages. Each request uses a GET method to the URL https://api.veryfront.com/projects/{project_reference}/integrations/{name} with an Authorization header containing a bearer token. The response is printed or logged.

```cURL
curl --request GET \
  --url https://api.veryfront.com/projects/{project_reference}/integrations/{name} \
  --header 'Authorization: Bearer <token>'
```

```Python
import requests

url = "https://api.veryfront.com/projects/{project_reference}/integrations/{name}"

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

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

print(response.text)
```

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

fetch('https://api.veryfront.com/projects/{project_reference}/integrations/{name}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```PHP
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.veryfront.com/projects/{project_reference}/integrations/{name}",
  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
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/integrations/{name}"

	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
HttpResponse<String> response = Unirest.get("https://api.veryfront.com/projects/{project_reference}/integrations/{name}")
  .header("Authorization", "Bearer <token>")
  .asString();
```

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

url = URI("https://api.veryfront.com/projects/{project_reference}/integrations/{name}")

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 listing connections

Source: https://veryfront.com/docs/cloud/rest/api-reference/project-integrations/list-project-integration-connections

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

```go
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/integrations/{name}/connections?limit=20&sort_by=project&sort_order=asc"

	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))

}
```

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

### Get project file - request examples

Source: https://veryfront.com/docs/cloud/rest/api-reference/project-files/get-project-file

Example requests for the Get project file endpoint in cURL, Python, JavaScript, PHP, Go, Java (Unirest), and Ruby. All use the GET method with the Authorization header set to 'Bearer <token>' and the URL pattern https://api.veryfront.com/projects/{project_reference}/files/{file_path}.

```bash
curl --request GET \
  --url https://api.veryfront.com/projects/{project_reference}/files/{file_path} \
  --header 'Authorization: Bearer <token>'
```

```python
import requests

url = "https://api.veryfront.com/projects/{project_reference}/files/{file_path}"

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

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

print(response.text)
```

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

fetch('https://api.veryfront.com/projects/{project_reference}/files/{file_path}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.veryfront.com/projects/{project_reference}/files/{file_path}",
  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
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/files/{file_path}"

	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
HttpResponse<String> response = Unirest.get("https://api.veryfront.com/projects/{project_reference}/files/{file_path}")
  .header("Authorization", "Bearer <token>")
  .asString();
```

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

url = URI("https://api.veryfront.com/projects/{project_reference}/files/{file_path}")

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
```

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

### GET /.well-known/jwks.json

Source: https://veryfront.com/docs/cloud/rest/api-reference/authentication/get-jwks

Documentation for the GET /.well-known/jwks.json endpoint, including request examples in multiple languages and response schemas.

```APIDOC
## GET /.well-known/jwks.json

### Description
Retrieves the JSON Web Key Set (JWKS) used to verify JSON Web Tokens (JWTs) issued by the authentication system. This endpoint returns the public keys that clients can use to validate the signature of access tokens.

### Method
GET

### Endpoint
https://api.veryfront.com/.well-known/jwks.json

### Parameters
#### Headers
- **Authorization** (string) - Required - Bearer token for authentication.

### Request Example
```
curl --request GET \
  --url https://api.veryfront.com/.well-known/jwks.json \
  --header 'Authorization: Bearer <token>'
```

### Response
#### Success Response (200)
- **keys** (array) - List of JSON Web Keys.
  - **kty** (string) - Key type (e.g., RSA).
  - **use** (string) - Intended use of the key (e.g., sig).
  - **alg** (string) - Algorithm used (e.g., RS256).
  - **kid** (string) - Key identifier.
  - **n** (string) - RSA modulus.
  - **e** (string) - RSA exponent.

#### Response Example
```
{
  "keys": [
    {
      "kty": "RSA",
      "use": "sig",
      "alg": "RS256",
      "kid": "<string>",
      "n": "<string>",
      "e": "<string>"
    }
  ]
}
```

#### Error Response (400)
- **type** (string) - Error type URI.
- **title** (string) - Error title.
- **status** (integer) - HTTP status code.
- **idempotency** (object) - Idempotency details.
- **detail** (string) - Error detail message.
- **instance** (string) - Instance URI.
- **slug** (string) - Error slug.
- **category** (string) - Error category.
- **suggestion** (string) - Suggestion for resolving the error.
- **errors** (array) - List of field-specific errors.

#### Error Response Example
```
{
  "type": "https://api.veryfront.com/errors/validation-failed",
  "title": "Validation Failed",
  "status": 400,
  "idempotency": {
    "state": "in_progress",
    "operation": "<string>",
    "retryable": true,
    "retry_after_seconds": 1,
    "expires_at": "<string>",
    "recovery": {
      "available": true,
      "description": "<string>",
      "resource_url": "<string>"
    }
  },
  "detail": "The 'email' field must be a valid email address",
  "instance": "/projects/my-project/members",
  "slug": "validation-failed",
  "category": "VALIDATION",
  "suggestion": "Check the request body and query parameters against the API documentation.",
  "errors": [
    {
      "field": "email",
      "message": "Invalid email format",
      "code": "INVALID_FORMAT"
    }
  ]
}
```
```

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

### Go example to move a project file

Source: https://veryfront.com/docs/cloud/rest/api-reference/project-files/move-project-file

Uses net/http to send a POST request with the move payload. Prints the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/files/move"

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

}
```

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

### Go example for registering current project style artifact

Source: https://veryfront.com/docs/cloud/rest/api-reference/style-artifacts/register-current-project-style-artifact

Uses the net/http package to send a PUT request with a JSON string payload and headers. Prints the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/projects/{project_reference}/style-artifacts/current"

	payload := strings.NewReader("{\n  \"style_profile_hash\": \"<string>\",\n  \"branch\": \"<string>\",\n  \"environment_name\": \"<string>\",\n  \"release_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"status\": \"ready\",\n  \"artifact_hash\": \"<string>\",\n  \"asset_path\": \"<string>\",\n  \"content_type\": \"<string>\",\n  \"etag\": \"<string>\",\n  \"build_run_id\": \"<string>\",\n  \"failure_reason\": \"<string>\"\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))

}
```

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

### Ruby example

Source: https://veryfront.com/docs/cloud/rest/api-reference/branch-files/list-branch-file-versions

Ruby example using net/http to GET branch file versions. Prints the response body.

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

url = URI("https://api.veryfront.com/projects/{project_reference}/branches/{branchName}/files/{filePath}/versions")

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
```

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

### List integrations with Go

Source: https://veryfront.com/docs/cloud/rest/api-reference/integration-catalog/list-integrations

Go example using net/http to GET /integrations. It sets the Authorization header and prints the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/integrations?limit=20&sort_by=name&sort_order=asc"

	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 starting sandbox background command

Source: https://veryfront.com/docs/cloud/rest/api-reference/sandbox/start-sandbox-background-command

Uses net/http to send a POST request with a JSON payload to the sandbox-sessions commands endpoint. Prints the response body.

```go
package main

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

func main() {

	url := "https://api.veryfront.com/sandbox-sessions/{session_id}/commands"

	payload := strings.NewReader("{\n  \"command\": \"<string>\",\n  \"cwd\": \"<string>\",\n  \"timeout_seconds\": 123,\n  \"env\": {}\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))

}

```

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

### Java Unirest example for get integration

Source: https://veryfront.com/docs/cloud/rest/api-reference/integration-catalog/get-integration

Uses the Unirest HTTP library to GET an integration and returns the response as a string.

```java
HttpResponse<String> response = Unirest.get("https://api.veryfront.com/integrations/{name}")
  .header("Authorization", "Bearer <token>")
  .asString();
```
Tokens:
Raw