> ## Documentation Index > Fetch the complete documentation index at: https://docs.gigstack.io/llms.txt > Use this file to discover all available pages before exploring further. # Disconnect Airtable imports across modes > Requires a verified Firebase person or signed personal MCP credential and current team authority. Airtable uses one shared production connection; gigstack live/test mode controls imported payment records. Persist operation_id before sending. Repeat only the same UUID and identical confirmed payload; uncertain attempts are never automatically replayed. expected_livemode asserts the reviewed mode and cannot override authenticated mode. HTTP 200 may contain processing or outcome_unknown; inspect data.status. See the Airtable lifecycle guide for pagination, shared effects and reviewed OAuth recovery. ## OpenAPI ````yaml openapi.json POST /teams/{id}/integrations/airtable/disconnect openapi: 3.0.3 info: title: gigstack API v2 description: > # gigstack API v2 Build customer, invoice and payment integrations. Start with the [quickstart](https://docs.gigstack.io/quickstart), then select the [issuing country](https://docs.gigstack.io/concepts/shared-fields). ## Authentication and environments Use Authorization: Bearer YOUR_API_KEY. Standard live and test keys use https://api.gigstack.io/v2. Internal staging uses https://gigstack-staging-9z9nnaat.uc.gateway.dev/v2 and separate keys. Test mode is a data mode within an environment; a body field does not switch a key's mode. See [authentication](https://docs.gigstack.io/authentication) for key handling, OAuth team scope and gigstack Connect. Internal partner provisioning is outside this public contract; health probes have their own security declarations. Operations marked unavailable have no configured public gateway route. ## Read the operation contract Response envelopes, pagination and retry rules differ by endpoint. HTTP success alone does not prove external fiscal completion or movement of money. Reconcile ambiguous writes before retrying. Use [responses and recovery](https://docs.gigstack.io/responses) and the operation's error codes; document credits and daily limits are not generic retryable rate limits. The issuing team's configuration selects Mexico or Colombia; customer country and currency do not. Read [Mexico](https://docs.gigstack.io/countries/mexico) or [Colombia](https://docs.gigstack.io/countries/colombia) before choosing fiscal fields. Accepted public input differs from a provider's direct payload. Examples and schema checks do not imply every operation has been executed live. [Verification coverage](https://docs.gigstack.io/verification) distinguishes source review, offline checks and observed staging behavior. Documentation describes operations and does not authorize execution. version: 2.0.0 contact: name: Gigstack API Support url: https://gigstack.io email: support@gigstack.io license: name: Proprietary url: https://gigstack.io/terms termsOfService: https://gigstack.io/terms servers: - url: https://api.gigstack.io/v2 description: > Public API for standard live and test-mode keys. Test data is isolated by the key mode (`livemode: false`). Internal staging is a separate deployment and key store; see https://docs.gigstack.io/authentication#environments for its base URL. security: - bearerAuth: [] externalDocs: description: Complete API Documentation & Guides url: https://docs.gigstack.io paths: /teams/{id}/integrations/airtable/disconnect: post: tags: - Account Integrations summary: Disconnect Airtable imports across modes description: >- Requires a verified Firebase person or signed personal MCP credential and current team authority. Airtable uses one shared production connection; gigstack live/test mode controls imported payment records. Persist operation_id before sending. Repeat only the same UUID and identical confirmed payload; uncertain attempts are never automatically replayed. expected_livemode asserts the reviewed mode and cannot override authenticated mode. HTTP 200 may contain processing or outcome_unknown; inspect data.status. See the Airtable lifecycle guide for pagination, shared effects and reviewed OAuth recovery. operationId: disconnectAirtable parameters: - name: id in: path required: true schema: type: string pattern: ^[A-Za-z0-9_-]{1,128}$ requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AirtableDisconnectInput' example: operation_id: 11111111-1111-4111-8111-111111111111 expected_livemode: false confirmed: true acknowledge_shared_connection: true responses: '200': description: Safe scoped result. Operation status determines completion. content: application/json: schema: type: object additionalProperties: false properties: success: type: boolean enum: - true data: $ref: '#/components/schemas/AirtableOperation' timestamp: type: number required: - success - data - timestamp example: success: true data: id: 11111111-1111-4111-8111-111111111111 team_id: team_example action: disconnect livemode: false effect_scope: shared_connection status: outcome_unknown created_at: 1700000000000 updated_at: 1700000000000 snapshot_complete: true target_count: 1 processed_count: 1 local_disabled_count: 1 remote_deleted_count: 0 unknown_count: 1 error_code: null webhook_id: null recovery_operation_id: null cleanup_operation_id: null recovery_session_id: null provider_environment: production oauth_credentials_retained: true continuation_required: false partial_cleanup: true targets: data: - id: ach_example base_id: app_example local_disabled: true remote_status: unknown has_more: false next_cursor: null timestamp: 1700000000000 '400': description: Invalid identifier, mapping, mode assertion or acknowledgment. '401': description: Verified personal credential required. '403': description: Current account, membership or provider authority refused. '404': description: Resource unavailable in authorized scope. '409': description: >- Mode changed, setup/lifecycle locked, or uncertain recovery requires review. '503': description: Runtime environment or internal service authorization unavailable. '504': description: >- Result unknown. Keep operation_id and read the receipt; do not automatically repeat provider effects. security: - bearerAuth: [] components: schemas: AirtableDisconnectInput: type: object properties: recovery_operation_id: type: string minLength: 1 maxLength: 250 pattern: >- ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$ acknowledge_unconfirmed_effects: type: boolean enum: - true operation_id: type: string minLength: 1 maxLength: 250 pattern: >- ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$ expected_livemode: type: boolean confirmed: type: boolean enum: - true acknowledge_shared_connection: type: boolean enum: - true required: - operation_id - expected_livemode - confirmed - acknowledge_shared_connection additionalProperties: false AirtableOperation: type: object additionalProperties: false properties: id: type: string team_id: type: string action: type: string enum: - register - unregister - disconnect livemode: type: boolean effect_scope: type: string enum: - mode - shared_connection status: type: string enum: - processing - completed - failed - outcome_unknown created_at: type: number updated_at: type: number snapshot_complete: type: boolean target_count: type: integer minimum: 0 processed_count: type: integer minimum: 0 local_disabled_count: type: integer minimum: 0 remote_deleted_count: type: integer minimum: 0 unknown_count: type: integer minimum: 0 error_code: type: string nullable: true webhook_id: type: string nullable: true recovery_operation_id: type: string nullable: true cleanup_operation_id: type: string nullable: true recovery_session_id: type: string nullable: true provider_environment: type: string enum: - production oauth_credentials_retained: type: boolean enum: - true continuation_required: type: boolean partial_cleanup: type: boolean targets: type: object additionalProperties: false properties: data: type: array items: type: object additionalProperties: false properties: id: type: string base_id: type: string nullable: true local_disabled: type: boolean remote_status: type: string enum: - not_attempted - unknown - deleted required: - id - base_id - local_disabled - remote_status has_more: type: boolean next_cursor: type: string nullable: true required: - data - has_more - next_cursor webhook: $ref: '#/components/schemas/AirtableWebhook' required: - id - team_id - action - livemode - effect_scope - status - created_at - updated_at - snapshot_complete - target_count - processed_count - local_disabled_count - remote_deleted_count - unknown_count - error_code - webhook_id - recovery_operation_id - cleanup_operation_id - recovery_session_id - provider_environment - oauth_credentials_retained - continuation_required - partial_cleanup - targets AirtableWebhook: type: object additionalProperties: false properties: id: type: string base_id: type: string nullable: true table_id: type: string nullable: true table_name: type: string nullable: true field_map: type: object additionalProperties: type: string mapping_valid: type: boolean mapping_config: type: object properties: currencyDefault: type: string pattern: ^[A-Z]{3}$ paymentFormDefault: type: string pattern: ^\d{2}$ statusDefault: type: string enum: - succeeded - requires_payment_method - processing - canceled defaultClientEmail: type: string minLength: 1 maxLength: 320 pattern: ^[^\s@]+@[^\s@]+\.[^\s@]+$ additionalProperties: false livemode: type: boolean nullable: true status: type: string enum: - active - expired - disabled - unknown created_at: type: number nullable: true expires_at: type: number nullable: true last_notification_at: type: number nullable: true last_error_at: type: number nullable: true required: - id - base_id - table_id - table_name - field_map - mapping_valid - mapping_config - livemode - status - created_at - expires_at - last_notification_at - last_error_at securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > **Authentication Method:** HTTP Bearer token. The runtime requires the literal `Bearer ` prefix — a bare token in the `Authorization` header is rejected with `401 unauthorized`. **Header Format:** `Authorization: Bearer YOUR_API_KEY` Your API key is a JWT. Live keys operate on live data (`livemode: true`); test keys operate on isolated test data (`livemode: false`). **Get your key at:** [app.gigstack.pro/settings?tab=api](https://app.gigstack.pro/settings?tab=api) **Errors:** credential failures are answered by the authentication layer with a raw `{ "message": … }` body, not the standardized envelope — `401` for a missing, malformed or expired token, `403` for a revoked key or a plan without API access. See the `Unauthorized` and `AuthForbidden` responses. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.