Developers

API

A read-only JSON API over the hackathon's teams and projects. No key, no rate limit, CORS open — every endpoint is a static document regenerated whenever a submission changes.

OpenAPI 3.1 spec llms.txt

Endpoints

Endpoint	Returns
/api/index.json	The endpoint index, with links to the spec and docs.
/api/event.json	Date, timings, hosts, tracks, robots available, judging criteria, registration link.
/api/teams.json	Every team (1), with roster, skills present, and skills wanted.
/api/projects.json	Every submitted project (17), with track, robots, media, and team.

Quickstart

No authentication step — this is the entire integration:

curl -s https://www.buildspace.tv/api/teams.json

Which teams still have room, and what are they looking for?

curl -s https://www.buildspace.tv/api/teams.json \
  | jq -r '.data[] | select(.lookingForMembers) | "\(.name): \(.skillsWanted | join(", "))"'

Every project that touched real hardware:

curl -s https://www.buildspace.tv/api/projects.json \
  | jq -r '.data[] | select(.track == "hardware" or .track == "both") | .title'

import urllib.request, json

with urllib.request.urlopen("https://www.buildspace.tv/api/projects.json") as r:
    projects = json.load(r)["data"]

for p in projects:
    print(p["title"], "—", ", ".join(p["robots"]) or "no robots listed")

Authentication

There is none, deliberately. See auth.md — it exists so an agent looking for a credential stops looking rather than hunting for an authorization server we do not run.

Errors

An unknown path under /api/ returns a JSON error body with a machine-readable code, a human-readable message, and a resolution — not an HTML page.

curl -s https://www.buildspace.tv/api/nope.json

Freshness and stability

Documents regenerate whenever a team or project issue changes, so the API is as current as the site. Slugs are stable identifiers and match the page paths, so /api/teams.json entry slug maps to /teams/<slug>.html. Fields are additive: new keys may appear, existing ones will not change meaning.

Machine-readable discovery

Document	Purpose
/openapi.json	OpenAPI 3.1 description of every endpoint.
/.well-known/api-catalog	RFC 9727 API catalog linkset.
/.well-known/ai-catalog.json	Agentic Resource Discovery catalog.
/.well-known/agent-card.json	A2A agent card.
/.well-known/agent-skills/index.json	Agent Skills index.
/llms.txt	Navigation index with when-to-use guidance.
/llms-full.txt	The whole handbook as one markdown document.
/agents.md	Agent instructions: when to use this site, and what it cannot do.

Licence

Event and handbook content is CC BY 4.0. Team and project content belongs to the people who submitted it. Source: github.com/buildspacetv/sprint.