PracHub
QuestionsPremiumLearningGuidesCheatsheetNEWCoaches
|Home/System Design/Airtable

Design an async API with idempotency

Last updated: May 4, 2026

Quick Overview

This question evaluates a candidate's competency in designing asynchronous HTTP APIs with idempotency guarantees, focusing on job lifecycle, durable data models, messaging/queue behavior, and handling partial failures and retries.

  • medium
  • Airtable
  • System Design
  • Software Engineer

Design an async API with idempotency

Company: Airtable

Role: Software Engineer

Category: System Design

Difficulty: medium

Interview Round: Onsite

## System Design: Asynchronous API Call With Idempotency Design an HTTP API that triggers a long-running operation (seconds to minutes) against downstream systems (e.g., charge a payment, generate a report, provision resources). The API must be **asynchronous** and must guarantee **idempotency** so that client retries do not duplicate work. ### Requirements - Client calls an endpoint to start a job. - The request may be retried due to timeouts, network errors, or 5xx responses. - The system must not execute the operation more than once for the same logical request. - Provide a way for clients to check job status and fetch the result. ### Considerations - High QPS, multiple instances, at-least-once delivery in messaging. - Partial failures (DB commit succeeds but enqueue fails, or vice versa). - Exactly-once semantics are not assumed. Describe: - API endpoints and request/response shapes - Data model - Queue/worker flow - How idempotency is enforced (including edge cases and TTL) - Observability and operational concerns

Quick Answer: This question evaluates a candidate's competency in designing asynchronous HTTP APIs with idempotency guarantees, focusing on job lifecycle, durable data models, messaging/queue behavior, and handling partial failures and retries.

Related Interview Questions

  • Design a scalable search service with sharding - Airtable (medium)
  • Design JSON serialization for circular references - Airtable (hard)
  • Design a lazy-initialized connection pool - Airtable (medium)
  • Design a lazy ConnectionPool - Airtable (medium)
Airtable logo
Airtable
Jan 22, 2026, 12:00 AM
Software Engineer
Onsite
System Design
17
0
Loading...

System Design: Asynchronous API Call With Idempotency

Design an HTTP API that triggers a long-running operation (seconds to minutes) against downstream systems (e.g., charge a payment, generate a report, provision resources). The API must be asynchronous and must guarantee idempotency so that client retries do not duplicate work.

Requirements

  • Client calls an endpoint to start a job.
  • The request may be retried due to timeouts, network errors, or 5xx responses.
  • The system must not execute the operation more than once for the same logical request.
  • Provide a way for clients to check job status and fetch the result.

Considerations

  • High QPS, multiple instances, at-least-once delivery in messaging.
  • Partial failures (DB commit succeeds but enqueue fails, or vice versa).
  • Exactly-once semantics are not assumed.

Describe:

  • API endpoints and request/response shapes
  • Data model
  • Queue/worker flow
  • How idempotency is enforced (including edge cases and TTL)
  • Observability and operational concerns

Solution

Show

Comments (0)

Sign in to leave a comment

Loading comments...

Browse More Questions

More System Design•More Airtable•More Software Engineer•Airtable Software Engineer•Airtable System Design•Software Engineer System Design
PracHub

Master your tech interviews with 7,500+ real questions from top companies.

Product

  • Questions
  • Learning Tracks
  • Interview Guides
  • Resources
  • Premium
  • For Universities
  • Student Access

Browse

  • By Company
  • By Role
  • By Category
  • Topic Hubs
  • SQL Questions
  • Compare Platforms
  • Discord Community

Support

  • support@prachub.com
  • (916) 541-4762

Legal

  • Privacy Policy
  • Terms of Service
  • About Us

© 2026 PracHub. All rights reserved.