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 Admin API

The Admin API from Insforge — 54 operation(s) for admin.

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

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

This API exposes 80 operations across 54 paths, and defines 51 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.

80 operations 54 paths 51 schemas 10 DELETE35 GET2 PATCH23 POST10 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 Admin API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth).

Paths & Operations 80

Across 54 paths, the API surfaces 80 operations — 10 DELETE, 35 GET, 2 PATCH, 23 POST, 10 PUT. Each is listed below with its method, path, parameters, and response codes.

Admin 80
GET
/api/ai/models
Get all available AI models
→ 200401500
GET
/api/ai/overview
Get Model Gateway overview
→ 200401500
GET
/api/ai/{provider}/api-key
Get active provider API key
1 param → 200400401500
POST
/api/ai/{provider}/api-key/rotate
Rotate provider API key
1 param → 200400401500
GET
/api/auth/config
Get authentication configuration
→ 200401403
PUT
/api/auth/config
Update authentication configuration
body → 200400401403
GET
/api/auth/users
List all users (admin only)
3 params → 200401403
DELETE
/api/auth/users
Delete users (admin only)
body → 200401403
GET
/api/auth/users/{userId}
Get specific user
1 param → 200400401403404
POST
/api/auth/admin/sessions
Admin login
body → 200401403
POST
/api/auth/admin/sessions/exchange
Exchange cloud provider authorization code for admin session
body → 200400
POST
/api/auth/admin/refresh
Refresh admin dashboard access token
1 param → 200401403
POST
/api/auth/admin/logout
Logout admin dashboard session
1 param → 200403
POST
/api/auth/tokens/anondeprecated
Get anon key (deprecated)
→ 200401403404
GET
/api/auth/oauth/configs
List all OAuth configurations
→ 200401403
POST
/api/auth/oauth/configs
Create OAuth configuration
body → 200400401403
GET
/api/auth/oauth/{provider}/config
Get OAuth configuration for specific provider
1 param → 200401403404
PUT
/api/auth/oauth/{provider}/config
Update OAuth configuration
1 param body → 200400401403404
DELETE
/api/auth/oauth/{provider}/config
Delete OAuth configuration
1 param → 200401403404
GET
/api/auth/oauth/custom/configs
List all custom OAuth configurations
→ 200401403
POST
/api/auth/oauth/custom/configs
Create custom OAuth configuration
body → 200400401403409
GET
/api/auth/oauth/custom/{key}/config
Get custom OAuth configuration
1 param → 200401403404
PUT
/api/auth/oauth/custom/{key}/config
Update custom OAuth configuration
1 param body → 200400401403404
DELETE
/api/auth/oauth/custom/{key}/config
Delete custom OAuth configuration
1 param → 200401403404
GET
/api/auth/admin/sessions/current
Get current admin session
→ 200401403
GET
/api/auth/smtp-config
Get SMTP configuration
→ 200401403
PUT
/api/auth/smtp-config
Update SMTP configuration
body → 200400401403
GET
/api/auth/email-templates
Get all email templates
→ 200401403
PUT
/api/auth/email-templates/{type}
Update email template
1 param body → 200400401403
GET
/api/deployments
List deployments
2 params → 200206401403500
POST
/api/deploymentsdeprecated
Create legacy deployment session (deprecated)
→ 201401403503500
POST
/api/deployments/direct
Create direct-upload deployment session
body → 201400401403503500
GET
/api/deployments/metadata
Get deployment metadata
→ 200401403500
PUT
/api/deployments/slug
Update InsForge-hosted slug
body → 200400409401403500
GET
/api/deployments/env-vars
List deployment environment variables
→ 200401403503500
POST
/api/deployments/env-vars
Create or update deployment environment variables
body → 201400401403503500
GET
/api/deployments/env-vars/{id}
Get deployment environment variable
1 param → 200401403404503500
DELETE
/api/deployments/env-vars/{id}
Delete deployment environment variable
1 param → 200401403404503500
GET
/api/deployments/domains
List custom domains
→ 200401403503500
POST
/api/deployments/domains
Add custom domain
body → 201400401403503500
POST
/api/deployments/domains/{domain}/verify
Verify custom domain
1 param → 200400401403404503500
DELETE
/api/deployments/domains/{domain}
Remove custom domain
1 param → 200400401403404503500
GET
/api/deployments/{id}
Get deployment
1 param → 200401403404500
PUT
/api/deployments/{id}/files/{fileId}/content
Upload direct deployment file content
2 params body → 200400401403404415429500
POST
/api/deployments/{id}/start
Start deployment
1 param body → 200400401403404429500
POST
/api/deployments/{id}/sync
Sync deployment status
1 param → 200400401403404500
POST
/api/deployments/{id}/cancel
Cancel deployment
1 param → 200401403404429500
GET
/api/functions
List all functions
→ 200401403500
POST
/api/functions
Create new function
body → 201400409500
GET
/api/functions/{slug}
Get function details
1 param → 200404401403500
PUT
/api/functions/{slug}
Update function
1 param body → 200400404500
DELETE
/api/functions/{slug}
Delete function
1 param → 200404500
GET
/api/logs
List activity logs
4 params → 200
DELETE
/api/logs
Clear logs
1 param → 200400
GET
/api/logs/stats
Get logs statistics
→ 200
GET
/api/metadata
Get app metadata
1 param → 200400401403
GET
/api/metadata/database
Get database metadata
→ 200401
GET
/api/metadata/api-key
Get API key
→ 200403
GET
/api/metadata/anon-key
Get anon key
→ 200403404
GET
/api/secrets
List all secrets
→ 200401403
POST
/api/secrets
Create a new secret
body → 201400409
GET
/api/secrets/{key}
Get secret value
1 param → 200404401403
PUT
/api/secrets/{key}
Update secret
1 param body → 200404500
DELETE
/api/secrets/{key}
Delete secret
1 param → 200403404
POST
/api/secrets/api-key/rotate
Rotate API key
body → 200400401403
POST
/api/secrets/anon-key/rotate
Rotate anon key
body → 200400403
GET
/api/storage/config
Get storage configuration
→ 200401403
PUT
/api/storage/config
Update storage configuration
body → 200400401403
GET
/api/storage/buckets
List All Buckets
→ 200
POST
/api/storage/buckets
Create New Bucket
body → 201400409
DELETE
/api/storage/buckets/{bucketName}
Delete Bucket
1 param → 200404
PATCH
/api/storage/buckets/{bucketName}
Update Bucket
1 param body → 200404
GET
/api/storage/buckets/{bucketName}/objects
List Objects in Bucket
5 params → 200
GET
/api/database/tables
List Tables
→ 200
POST
/api/database/tables
Create Table
body → 201400422
GET
/api/database/tables/{tableName}/schema
Get Table Schema
1 param → 200404
PATCH
/api/database/tables/{tableName}/schema
Update Table Schema
1 param body → 200400404
DELETE
/api/database/tables/{tableName}
Delete Table
1 param → 200404
GET
/api/database/migrations
List Database Migrations
→ 200
POST
/api/database/migrations
Create and Execute Database Migration
body → 201400409

Schemas 51

The contract defines 51 schemas that model the data the API accepts and returns. The most detailed are SmtpConfig (11 properties), AIModel (10 properties), Deployment (8 properties), FunctionMetadata (8 properties). Each schema is shown below with its type and property counts.

GetEnvVarResponse
object
1 property 1 required
ListCustomDomainsResponse
object
1 property 1 required
AIOverviewMetricPoint
object
2 properties
DeleteResponse
object
2 properties 2 required
UpsertEnvVarsResponse
object
3 properties 3 required
UserResponse
object
8 properties
UpdateSlugResponse
object
3 properties 3 required
ErrorResponse_8
object
4 properties 3 required
CustomOAuthConfig
object
7 properties
ListModelsResponse
array
Normalized OpenRouter model catalog returned by GET /api/ai/models.
DeploymentManifestFileUploaded
UpdateSlugRequest
object
1 property 1 required
SmtpConfig
object
11 properties
EmailTemplate
object
6 properties
FunctionDetails
CreateDirectDeploymentResponse
object
3 properties 3 required
ForeignKeyConstraint
object
A table-level foreign key constraint. One entry per constraint; composite keys list multiple column mappings.
5 properties 4 required
DeploymentEnvVar
object
4 properties 3 required
UpsertEnvVarsRequest
object
1 property 1 required
OAuthConfig
object
8 properties
OpenRouterKeyResponse
object
2 properties
DomainVerificationRecord
object
3 properties 3 required
StartDeploymentRequest
object
3 properties
DeploymentStatus
string
AIModel
object
10 properties
DeploymentMetadata
object
3 properties 3 required
ListEnvVarsResponse
object
1 property 1 required
Deployment
object
8 properties 8 required
CustomDomain
object
7 properties 7 required
StorageConfig
object
4 properties 4 required
ProjectSettings
object
5 properties
ErrorResponse_7
object
4 properties 3 required
DeploymentManifestFile
FunctionMetadata
object
8 properties 6 required
ProjectAdminResponse
object
2 properties 2 required
EnvVarInput
object
2 properties 2 required
ErrorResponse_3
object
4 properties
AddCustomDomainRequest
object
1 property 1 required
AIOverview
object
2 properties
ErrorResponse
object
4 properties 3 required
DeploymentEnvVarWithValue
SecretMetadata
object
7 properties 6 required
ErrorResponse_4
object
4 properties 3 required
ErrorResponse_5
object
4 properties 3 required
ErrorResponse_6
object
4 properties 3 required
StoredFile
object
6 properties 5 required
CreateDeploymentResponse
object
3 properties 3 required
Migration
object
4 properties 4 required
DeploymentManifestFileEntry
object
3 properties 3 required
CreateDirectDeploymentRequest
object
1 property 1 required
ErrorResponse_2
object
4 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

insforge-admin-api-openapi.yml Raw ↑

Other APIs Insforge publishes across the network.

Insforge Channels API
Insforge Client 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