openapi: 3.2.0 info: title: AI Squared Catalogs API version: 1.0.0 description: The AI Squared API. REST, JSON request/response bodies, JWT bearer authentication. Base URL https://api.squared.ai/api/v1/. Assembled verbatim from the per-operation OpenAPI documents AI Squared publishes on its own documentation host (docs.squared.ai/api-reference/*). servers: - url: https://api.squared.ai security: [] tags: - name: Catalogs paths: /api/v1/catalogs: post: tags: - Catalogs summary: Create catalog operationId: createCatalog requestBody: required: true content: application/json: schema: type: object properties: connector_id: type: integer example: 6 catalog: type: object properties: json_schema: type: object example: key: value responses: '200': description: Successful response content: application/json: schema: type: object properties: id: type: integer example: 123 connector_id: type: integer example: 6 workspace_id: type: integer example: 2 catalog: type: object properties: json_schema: type: object example: key: value created_at: type: string format: date-time example: '2023-08-20T15:28:00Z' updated_at: type: string format: date-time example: '2023-08-20T15:28:00Z' '400': description: Bad Request '401': description: Unauthorized '500': description: Internal Server Error security: - bearerAuth: [] /api/v1/catalogs/{id}: put: tags: - Catalogs summary: Update catalog operationId: updateCatalog parameters: - name: id in: path required: true description: The ID of the catalog to update schema: type: integer example: 34 requestBody: required: true content: application/json: schema: type: object properties: connector_id: type: integer example: 6 catalog: type: object properties: json_schema: type: object example: field: test_field responses: '200': description: Catalog updated successfully content: application/json: schema: type: object properties: data: type: object properties: id: type: string example: '34' type: type: string example: catalogs attributes: type: object properties: connector_id: type: integer example: 6 workspace_id: type: integer example: 2 catalog: type: object properties: streams: type: array items: type: object properties: name: type: string example: test_name url: type: string example: test_url json_schema: type: object example: field: test field batch_support: type: boolean example: false batch_size: type: integer example: 0 request_method: type: string example: POST request_rate_concurrency: type: integer example: 10 request_rate_limit: type: integer example: 600 request_rate_limit_unit: type: string example: minute catalog_hash: type: string example: 0755b5f0d3432bc3b0064227d2b6178d402327b9 '400': description: Bad Request '401': description: Unauthorized '404': description: Catalog not found '500': description: Internal Server Error security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT x-provenance: generated: '2026-09-13' method: searched source: https://docs.squared.ai/api-reference/ (per-operation OpenAPI documents published by AI Squared) assembly: mechanical merge of 29 provider-published OpenAPI 3.0.1 documents; every path item, parameter, requestBody, response and securityScheme is verbatim provider content. No operation, schema or example was authored by API Evangelist. ownership: info.title "AI Squared API" and servers[] https://api.squared.ai both name this provider; the documentation host docs.squared.ai is AI Squared's own (squared.ai redirects to aisquared.ai). note: AI Squared links a consolidated spec at /api-reference/openapi.yml from its llms.txt, but that path returns 404 (checked 2026-09-13); the per-operation documents embedded in each reference page are the reachable published form. operation_sources: POST /api/v1/connector_definitions/check_connection: https://docs.squared.ai/api-reference/connector_definitions/check_connection.md GET /api/v1/connector_definitions/{connector_name}: https://docs.squared.ai/api-reference/connector_definitions/connector_definition.md GET /api/v1/connector_definitions: https://docs.squared.ai/api-reference/connector_definitions/connector_definitions.md POST /api/v1/models: https://docs.squared.ai/api-reference/models/create-model.md POST /api/v1/catalogs: https://docs.squared.ai/api-reference/catalogs/create_catalog.md POST /api/v1/connectors: https://docs.squared.ai/api-reference/connectors/create_connector.md POST /api/v1/syncs: https://docs.squared.ai/api-reference/syncs/create_sync.md DELETE /api/v1/models/{id}: https://docs.squared.ai/api-reference/models/delete-model.md DELETE /api/v1/connectors/{id}: https://docs.squared.ai/api-reference/connectors/delete_connector.md DELETE /api/v1/syncs/{id}: https://docs.squared.ai/api-reference/syncs/delete_sync.md GET /api/v1/connectors/{id}/discover: https://docs.squared.ai/api-reference/connectors/discover.md GET /api/v1/models: https://docs.squared.ai/api-reference/models/get-all-models.md GET /api/v1/models/{id}: https://docs.squared.ai/api-reference/models/get-model.md GET /api/v1/connectors/{id}: https://docs.squared.ai/api-reference/connectors/get_connector.md GET /api/v1/syncs/{sync_id}/sync_runs/{sync_run_id}/sync_records: https://docs.squared.ai/api-reference/sync_records/get_sync_records.md GET /api/v1/syncs/{sync_id}/sync_runs/{sync_run_id}: https://docs.squared.ai/api-reference/sync_runs/get_sync_run.md GET /api/v1/syncs/{sync_id}/sync_runs: https://docs.squared.ai/api-reference/sync_runs/get_sync_runs.md GET /api/v1/syncs: https://docs.squared.ai/api-reference/syncs/get_syncs.md GET /api/v1/connectors: https://docs.squared.ai/api-reference/connectors/list_connectors.md DELETE /api/v1/schedule_syncs/{sync_id}: https://docs.squared.ai/api-reference/syncs/manual_sync_cancel.md POST /api/v1/schedule_syncs: https://docs.squared.ai/api-reference/syncs/manual_sync_trigger.md POST /api/v1/connectors/{id}/query_source: https://docs.squared.ai/api-reference/connectors/query_source.md GET /api/v1/syncs/{id}: https://docs.squared.ai/api-reference/syncs/show_sync.md GET /api/v1/syncs/configurations: https://docs.squared.ai/api-reference/syncs/sync_configuration.md POST /enterprise/api/v1/syncs/{sync_id}/test: https://docs.squared.ai/api-reference/syncs/test_sync.md PUT /api/v1/models/{id}: https://docs.squared.ai/api-reference/models/update-model.md PUT /api/v1/catalogs/{id}: https://docs.squared.ai/api-reference/catalogs/update_catalog.md PUT /api/v1/connectors/{id}: https://docs.squared.ai/api-reference/connectors/update_connector.md PUT /api/v1/syncs/{id}: https://docs.squared.ai/api-reference/syncs/update_sync.md