Receive Inbound Webhook
POST
/api/v1/webhooks/inbound
Receive Asana Rules action POST with full task JSON.
Per PRD-GAP-02 / FR-01, FR-04, FR-05:
- Verify URL token (via Depends)
- Parse request body as Task
- Enqueue background processing
- Return 200 immediately
Args: request: FastAPI request for raw body access. background_tasks: FastAPI BackgroundTasks for async processing. _token: Verified token (unused, presence confirms auth).
Returns: 200 with {“status”: “accepted”} for valid payloads. 400 for unparseable or invalid payloads. 401 for auth failures (handled by Depends). 503 if webhook not configured (handled by Depends).
Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters ”Responses
Section titled “ Responses ”Successful Response
Validation Error
HTTPValidationError
object
detail
Detail
Array<object>
ValidationErrorobject
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string