Windsurf website screenshot

Windsurf

Windsurf (formerly Codeium) is an AI-native code editor featuring Cascade, an autonomous AI agent that can plan multi-step code changes, execute terminal commands, read linter output, and modify files across entire projects. The .windsurfrules file format provides project-specific configuration for the Cascade AI assistant, defining coding conventions, standards, and behavioral instructions. Windsurf offers an Enterprise API for querying code completion analytics, Cascade AI usage, billing configuration, and team management.

Windsurf publishes 3 APIs on the APIs.io network: analytics API, billing API, and teams API. Tagged areas include AI Agents, AI Copilot, Coding Standards, Developer Workflow, and IDE.

The Windsurf catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

Windsurf’s developer surface includes documentation, API reference, changelog, engineering blog, pricing, and 13 more developer resources.

🌐 Visit website 📡 Source on GitHub
48.9/100 developing ▬ flat Agent 29/100 agent aware Full breakdown ↓
scored 2026-08-05 · rubric v0.9.1
AccessFreemium
3 APIs
AI AgentsAI CopilotCoding StandardsDeveloper WorkflowIDEWindsurf

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-05 · rubric v0.9.1
Composite quality — 48.9/100 · developing
Contract Quality 16.7 / 25
Developer Ergonomics 3.5 / 20
Commercial Clarity 10.0 / 20
Operational Transparency 6.8 / 13
Governance 4.5 / 12
Discoverability 7.4 / 10
Agent readiness — 29/100 · agent aware
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/windsurfrules: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 3

Individual APIs this provider publishes, each with its own machine-readable definition.

Windsurf analytics API

Code completion and Cascade AI usage analytics

Windsurf billing API

Usage configuration and credit balance management

Windsurf teams API

Team and user analytics

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Windsurf Enterprise API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Windsurfrules Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Windsurfrules Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Windsurfrules Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Windsurfrules Context

12 classes · 13 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

Windsurf API Rules

8 rules · 3 errors 4 warnings 1 info

SPECTRAL

Windsurf API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 1

Standalone JSON Schema definitions for this provider's data models.

AnalyticsRequest

5 properties

JSON SCHEMA

Examples 1

Example request and response payloads for these APIs.

Windsurf Query Analytics Example

6 fields

EXAMPLE

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Windsurfrules Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Windsurfrules Vulnerability Disclosure

disclosure policy published

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Windsurfrules Agentic Access

6 operations · 6 acting

6 operations · 6 acting

AGENTIC

Resources

Documentation 2

Reference material describing how the API behaves

Documentation
Documentation
 APIReference
APIReference

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess
 LlmsText
LlmsText

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

JSONLDContext
JSONLDContext
 Vocabulary
Vocabulary

Build 3

SDKs, sample code, and the tooling you integrate with

GitHubOrg
GitHubOrg
 GitHubRepo
GitHubRepo
 VSCodeExtension
VSCodeExtension

Access & Security 2

Authentication, authorization, and security posture

VulnerabilityDisclosure
VulnerabilityDisclosure
 DomainSecurity
DomainSecurity

Operate 2

Status, limits, changes, and where to get help

ChangeLog
ChangeLog
 Discord
Discord

Commercial 1

Pricing, plans, and the legal terms of use

Pricing
Pricing

Company 2

The organization behind the API

Website
Website
 Blog
Blog

Other 2

Properties that don't map to a standard resource type

Download
Download
 X
X

Source (apis.yml)

apis.yml Raw ↑ 
aid: windsurfrules
name: Windsurf
description: Windsurf (formerly Codeium) is an AI-native code editor featuring Cascade, an autonomous AI agent that can plan
  multi-step code changes, execute terminal commands, read linter output, and modify files across entire projects. The .windsurfrules
  file format provides project-specific configuration for the Cascade AI assistant, defining coding conventions, standards,
  and behavioral instructions. Windsurf offers an Enterprise API for querying code completion analytics, Cascade AI usage,
  billing configuration, and team management.
type: Index
accessModel:
  pricing: freemium
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Freemium
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
position: Consumer
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/windsurfrules.png
tags:
- AI Agents
- AI Copilot
- Coding Standards
- Developer Workflow
- IDE
- Windsurf
created: '2025'
modified: '2026-05-19'
url: https://raw.githubusercontent.com/api-evangelist/windsurfrules/refs/heads/main/apis.yml
specificationVersion: '0.19'
apis:
- aid: windsurfrules:windsurfrules-analytics-api
  name: Windsurf analytics API
  description: Code completion and Cascade AI usage analytics
  humanURL: https://docs.windsurf.com/plugins/accounts/api-reference/api-introduction
  baseURL: https://server.codeium.com/api/v1
  tags:
  - analytics
  properties:
  - type: OpenAPI
    url: openapi/windsurfrules-analytics-api-openapi.yml
  - type: Documentation
    url: https://docs.windsurf.com/plugins/accounts/api-reference/api-introduction
- aid: windsurfrules:windsurfrules-billing-api
  name: Windsurf billing API
  description: Usage configuration and credit balance management
  humanURL: https://docs.windsurf.com/plugins/accounts/api-reference/api-introduction
  baseURL: https://server.codeium.com/api/v1
  tags:
  - billing
  properties:
  - type: OpenAPI
    url: openapi/windsurfrules-billing-api-openapi.yml
  - type: Documentation
    url: https://docs.windsurf.com/plugins/accounts/api-reference/api-introduction
- aid: windsurfrules:windsurfrules-teams-api
  name: Windsurf teams API
  description: Team and user analytics
  humanURL: https://docs.windsurf.com/plugins/accounts/api-reference/api-introduction
  baseURL: https://server.codeium.com/api/v1
  tags:
  - teams
  properties:
  - type: OpenAPI
    url: openapi/windsurfrules-teams-api-openapi.yml
  - type: Documentation
    url: https://docs.windsurf.com/plugins/accounts/api-reference/api-introduction
common:
- type: AgenticAccess
  url: agentic-access/windsurfrules-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/windsurfrules-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/windsurfrules-domain-security.yml
- type: Website
  url: https://windsurf.com
- type: Documentation
  url: https://docs.windsurf.com
- type: APIReference
  url: https://docs.windsurf.com/plugins/accounts/api-reference/api-introduction
- type: ChangeLog
  url: https://windsurf.com/changelog
- type: Blog
  url: https://windsurf.com/blog
- type: Pricing
  url: https://windsurf.com/pricing
- type: Download
  url: https://windsurf.com/download
- type: GitHubOrg
  url: https://github.com/Exafunction
- type: GitHubRepo
  url: https://github.com/Exafunction/windsurf.nvim
- type: VSCodeExtension
  url: https://marketplace.visualstudio.com/items?itemName=Codeium.CodeiumVS
- type: X
  url: https://x.com/codeiumdev
- type: Discord
  url: https://discord.gg/3XFf78nAx5
- type: JSONLDContext
  url: https://raw.githubusercontent.com/api-evangelist/windsurfrules/refs/heads/main/json-ld/windsurfrules-context.jsonld
- type: Vocabulary
  url: https://raw.githubusercontent.com/api-evangelist/windsurfrules/refs/heads/main/vocabulary/windsurfrules-vocabulary.yml
- type: Integrations
  url: https://windsurf.com/integrations
- type: LlmsText
  url: https://docs.windsurf.com/llms.txt
integrations:
- name: JetBrains Plugin
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com