Skip to main content

Base URL

All API requests should be made to:

Authentication

The Structify API uses Bearer token authentication. Include your API key in the Authorization header:

Obtaining an API Key

  1. Log into the Structify Dashboard
  2. Navigate to Settings → API Keys
  3. Click “Create New Key”
  4. Copy the key immediately (it won’t be shown again)
Keep your API keys secure. Never commit them to version control or expose them in client-side code.

Request Format

Headers

All requests should include these headers:

Request Body

POST and PUT requests should send JSON:

Response Format

Success Response

Successful responses return HTTP 200-299 with JSON:

Error Response

Errors return appropriate HTTP status codes with details:

Status Codes

Rate Limiting

API requests are rate limited per API key:
  • Standard: 1000 requests per minute
  • Pro: 5000 requests per minute
  • Enterprise: Custom limits
Rate limit headers are included in responses:

Pagination

List endpoints support pagination via query parameters:
Paginated responses include metadata:

WebSocket API

Real-time updates via WebSocket connection:

Event Types

  • workflow.started - Workflow execution began
  • workflow.node.complete - Node finished executing
  • workflow.completed - Workflow finished
  • workflow.failed - Workflow encountered error

API Versioning

The API is versioned via the URL path:
  • Current: /v1/
  • Legacy: /v0/ (deprecated)
We maintain backwards compatibility within major versions. Breaking changes require a new major version.

SDK Libraries

Official SDKs handle authentication and provide type safety:

Python SDK

TypeScript SDK

OpenAPI Specification

The complete API specification is available in OpenAPI 3.0 format: You can use this specification with tools like:
  • Postman: Import for testing
  • Swagger Codegen: Generate client libraries
  • OpenAPI Generator: Create SDKs

Next Steps

Authentication

Learn about authentication methods

Endpoints

Explore available endpoints

Python SDK

Get started with Python

TypeScript SDK

Build with TypeScript