Methods | Fous API Reference

The Method object

idstringrequired
mth_ followed by 26 characters.
slugstringrequired
<domain>/<snake_case_name>, one method’s own; accepted wherever an id is.
namestringrequired
descriptionstringrequired
returnsstringrequired
What the output holds, in a few words.
platformobjectrequired
Show child attributesHide child attributes
- namestring
- domainstring
input_schemaobjectrequired
A flat JSON Schema object: snake_case properties with descriptions; required lists the inputs a call must send.
authobjectrequired
Show child attributesHide child attributes
- requiredbooleanrequired
  Whether the method runs with a connected account.
- typestring
  session: a website login; api_key: the site’s own API key.
  sessionapi_key
- connectionstring or null
  Your default connection for this platform, if any.
effectstringrequired
read: it gets data. write: it does something on the site (submits, posts, books, sends); run it with care.
readwrite
costobjectrequired
Show child attributesHide child attributes
- creditsinteger
privateboolean
Present (true) on your organization’s methods that are not published.
versionintegerrequired
The version shown: the one your organization uses (its pin, else the latest), or the one the ref named (@N). A version is a contract: its inputs and outputs never change.
latest_versionintegerrequired
The method’s newest version.
statusstring
In a search result, present only when the version is not ready: degraded (failing: its saved examples stopped answering, and no run has answered since; runs are still attempted, and Fous repairs it) or repairing (a repair confirmed the break while runs failed too; runs are refused with 503 method_repairing until it ends, at the latest at repair.expected_at).
degradedrepairing
repairobject
Only while repairing: when the version is back at the latest. A repair that has not confirmed a break is never shown.
Show child attributesHide child attributes
- expected_atstringrequired
- back_in_minutesintegerrequired
last_repairobject
While degraded, when a repair ran and could not fix the version: when it ended and why, in its own words. Fous checks the version every hour and repairs it again later.
Show child attributesHide child attributes
- atstringrequired
- reasonstringrequired
deletes_atstring
A public method nobody has run for 6 months: when it is deleted unless it runs (any run keeps it).

Method

{  "id": "mth_01m5kvvywdeac8fxs7nh0sw68w",  "slug": "date.nager.at/list_public_holidays",  "name": "List public holidays",  "description": "Lists a country's public holidays for a year from Nager.Date, with local names, regional coverage and holiday types.",  "returns": "date, weekday, English and local names, regions, type, nationwide flag",  "platform": {    "name": "Nager.Date",    "domain": "nager.at"  },  "input_schema": {    "type": "object",    "required": [      "country"    ],    "properties": {      "year": {        "type": "integer",        "minimum": 1,        "maximum": 9999,        "description": "Calendar year, for example 2026. Defaults to the current year."      },      "country": {        "type": "string",        "description": "Country name or two-letter country code, for example Germany or DE."      }    }  },  "effect": "read",  "auth": {    "required": false  },  "cost": {    "credits": 1  },  "version": 2,  "latest_version": 2}

The MethodListItem object

idstringrequired
mth_ followed by 26 characters.
slugstringrequired
<domain>/<snake_case_name>, one method’s own; accepted wherever an id is.
namestringrequired
descriptionstringrequired
returnsstringrequired
What the output holds, in a few words.
platformobjectrequired
Show child attributesHide child attributes
- namestring
- domainstring
input_schemaobjectrequired
A flat JSON Schema object: snake_case properties with descriptions; required lists the inputs a call must send.
authobjectrequired
Show child attributesHide child attributes
- requiredbooleanrequired
  Whether the method runs with a connected account.
- typestring
  session: a website login; api_key: the site’s own API key.
  sessionapi_key
- connectionstring or null
  Your default connection for this platform, if any.
effectstringrequired
read: it gets data. write: it does something on the site (submits, posts, books, sends); run it with care.
readwrite
costobjectrequired
Show child attributesHide child attributes
- creditsinteger
privateboolean
Present (true) on your organization’s methods that are not published.
versionintegerrequired
The version shown: the one your organization uses (its pin, else the latest), or the one the ref named (@N). A version is a contract: its inputs and outputs never change.
latest_versionintegerrequired
The method’s newest version.
statusstringrequired
How the version shown stands: ready (any answer with data makes it ready at once); degraded (failing: its saved examples stopped answering, and no run has answered since; runs are still attempted, and Fous repairs it); repairing (a repair confirmed the break while runs failed too; runs are refused with 503 method_repairing until it ends, at the latest at repair.expected_at).
readydegradedrepairing
repairobject
Only while repairing: when the version is back at the latest. A repair that has not confirmed a break is never shown.
Show child attributesHide child attributes
- expected_atstringrequired
- back_in_minutesintegerrequired
last_repairobject
While degraded, when a repair ran and could not fix the version: when it ended and why, in its own words. Fous checks the version every hour and repairs it again later.
Show child attributesHide child attributes
- atstringrequired
- reasonstringrequired
deletes_atstring
A public method nobody has run for 6 months: when it is deleted unless it runs (any run keeps it).
pinned_versioninteger or nullrequired
The version your organization uses: set by its first run (owners too), moved by PATCH {"pinned_version": N} or by a new version it builds itself. Null until a run.
visibilitystringrequired
private: only your organization finds and runs it. public: anyone may; it stays public, and anyone may improve it.
publicprivate
statsobjectrequired
How the method has done so far.
Show child attributesHide child attributes
- success_ratenumber or null
- runsinteger
- last_success_atstring or null
ownedbooleanrequired
Your organization built it: it publishes it, and deletes it while it is private.
based_onobject
The method (and its version) this one was started from.
Show child attributesHide child attributes
- idstringrequired
- slugstringrequired
- namestringrequired
- versioninteger
  The version, when one is meant.
created_atstringrequired
updated_atstringrequired

MethodListItem

{  "id": "mth_01m5kz9a1b2c3d4e5f6g7h8j9k",  "slug": "crates.io/search_crates",  "name": "Search crates",  "description": "Searches crates.io by keyword.",  "returns": "name, description, downloads, version",  "platform": {    "name": "crates.io",    "domain": "crates.io"  },  "input_schema": {    "type": "object",    "required": [      "query"    ],    "properties": {      "query": {        "type": "string",        "description": "Keyword."      }    }  },  "effect": "read",  "auth": {    "required": false  },  "cost": {    "credits": 1  },  "version": 1,  "latest_version": 1,  "private": true,  "status": "ready",  "pinned_version": 1,  "visibility": "private",  "owned": true,  "stats": {    "success_rate": 1,    "runs": 4,    "last_success_at": "2026-10-23T09:02:11.000Z"  },  "created_at": "2026-10-23T08:41:12.000Z",  "updated_at": "2026-10-23T08:41:12.000Z"}

The MethodDetail object

idstringrequired
mth_ followed by 26 characters.
slugstringrequired
<domain>/<snake_case_name>, one method’s own; accepted wherever an id is.
namestringrequired
descriptionstringrequired
returnsstringrequired
What the output holds, in a few words.
platformobjectrequired
Show child attributesHide child attributes
- namestring
- domainstring
input_schemaobjectrequired
A flat JSON Schema object: snake_case properties with descriptions; required lists the inputs a call must send.
authobjectrequired
Show child attributesHide child attributes
- requiredbooleanrequired
  Whether the method runs with a connected account.
- typestring
  session: a website login; api_key: the site’s own API key.
  sessionapi_key
- connectionstring or null
  Your default connection for this platform, if any.
effectstringrequired
read: it gets data. write: it does something on the site (submits, posts, books, sends); run it with care.
readwrite
costobjectrequired
Show child attributesHide child attributes
- creditsinteger
privateboolean
Present (true) on your organization’s methods that are not published.
versionintegerrequired
The version shown: the one your organization uses (its pin, else the latest), or the one the ref named (@N). A version is a contract: its inputs and outputs never change.
latest_versionintegerrequired
The method’s newest version.
statusstringrequired
How the version shown stands: ready (any answer with data makes it ready at once); degraded (failing: its saved examples stopped answering, and no run has answered since; runs are still attempted, and Fous repairs it); repairing (a repair confirmed the break while runs failed too; runs are refused with 503 method_repairing until it ends, at the latest at repair.expected_at).
readydegradedrepairing
repairobject
Only while repairing: when the version is back at the latest. A repair that has not confirmed a break is never shown.
Show child attributesHide child attributes
- expected_atstringrequired
- back_in_minutesintegerrequired
last_repairobject
While degraded, when a repair ran and could not fix the version: when it ended and why, in its own words. Fous checks the version every hour and repairs it again later.
Show child attributesHide child attributes
- atstringrequired
- reasonstringrequired
deletes_atstring
A public method nobody has run for 6 months: when it is deleted unless it runs (any run keeps it).
pinned_versioninteger or nullrequired
The version your organization uses: set by its first run (owners too), moved by PATCH {"pinned_version": N} or by a new version it builds itself. Null until a run.
visibilitystringrequired
private: only your organization finds and runs it. public: anyone may; it stays public, and anyone may improve it.
publicprivate
statsobjectrequired
How the method has done so far.
Show child attributesHide child attributes
- success_ratenumber or null
- runsinteger
- last_success_atstring or null
ownedbooleanrequired
Your organization built it: it publishes it, and deletes it while it is private.
based_onobject
The method (and its version) this one was started from.
Show child attributesHide child attributes
- idstringrequired
- slugstringrequired
- namestringrequired
- versioninteger
  The version, when one is meant.
revisionintegerrequired
How many times the version shown was revised in place (a repair or an improvement that kept its contract); the seen parameter carries it.
latest_changesstring
When the version shown is not the latest: what the latest changes against it, in a sentence or two.
versionsarray of objectrequired
The method’s versions, newest first (at most 20).
Show child attributesHide child attributes
- versionintegerrequired
- revisionintegerrequired
- latestboolean
  The newest version.
  true
- pinnedboolean
  The version your organization uses.
  true
- statusstringrequired
  readydegradedrepairing
- created_atstringrequired
- revised_atstring
  When it was last revised in place.
- changesstringrequired
  What it changes against the version before it; empty for the first.
output_schemaobjectrequired
The JSON Schema every run’s data follows.
exampleobject
Show child attributesHide child attributes
- inputobject
- outputJSON value

MethodDetail

{  "id": "mth_01m5kvvywdeac8fxs7nh0sw68w",  "slug": "date.nager.at/list_public_holidays",  "name": "List public holidays",  "description": "Lists a country's public holidays for a year from Nager.Date, with local names, regional coverage and holiday types.",  "returns": "date, weekday, English and local names, regions, type, nationwide flag",  "platform": {    "name": "Nager.Date",    "domain": "nager.at"  },  "input_schema": {    "type": "object",    "required": [      "country"    ],    "properties": {      "year": {        "type": "integer",        "minimum": 1,        "maximum": 9999,        "description": "Calendar year, for example 2026. Defaults to the current year."      },      "country": {        "type": "string",        "description": "Country name or two-letter country code, for example Germany or DE."      }    }  },  "effect": "read",  "auth": {    "required": false  },  "cost": {    "credits": 1  },  "version": 2,  "latest_version": 2,  "revision": 1,  "pinned_version": null,  "status": "ready",  "versions": [    {      "version": 2,      "revision": 1,      "latest": true,      "status": "ready",      "created_at": "2026-10-22T16:02:41.000Z",      "changes": "Adds output holidays[].regions."    },    {      "version": 1,      "revision": 2,      "status": "ready",      "created_at": "2026-10-21T09:12:05.000Z",      "revised_at": "2026-10-24T03:10:19.000Z",      "changes": ""    }  ],  "visibility": "public",  "output_schema": {    "type": "object",    "properties": {      "country_name": {        "type": "string"      },      "year": {        "type": "integer"      },      "holidays": {        "type": "array",        "items": {          "type": "object"        }      }    }  },  "example": {    "input": {      "country": "Germany",      "year": 2027    },    "output": {      "country_name": "Germany",      "year": 2027,      "holidays": [        {          "date": "2027-01-01",          "weekday": "Friday",          "english_name": "New Year's Day",          "local_name": "Neujahr",          "nationwide": "yes",          "regions": [],          "type": "Public"        }      ]    }  },  "stats": {    "success_rate": 1,    "runs": 12,    "last_success_at": "2026-10-23T08:24:36.410Z"  },  "owned": false}

Describe what you need in plain language. Returns the methods that fit, best first, each with its effect (read or write) and input schema, or match "none". Search never builds: when nothing fits, build one with POST /v1/builds. Free.

Query parameters

querystringOptional
What you need, in plain language.
platformstringOptional
A domain or site name to search within; alone, it lists that site’s methods.
limitintegerOptional
How many: 1 to 20 with a query (default 5); a site listed without a query, up to 100 (default 100).
suggestbooleandefault falseOptional
Search as someone types: the methods nearest the text so far (its last word may be unfinished), without checking which do it all, so results, suggested: true, and no match or reason. Five a minute for each of the plan’s requests, counted apart from searches.

Returns

200Methods that fit, or none. With suggest=true, the nearest methods.

The answer has these fields:

resultsarray of Methodrequired
matchstring
Always sent, except with suggest=true.
foundnone
suggestedboolean
With suggest=true: the results are unchecked suggestions.
true
relatedarray of Method
On a miss: methods that do part of what was asked (unchecked when Fous could not check fit just then; reason says so).
reasonstring
On a miss: why nothing fits (a request that names only a topic), that POST /v1/builds can make it, or that Fous could not check fit just then.

Errors

Status	Code	When
400	`invalid_request`	Neither query nor platform
401	`unauthorized`	No valid key
429	`rate_limited`	Too many searches for the plan this minute

curl 'https://api.fous.com/v1/search?query=public+holidays+in+Germany+next+year' \  -H "Authorization: Bearer $FOUS_API_KEY"

// Save as fous.mts, then run: npx tsx fous.mtsconst response = await fetch('https://api.fous.com/v1/search?query=public+holidays+in+Germany+next+year', {  headers: {    Authorization: `Bearer ${process.env.FOUS_API_KEY}`,  },});const result = await response.json();if (!response.ok) throw new Error(`${result.error.code}: ${result.error.message}`);console.log(result);

import osimport requestsresponse = requests.get(    "https://api.fous.com/v1/search?query=public+holidays+in+Germany+next+year",    headers={        "Authorization": f"Bearer {os.environ['FOUS_API_KEY']}",    },    timeout=180,)result = response.json()if not response.ok:    raise RuntimeError(f"{result['error']['code']}: {result['error']['message']}")print(result)

Sent with your key, kept for this tab only. A run uses credits like any call.

{  "results": [    {      "id": "mth_01m5kvvywdeac8fxs7nh0sw68w",      "slug": "date.nager.at/list_public_holidays",      "name": "List public holidays",      "description": "Lists a country's public holidays for a year from Nager.Date, with local names, regional coverage and holiday types.",      "returns": "date, weekday, English and local names, regions, type, nationwide flag",      "platform": {        "name": "Nager.Date",        "domain": "nager.at"      },      "input_schema": {        "type": "object",        "required": [          "country"        ],        "properties": {          "year": {            "type": "integer",            "minimum": 1,            "maximum": 9999,            "description": "Calendar year, for example 2026. Defaults to the current year."          },          "country": {            "type": "string",            "description": "Country name or two-letter country code, for example Germany or DE."          }        }      },      "effect": "read",      "auth": {        "required": false      },      "cost": {        "credits": 1      },      "version": 2,      "latest_version": 2    }  ],  "match": "found"}

{  "error": {    "code": "invalid_request",    "message": "Send query, platform, or both.",    "doc_url": "https://docs.fous.com/guides/errors#invalid_request",    "request_id": "req_mh7c2k9xQ1v3Zt8LbN0pRwY4"  }}

List your methods

Your organization’s own methods, private and published, the latest change first; or, with ids, any methods it sees, each at the version it uses, for a live re-read of their status. Free.

Query parameters

platformstringOptional
Only the methods on this site (a domain or site name).
idsstringOptional
Method ids, comma-separated, at most 50: those methods instead of your own (owned says whose).

Returns

200Your methods.

The answer has these fields:

methodsarray of MethodListItemrequired

curl 'https://api.fous.com/v1/methods' \  -H "Authorization: Bearer $FOUS_API_KEY"

// Save as fous.mts, then run: npx tsx fous.mtsconst response = await fetch('https://api.fous.com/v1/methods', {  headers: {    Authorization: `Bearer ${process.env.FOUS_API_KEY}`,  },});const result = await response.json();if (!response.ok) throw new Error(`${result.error.code}: ${result.error.message}`);console.log(result);

import osimport requestsresponse = requests.get(    "https://api.fous.com/v1/methods",    headers={        "Authorization": f"Bearer {os.environ['FOUS_API_KEY']}",    },    timeout=180,)result = response.json()if not response.ok:    raise RuntimeError(f"{result['error']['code']}: {result['error']['message']}")print(result)

Sent with your key, kept for this tab only. A run uses credits like any call.

Response 200

{  "methods": [    {      "id": "mth_01m5kz9a1b2c3d4e5f6g7h8j9k",      "slug": "crates.io/search_crates",      "name": "Search crates",      "description": "Searches crates.io by keyword.",      "returns": "name, description, downloads, version",      "platform": {        "name": "crates.io",        "domain": "crates.io"      },      "input_schema": {        "type": "object",        "required": [          "query"        ],        "properties": {          "query": {            "type": "string",            "description": "Keyword."          }        }      },      "effect": "read",      "auth": {        "required": false      },      "cost": {        "credits": 1      },      "version": 1,      "latest_version": 1,      "private": true,      "status": "ready",      "pinned_version": 1,      "visibility": "private",      "owned": true,      "stats": {        "success_rate": 1,        "runs": 4,        "last_success_at": "2026-10-23T09:02:11.000Z"      },      "created_at": "2026-10-23T08:41:12.000Z",      "updated_at": "2026-10-23T08:41:12.000Z"    }  ]}

Get a method

A method’s full contract at the version your organization uses (or @N for one version): input and output schema, an example, auth, cost, how it stands (status, repair), its versions and what the latest changes. With wait, the answer is held while the version is under repair; with seen (the status:revision:deletes_at of the last read) while nothing about it has changed. Free.

Path parameters

/v1/methods/{domain}/{name}

domainstringrequired
The site of the method’s slug.
namestringrequired
The name of the method’s slug.

/v1/methods/{id}

idstringrequired
The method’s id (mth_…).

Query parameters

waitintegerdefault 0Optional
Seconds to hold the answer while the version is under repair (or, with seen, while nothing has changed), 0 to 60.
seenstringOptional
What was last read, as <status>:<revision>:<deletes_at or ->; with wait, the answer is held until it differs.

Returns

A MethodDetail object.

200The method.

Errors

Status	Code	When
404	`not_found`	No such method, or no such version of it

curl 'https://api.fous.com/v1/methods/date.nager.at/list_public_holidays' \  -H "Authorization: Bearer $FOUS_API_KEY"

// Save as fous.mts, then run: npx tsx fous.mtsconst response = await fetch('https://api.fous.com/v1/methods/date.nager.at/list_public_holidays', {  headers: {    Authorization: `Bearer ${process.env.FOUS_API_KEY}`,  },});const result = await response.json();if (!response.ok) throw new Error(`${result.error.code}: ${result.error.message}`);console.log(result);

import osimport requestsresponse = requests.get(    "https://api.fous.com/v1/methods/date.nager.at/list_public_holidays",    headers={        "Authorization": f"Bearer {os.environ['FOUS_API_KEY']}",    },    timeout=180,)result = response.json()if not response.ok:    raise RuntimeError(f"{result['error']['code']}: {result['error']['message']}")print(result)

Sent with your key, kept for this tab only. A run uses credits like any call.

{  "id": "mth_01m5kvvywdeac8fxs7nh0sw68w",  "slug": "date.nager.at/list_public_holidays",  "name": "List public holidays",  "description": "Lists a country's public holidays for a year from Nager.Date, with local names, regional coverage and holiday types.",  "returns": "date, weekday, English and local names, regions, type, nationwide flag",  "platform": {    "name": "Nager.Date",    "domain": "nager.at"  },  "input_schema": {    "type": "object",    "required": [      "country"    ],    "properties": {      "year": {        "type": "integer",        "minimum": 1,        "maximum": 9999,        "description": "Calendar year, for example 2026. Defaults to the current year."      },      "country": {        "type": "string",        "description": "Country name or two-letter country code, for example Germany or DE."      }    }  },  "effect": "read",  "auth": {    "required": false  },  "cost": {    "credits": 1  },  "version": 2,  "latest_version": 2,  "revision": 1,  "pinned_version": null,  "status": "ready",  "versions": [    {      "version": 2,      "revision": 1,      "latest": true,      "status": "ready",      "created_at": "2026-10-22T16:02:41.000Z",      "changes": "Adds output holidays[].regions."    },    {      "version": 1,      "revision": 2,      "status": "ready",      "created_at": "2026-10-21T09:12:05.000Z",      "revised_at": "2026-10-24T03:10:19.000Z",      "changes": ""    }  ],  "visibility": "public",  "output_schema": {    "type": "object",    "properties": {      "country_name": {        "type": "string"      },      "year": {        "type": "integer"      },      "holidays": {        "type": "array",        "items": {          "type": "object"        }      }    }  },  "example": {    "input": {      "country": "Germany",      "year": 2027    },    "output": {      "country_name": "Germany",      "year": 2027,      "holidays": [        {          "date": "2027-01-01",          "weekday": "Friday",          "english_name": "New Year's Day",          "local_name": "Neujahr",          "nationwide": "yes",          "regions": [],          "type": "Public"        }      ]    }  },  "stats": {    "success_rate": 1,    "runs": 12,    "last_success_at": "2026-10-23T08:24:36.410Z"  },  "owned": false}

{  "error": {    "code": "not_found",    "message": "No version 9 of date.nager.at/list_public_holidays. Its versions are 1–2.",    "next_step": "Name one of them (date.nager.at/list_public_holidays@N), or none for the version your organization uses.",    "param": "method",    "latest_version": 2,    "doc_url": "https://docs.fous.com/guides/errors#not_found",    "request_id": "req_mh7c2k9xQ1v3Zt8LbN0pRwY4"  }}

Update a method

{"pinned_version": N} switches your organization to version N of any method it sees: runs and queries use it from then on. {"visibility": "public"} publishes your organization’s method: anyone may then find, run and improve it; a public method stays public. Owners and admins.

Path parameters

/v1/methods/{domain}/{name}

domainstringrequired
The site of the method’s slug.
namestringrequired
The name of the method’s slug.

/v1/methods/{id}

idstringrequired
The method’s id (mth_…).

Request body

Required, JSON. One of:

Switch version

pinned_versionintegerrequired
The version your organization switches to.

Publish

visibilitystringrequired
"public" publishes the method. There is no way back: others may come to rely on it.
public

Returns

A MethodDetail object.

200The method, as your organization now sees it.

Errors

Status	Code	When
400	`invalid_request`	Neither {"pinned_version": N} nor {"visibility": "public"}
403	`forbidden`	Only owners and admins change methods and builds
404	`not_found`	No such method, or no such version of it
409	`conflict`	Publishing: not your organization’s method (reason not_owned), or another public method has its name

Switch version

curl 'https://api.fous.com/v1/methods/date.nager.at/list_public_holidays' \  -X PATCH \  -H "Authorization: Bearer $FOUS_API_KEY" \  -H 'Content-Type: application/json' \  -d '{    "pinned_version": 1  }'

// Save as fous.mts, then run: npx tsx fous.mtsconst response = await fetch('https://api.fous.com/v1/methods/date.nager.at/list_public_holidays', {  method: 'PATCH',  headers: {    Authorization: `Bearer ${process.env.FOUS_API_KEY}`,    'Content-Type': 'application/json',  },  body: JSON.stringify({    pinned_version: 1  }),});const result = await response.json();if (!response.ok) throw new Error(`${result.error.code}: ${result.error.message}`);console.log(result);

import osimport requestsresponse = requests.patch(    "https://api.fous.com/v1/methods/date.nager.at/list_public_holidays",    headers={        "Authorization": f"Bearer {os.environ['FOUS_API_KEY']}",    },    json={        "pinned_version": 1    },    timeout=180,)result = response.json()if not response.ok:    raise RuntimeError(f"{result['error']['code']}: {result['error']['message']}")print(result)

Sent with your key, kept for this tab only. A run uses credits like any call.

Publish

curl 'https://api.fous.com/v1/methods/date.nager.at/list_public_holidays' \  -X PATCH \  -H "Authorization: Bearer $FOUS_API_KEY" \  -H 'Content-Type: application/json' \  -d '{    "visibility": "public"  }'

// Save as fous.mts, then run: npx tsx fous.mtsconst response = await fetch('https://api.fous.com/v1/methods/date.nager.at/list_public_holidays', {  method: 'PATCH',  headers: {    Authorization: `Bearer ${process.env.FOUS_API_KEY}`,    'Content-Type': 'application/json',  },  body: JSON.stringify({    visibility: 'public'  }),});const result = await response.json();if (!response.ok) throw new Error(`${result.error.code}: ${result.error.message}`);console.log(result);

import osimport requestsresponse = requests.patch(    "https://api.fous.com/v1/methods/date.nager.at/list_public_holidays",    headers={        "Authorization": f"Bearer {os.environ['FOUS_API_KEY']}",    },    json={        "visibility": "public"    },    timeout=180,)result = response.json()if not response.ok:    raise RuntimeError(f"{result['error']['code']}: {result['error']['message']}")print(result)

Sent with your key, kept for this tab only. A run uses credits like any call.

{  "id": "mth_01m5kvvywdeac8fxs7nh0sw68w",  "slug": "date.nager.at/list_public_holidays",  "name": "List public holidays",  "description": "Lists a country's public holidays for a year from Nager.Date, with local names, regional coverage and holiday types.",  "returns": "date, weekday, English and local names, regions, type, nationwide flag",  "platform": {    "name": "Nager.Date",    "domain": "nager.at"  },  "input_schema": {    "type": "object",    "required": [      "country"    ],    "properties": {      "year": {        "type": "integer",        "minimum": 1,        "maximum": 9999,        "description": "Calendar year, for example 2026. Defaults to the current year."      },      "country": {        "type": "string",        "description": "Country name or two-letter country code, for example Germany or DE."      }    }  },  "effect": "read",  "auth": {    "required": false  },  "cost": {    "credits": 1  },  "version": 1,  "latest_version": 2,  "revision": 2,  "pinned_version": 1,  "status": "ready",  "versions": [    {      "version": 2,      "revision": 1,      "latest": true,      "status": "ready",      "created_at": "2026-10-22T16:02:41.000Z",      "changes": "Adds output holidays[].regions."    },    {      "version": 1,      "revision": 2,      "status": "ready",      "created_at": "2026-10-21T09:12:05.000Z",      "revised_at": "2026-10-24T03:10:19.000Z",      "changes": "",      "pinned": true    }  ],  "visibility": "public",  "output_schema": {    "type": "object",    "properties": {      "country_name": {        "type": "string"      },      "year": {        "type": "integer"      },      "holidays": {        "type": "array",        "items": {          "type": "object"        }      }    }  },  "example": {    "input": {      "country": "Germany",      "year": 2027    },    "output": {      "country_name": "Germany",      "year": 2027,      "holidays": [        {          "date": "2027-01-01",          "weekday": "Friday",          "english_name": "New Year's Day",          "local_name": "Neujahr",          "nationwide": "yes",          "regions": [],          "type": "Public"        }      ]    }  },  "stats": {    "success_rate": 1,    "runs": 12,    "last_success_at": "2026-10-23T08:24:36.410Z"  },  "owned": false,  "latest_changes": "Adds output holidays[].regions."}

{  "error": {    "code": "invalid_request",    "message": "Send {\"pinned_version\": N} to switch your organization to version N, or {\"visibility\": \"public\"} to publish.",    "doc_url": "https://docs.fous.com/guides/errors#invalid_request",    "request_id": "req_mh7c2k9xQ1v3Zt8LbN0pRwY4"  }}

Delete a method

Deletes your organization’s private method: it no longer runs, and its versions stay for the record. A public method stays, since others may run it. Owners and admins.

Path parameters

/v1/methods/{domain}/{name}

domainstringrequired
The site of the method’s slug.
namestringrequired
The name of the method’s slug.

/v1/methods/{id}

idstringrequired
The method’s id (mth_…).

Returns

200Deleted.

The answer has these fields:

idstring
deletedboolean

Errors

Status	Code	When
403	`forbidden`	Only owners and admins change methods and builds
404	`not_found`	No such method
409	`conflict`	A public method, or not your organization’s (reason not_owned)

curl 'https://api.fous.com/v1/methods/crates.io/search_crates' \  -X DELETE \  -H "Authorization: Bearer $FOUS_API_KEY"

// Save as fous.mts, then run: npx tsx fous.mtsconst response = await fetch('https://api.fous.com/v1/methods/crates.io/search_crates', {  method: 'DELETE',  headers: {    Authorization: `Bearer ${process.env.FOUS_API_KEY}`,  },});const result = await response.json();if (!response.ok) throw new Error(`${result.error.code}: ${result.error.message}`);console.log(result);

import osimport requestsresponse = requests.delete(    "https://api.fous.com/v1/methods/crates.io/search_crates",    headers={        "Authorization": f"Bearer {os.environ['FOUS_API_KEY']}",    },    timeout=180,)result = response.json()if not response.ok:    raise RuntimeError(f"{result['error']['code']}: {result['error']['message']}")print(result)

Sent with your key, kept for this tab only. A run uses credits like any call.

{  "id": "mth_01m5kz9a1b2c3d4e5f6g7h8j9k",  "deleted": true}

{  "error": {    "code": "forbidden",    "message": "Only an owner or admin can change methods.",    "doc_url": "https://docs.fous.com/guides/errors#forbidden",    "request_id": "req_mh7c2k9xQ1v3Zt8LbN0pRwY4"  }}