Skip to main content

Use the v2 surface

The public API uses the /api/v2 URL prefix. The public OpenAPI document describes available operations, request fields, response fields, and authentication. The endpoint reference in this tab is generated from that document. Keep the version prefix in your configured base URL:
Start with Search employee profiles to verify a new configuration. Use the operation reference when validating requests or generating a client.

Prepare for changes

Read the API changelog for API-specific changes. General product updates have a separate product changelog. Parse the documented response fields your application needs and handle additional response fields. Treat identifiers as opaque strings and branch on HTTP status and error codes rather than exact message text. Validate request fields against the operation’s schema. When updating a generated client or changing integration behavior, exercise your read, pagination, and error paths before switching production traffic. For questions about a specific change, contact Windmill support with the operation and a request ID if you have one.