Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Insforge Client API

The Client API from Insforge — 35 operation(s) for client.

Insforge Client API is one of 11 APIs that Insforge publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Client. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 46 operations across 35 paths, and defines 28 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against the base URL https://api.insforge.dev.

46 operations 35 paths 28 schemas 4 DELETE15 GET3 PATCH22 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://api.insforge.dev
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Insforge Client API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth).

Paths & Operations 46

Across 35 paths, the API surfaces 46 operations — 4 DELETE, 15 GET, 3 PATCH, 22 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Client 46
POST
/api/ai/chat/completiondeprecated
Generate chat completion (deprecated)
body → 200400401500
POST
/api/ai/image/generationdeprecated
Generate images (deprecated)
body → 200400401500
POST
/api/ai/embeddingsdeprecated
Generate embeddings (deprecated)
body → 200400401500
GET
/api/auth/public-config
Get public authentication configuration
→ 200
PATCH
/api/auth/profiles/current
Update current user's profile
body → 200400401
GET
/api/auth/profiles/{userId}
Get user profile by ID
1 param → 200400404
POST
/api/auth/users
Register new user
1 param body → 200400403409
POST
/api/auth/sessions
User login
1 param body → 200401403
POST
/api/auth/refresh
Refresh access token
2 params body → 200401403
POST
/api/auth/logout
Logout user
2 params → 200403
GET
/api/auth/sessions/current
Get current session
→ 200401
POST
/api/auth/email/send-verification
Send email verification (code or link based on config)
body → 202400
GET
/api/auth/email/verify-link
Verify email from browser link click
1 param → 302400
POST
/api/auth/email/verify
Verify email with code
1 param body → 200400401
POST
/api/auth/email/send-reset-password
Send password reset (code or link based on config)
body → 202400
POST
/api/auth/email/exchange-reset-password-token
Exchange reset password code for reset token
body → 200400401
GET
/api/auth/email/reset-password-link
Open password reset flow from browser link click
1 param → 302400
POST
/api/auth/email/reset-password
Reset password with token
body → 200400401
GET
/api/auth/oauth/{provider}
Initiate OAuth flow (PKCE)
3 params → 200400500
POST
/api/auth/oauth/exchange
Exchange OAuth code for tokens (PKCE)
1 param body → 200400401
GET
/api/auth/oauth/shared/callback/{state}
Shared OAuth callback handler
4 params → 302
GET
/api/auth/oauth/{provider}/callback
Provider-specific OAuth callback (GET)
4 params → 302
POST
/api/auth/oauth/{provider}/callback
Provider-specific OAuth callback (POST)
1 param body → 302
GET
/api/auth/oauth/custom/{key}
Initiate custom OAuth flow (PKCE)
3 params → 200400404
GET
/api/auth/oauth/custom/{key}/callback
Custom OAuth callback (GET)
3 params → 302
POST
/api/auth/id-token
Sign in with ID token (Google One Tap, native SDKs)
1 param body → 200400401
POST
/api/email/send-raw
Send raw HTML email
body → 200400401403500
GET
/functions/{slug}
Execute function (GET)
1 param → 200404502
POST
/functions/{slug}
Execute function (POST)
1 param body → 200404502
PUT
/functions/{slug}
Execute function (PUT)
1 param body → 200502
PATCH
/functions/{slug}
Execute function (PATCH)
1 param body → 200502
DELETE
/functions/{slug}
Execute function (DELETE)
1 param → 200502
GET
/api/health
Health check
→ 200
GET
/api/database/records/{tableName}
Query Records
6 params → 200404400
POST
/api/database/records/{tableName}
Create Records
2 params body → 201400404
PATCH
/api/database/records/{tableName}
Update Records
3 params body → 200404400
DELETE
/api/database/records/{tableName}
Delete Records
3 params → 204200
POST
/api/storage/buckets/{bucketName}/objects
Upload Object with Auto-Generated Key
1 param body → 201400404
DELETE
/api/storage/buckets/{bucketName}/objects
Delete Multiple Objects
1 param body → 200400403
POST
/api/storage/buckets/{bucketName}/upload-strategy
Get Upload Strategy (Direct or Presigned URL)
1 param body → 200404
PUT
/api/storage/buckets/{bucketName}/objects/{objectKey}
Upload Object
2 params body → 201400404
GET
/api/storage/buckets/{bucketName}/objects/{objectKey}
Download Object
2 params → 200404
DELETE
/api/storage/buckets/{bucketName}/objects/{objectKey}
Delete Object
2 params → 200404
POST
/api/storage/buckets/{bucketName}/objects/{objectKey}/confirm-upload
Confirm Presigned Upload
2 params body → 201404409
GET
/api/storage/buckets/{bucketName}/download-strategy/objects/{objectKey}
Get Download Strategy (Direct or Presigned URL)
2 params → 200404
POST
/api/storage/buckets/{bucketName}/objects/{objectKey}/download-strategydeprecated
Get Download Strategy (Deprecated — use GET on the canonical path)
2 params → 200404

Schemas 28

The contract defines 28 schemas that model the data the API accepts and returns. The most detailed are ChatRequest (12 properties), UserResponse (8 properties), SendRawEmailRequest (7 properties), UploadStrategy (7 properties). Each schema is shown below with its type and property counts.

UserResponse
object
8 properties
ChatRequest
object
12 properties 2 required
FunctionDefinition
object
3 properties 1 required
EmbeddingObject
object
3 properties
ImageGenerationOptions
object
2 properties 2 required
WebSearchPlugin
object
4 properties 1 required
EmbeddingsResponse
object
3 properties
ProfileResponse
object
2 properties
ChatCompletionResponse
object
4 properties
Tool
object
2 properties 2 required
SendRawEmailRequest
object
7 properties 3 required
SendEmailResponse
object
Empty object on success - extend with optional fields later if needed
DownloadStrategy
object
4 properties 2 required
TokenUsage
object
3 properties
ToolCall
object
3 properties 3 required
ChatMessage
object
4 properties 1 required
UrlCitationAnnotation
object
2 properties
UploadStrategy
object
7 properties 4 required
ProjectAdminResponse
object
2 properties 2 required
ErrorResponse_3
object
4 properties
ErrorResponse
object
4 properties 3 required
ErrorResponse_4
object
4 properties 3 required
EmbeddingsRequest
object
4 properties 2 required
ErrorResponse_5
object
4 properties 3 required
StoredFile
object
6 properties 5 required
OpenRouterImageMessage
object
2 properties
FileParserPlugin
object
2 properties 1 required
ErrorResponse_2
object
4 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

insforge-client-api-openapi.yml Raw ↑

Other APIs Insforge publishes across the network.

Insforge Admin API
Insforge Channels API
Insforge Configuration API
Insforge Messages API
Insforge Payment Webhooks API
Insforge Permissions API
Insforge Razorpay Payments API
Insforge S3 Access Keys API
Insforge S3 Protocol API
Insforge Stripe Payments API