networks

Let your sandboxes sign their requests as Runtime's agents, or stop them.

Needs credit on the account, and free. When on, a sandbox can get Runtime's Web Bot Auth signature (IETF draft, RFC 9421 HTTP message signatures) for its outbound HTTP requests, so sites behind Cloudflare and other bot managers recognise them as Runtime's agents. A program gets the headers from https://withruntime.com/api/signed-requests/sign (documented at /docs/egress). Off by default. Turning it off stops new signatures at once; ones already given expire within 5 minutes.

put/v1/networks/signed-requests

Request

  • Base URL: https://api.withruntime.com
  • URL: https://api.withruntime.com/v1/networks/signed-requests
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Replaying the same key with the same request within 24 hours returns the first result and never repeats the effect. A refusal is not kept: a request refused before it ran (no_capacity, busy, a limit) runs afresh when sent again with its key. The SDKs send one automatically; the server makes one when absent and returns it in the idempotency-key response header.

Request body

enabledboolean required

true: your sandboxes may get Runtime's request signature. false: new signatures stop at once, and ones already given expire within 5 minutes.

Response

Success

enabledboolean required

Whether your sandboxes may get Runtime's request signature now.

allowedboolean required

Whether this account may turn it on: it must have credit.

whystring nullable required

Why it may not, when allowed is false: no_credit, revoked or suspended.

enabledAtstring nullable required

When it was last turned on.

disabledAtstring nullable required

When it was last turned off.

Changes

No recorded changes to this operation across all 1 revision of this API.