Renew a private setup assignment

curl --request POST \
  --url https://api.agentsfleet.net/v1/runners/me/authoring-leases/{lease_id}/renew \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fence": "<string>",
  "usage": {
    "calls": 1,
    "runtime_ms": 1,
    "input_tokens": 1,
    "output_tokens": 1,
    "provider_cost_nanos": "<string>"
  }
}
'

import requests

url = "https://api.agentsfleet.net/v1/runners/me/authoring-leases/{lease_id}/renew"

payload = {
    "fence": "<string>",
    "usage": {
        "calls": 1,
        "runtime_ms": 1,
        "input_tokens": 1,
        "output_tokens": 1,
        "provider_cost_nanos": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    fence: '<string>',
    usage: {
      calls: 1,
      runtime_ms: 1,
      input_tokens: 1,
      output_tokens: 1,
      provider_cost_nanos: '<string>'
    }
  })
};

fetch('https://api.agentsfleet.net/v1/runners/me/authoring-leases/{lease_id}/renew', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.agentsfleet.net/v1/runners/me/authoring-leases/{lease_id}/renew",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'fence' => '<string>',
    'usage' => [
        'calls' => 1,
        'runtime_ms' => 1,
        'input_tokens' => 1,
        'output_tokens' => 1,
        'provider_cost_nanos' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.agentsfleet.net/v1/runners/me/authoring-leases/{lease_id}/renew"

	payload := strings.NewReader("{\n  \"fence\": \"<string>\",\n  \"usage\": {\n    \"calls\": 1,\n    \"runtime_ms\": 1,\n    \"input_tokens\": 1,\n    \"output_tokens\": 1,\n    \"provider_cost_nanos\": \"<string>\"\n  }\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))

}

HttpResponse<String> response = Unirest.post("https://api.agentsfleet.net/v1/runners/me/authoring-leases/{lease_id}/renew")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"fence\": \"<string>\",\n  \"usage\": {\n    \"calls\": 1,\n    \"runtime_ms\": 1,\n    \"input_tokens\": 1,\n    \"output_tokens\": 1,\n    \"provider_cost_nanos\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.agentsfleet.net/v1/runners/me/authoring-leases/{lease_id}/renew")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"fence\": \"<string>\",\n  \"usage\": {\n    \"calls\": 1,\n    \"runtime_ms\": 1,\n    \"input_tokens\": 1,\n    \"output_tokens\": 1,\n    \"provider_cost_nanos\": \"<string>\"\n  }\n}"

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

{
  "expires_at": "2023-11-07T05:31:56Z",
  "model_access_expires_at": "2023-11-07T05:31:56Z",
  "remaining_output_tokens": 1,
  "stop_requested": true
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

POST

runners

authoring-leases

{lease_id}

renew

Renew a private setup assignment

curl --request POST \
  --url https://api.agentsfleet.net/v1/runners/me/authoring-leases/{lease_id}/renew \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "fence": "<string>",
  "usage": {
    "calls": 1,
    "runtime_ms": 1,
    "input_tokens": 1,
    "output_tokens": 1,
    "provider_cost_nanos": "<string>"
  }
}
'

import requests

url = "https://api.agentsfleet.net/v1/runners/me/authoring-leases/{lease_id}/renew"

payload = {
    "fence": "<string>",
    "usage": {
        "calls": 1,
        "runtime_ms": 1,
        "input_tokens": 1,
        "output_tokens": 1,
        "provider_cost_nanos": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    fence: '<string>',
    usage: {
      calls: 1,
      runtime_ms: 1,
      input_tokens: 1,
      output_tokens: 1,
      provider_cost_nanos: '<string>'
    }
  })
};

fetch('https://api.agentsfleet.net/v1/runners/me/authoring-leases/{lease_id}/renew', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.agentsfleet.net/v1/runners/me/authoring-leases/{lease_id}/renew",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'fence' => '<string>',
    'usage' => [
        'calls' => 1,
        'runtime_ms' => 1,
        'input_tokens' => 1,
        'output_tokens' => 1,
        'provider_cost_nanos' => '<string>'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.agentsfleet.net/v1/runners/me/authoring-leases/{lease_id}/renew"

	payload := strings.NewReader("{\n  \"fence\": \"<string>\",\n  \"usage\": {\n    \"calls\": 1,\n    \"runtime_ms\": 1,\n    \"input_tokens\": 1,\n    \"output_tokens\": 1,\n    \"provider_cost_nanos\": \"<string>\"\n  }\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))

}

HttpResponse<String> response = Unirest.post("https://api.agentsfleet.net/v1/runners/me/authoring-leases/{lease_id}/renew")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"fence\": \"<string>\",\n  \"usage\": {\n    \"calls\": 1,\n    \"runtime_ms\": 1,\n    \"input_tokens\": 1,\n    \"output_tokens\": 1,\n    \"provider_cost_nanos\": \"<string>\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.agentsfleet.net/v1/runners/me/authoring-leases/{lease_id}/renew")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"fence\": \"<string>\",\n  \"usage\": {\n    \"calls\": 1,\n    \"runtime_ms\": 1,\n    \"input_tokens\": 1,\n    \"output_tokens\": 1,\n    \"provider_cost_nanos\": \"<string>\"\n  }\n}"

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

{
  "expires_at": "2023-11-07T05:31:56Z",
  "model_access_expires_at": "2023-11-07T05:31:56Z",
  "remaining_output_tokens": 1,
  "stop_requested": true
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

{
  "detail": "<string>",
  "docs_uri": "<string>",
  "error_code": "<string>",
  "request_id": "<string>",
  "title": "<string>",
  "action_id": "<string>",
  "current_state": "<string>",
  "etag": "<string>",
  "gate_id": "<string>",
  "outcome": "<string>",
  "resolved_at": "2023-11-07T05:31:56Z",
  "resolved_by": "<string>",
  "user_message": "<string>"
}

Authorizations

Authorization

string

header

required

Runner token beginning with agt_r, returned once by POST /v1/runners

Path Parameters

lease_id

string

required

Lease identifier (version 7 universally unique identifier, or UUID).

Body

application/json

Own-lease renewal with cumulative observations.

fence

string

required

Current attempt number, as a decimal string. Rejects updates from replaced runners.

usage

object

required

Cumulative usage counts that can only increase, verified by the server.

Show child attributes

Response

Durable acknowledgement

Live extension and remaining bounded output allowance.

expires_at

string<date-time>

required

The lease's extended expiry.

model_access_expires_at

string<date-time>

required

The original capability remains bound to the renewed lease.

remaining_output_tokens

integer<int64>

required

Output tokens still available across this attempt.

Required range: x >= 0

stop_requested

boolean

required

Whether the runner must stop private work.

Overview

Health

Authentication

API keys

Users

Account management

Model provider credentials

Balance and usage

Account models

Runner administration

Runner API

Model catalog

Workspaces

Private setup chats

Workspace preferences

Secrets

Connectors

Approvals

Fleets

Fleet library

Fleet messages

Fleet memories

Fleet schedules

Fleet events

Integration grants

Webhooks

Platform administration

Renew a private setup assignment

Authorizations

Path Parameters

Body

Response