Developer docs

Guides and a full reference for the API

developers.fetchfido.ai holds everything your developers need for the Fido External API: guides, a searchable reference of every operation and a changelog. Pages are open to read.

See how it works Common questions

  • Organizations

What you get

Developer docs, in practice.

Building something on Fido? Start with the docs. Fido left treats in the examples.

First call in four steps

Getting started walks through creating a key, sending two headers, calling /v1/whoami and reading some data, with copy-ready curl.

Keys and scopes explained

See the key tiers, who creates each, and how module:action scopes work with wildcards.

One error format

Every error returns the same JSON shape with a code, such as API_KEY_EXPIRED or RATE_LIMITED, that your code can act on.

Rate limits spelled out

The page lists default limits per key and per organization, and the Retry-After header that tells your code when to try again.

Searchable reference

The reference groups 535 operations in 23 modules, shows the scope each one needs and offers a Find a function search.

OpenAPI and changelog

Download the OpenAPI document, and read dated changelog entries that list what was added.

How it works

Follow it start to finish.

Sampledevelopers.fetchfido.ai · Lincoln ISD integration

  1. Day 1
    What you see: Dana K. creates a key in Settings, API Keys, and sends the developer the key and the Organization ID.
    What Fido does: Only an Admin or Scheduler creates keys. The key is shown once, so Dana copies it as it appears.
  2. Day 1
    What you see: The developer opens Getting started on developers.fetchfido.ai without signing in.
    What Fido does: Pages are open to read. Getting started walks through the key, two headers, /v1/whoami and a first read, with copy-ready curl.
  3. Day 1
    What you see: He sends the key and the organization ID to /v1/whoami and sees the role and scopes.
    What Fido does: Whoami confirms what the key can do before any code is built.
  4. Day 2
    What you see: He searches the reference for assignments and opens an operation to see the scope it needs.
    What Fido does: The reference groups 535 operations in 23 modules and shows the scope each one needs. Find a function searches them.
  5. Day 3
    What you see: His code reads a clear error code and waits, and he reads the changelog for new operations.
    What Fido does: Every error has one JSON shape with a code, such as RATE_LIMITED. The changelog lists additions by date.

From every seat

Every seat, a lighter day.

Admin

Before“Our developer asked me for the details of how the system worked, and I had no document to share.”

With Fido“I send the link to developers.fetchfido.ai. It has the guides, the reference and the changelog.”

Open guides, a searchable reference and a dated changelog.

Scheduler

Before“I relayed questions between our developer and the software team about what was possible.”

With Fido“Our developer reads the reference, sees the scope each operation needs and builds it.”

The reference lists every operation with its required scope.

Common questions

Asked and answered.

Where is the API reference?

At developers.fetchfido.ai/reference, open to read. It groups every operation by module, shows the scope each one needs and has a Find a function search. You can download the OpenAPI document.

How does my developer get started?

Getting started has four steps: create a key, send two headers, ask /v1/whoami who the key is, and read some data. Each step has copy-ready curl.

What does my developer need from us?

A key and the Organization ID. An organization Admin or Scheduler creates the key in Settings, API Keys, and Fido shows it once.

How do scopes work?

Each key carries scopes in a module:action form, such as read, write, edit or delete for one module. The Keys and scopes page lists the key tiers, who creates each, and how wildcards work.

What does an error look like?

Every error uses one JSON shape with a code, such as API_KEY_EXPIRED or RATE_LIMITED, that your code can act on.

What are the rate limits?

The rate-limits page lists default limits per key and per organization. A Retry-After header tells your code when to try again.

How do I see what was added?

Read the changelog. Dated entries list the operations that were added.

Which guide covers AI apps?

Connect as you explains the OAuth sign-in used by the Fido connector at mcp.fetchfido.ai.

See it with your own schedule.

Book a demo and we will walk through your own work in Fido.

Book a Demo