Getting started

The SeekrFlow API provides programmatic access to train, validate, deploy, and manage AI models. You can use the API to build applications across financial services, customer support, risk management, and compliance workflows. This guide shows you how to authenticate and make your first API request. To use the Python SDK instead, see the Developer Guide.

Prerequisites

Before you begin, you need a SeekrFlow account. If you don’t have one, sign up for SeekrFlow.

Get your API key

From the user menu, go to My Account.

From the My Account page, go to API Key.

Generate and copy a new key.

Keep your API key secure. Don’t share it in publicly accessible areas such as GitHub, client-side code, or support channels.

Base URL

All API requests use this base URL:

https://flow.seekr.com/v1

Authentication

All API requests require authentication. Include your API key in the Authorization header:

Authorization: YOUR_API_KEY

Selecting a team

Resources belong to a team. To scope a request to a specific team, include the x-team-id header with the team’s ID:

x-team-id: YOUR_TEAM_ID

If you omit the header, the request uses your personal workspace. You can find your team IDs on the Teams Settings page in the SeekrFlow web interface. For the underlying access model, see Role-based access control.

Request and response format

For POST and PUT requests, send data as JSON and include the Content-Type header:

curl --location 'https://flow.seekr.com/v1/flow/agents/create' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: YOUR_API_KEY' \
--data '{
  "name": "EXAMPLE",
  "instructions": "EXAMPLE",
  "tools": [
    {
      "name": "web_search",
      "tool_env": {
        "WEB_SEARCH_TOOL_DESCRIPTION": "TESTING"
      }
    }
  ],
  "model_id": "43"
}'

All responses use JSON format. Each endpoint’s response schema is documented in the SeekrFlow API.

Versioning

The API version is included in the URL path (v1). When breaking changes are introduced:

A new API version is released.
The current version continues to function.
You receive notification with migration timelines before deprecation.

This approach ensures your application continues to work while you migrate to a new version.

Overview

Endpoints

Getting started

Prerequisites

Get your API key

Base URL

Authentication

Selecting a team

Request and response format

Versioning

​Prerequisites

​Get your API key

​Base URL

​Authentication

​Selecting a team

​Request and response format

​Versioning

Prerequisites

Get your API key

Base URL

Authentication

Selecting a team

Request and response format

Versioning