67 lines
2.1 KiB
YAML
67 lines
2.1 KiB
YAML
openapi: 3.0.3
|
|
info:
|
|
title: TenantAtlas Operations — Bulk Enqueue (Conceptual)
|
|
version: 0.1.0
|
|
description: |
|
|
Conceptual contract for enqueue-only bulk operations.
|
|
|
|
Notes:
|
|
- This contract describes the shape of inputs and outputs; it does not prescribe a specific Laravel route.
|
|
- Start surfaces are enqueue-only and must not perform remote work inline.
|
|
paths:
|
|
/operations/bulk/enqueue:
|
|
post:
|
|
summary: Enqueue a bulk operation (enqueue-only)
|
|
operationId: enqueueBulkOperation
|
|
requestBody:
|
|
required: true
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
additionalProperties: true
|
|
properties:
|
|
operation_type:
|
|
type: string
|
|
minLength: 1
|
|
target_scope:
|
|
type: object
|
|
additionalProperties: true
|
|
properties:
|
|
entra_tenant_id:
|
|
type: string
|
|
directory_context_id:
|
|
type: string
|
|
selection:
|
|
type: object
|
|
additionalProperties: true
|
|
properties:
|
|
kind:
|
|
type: string
|
|
enum: [ids, query]
|
|
ids:
|
|
type: array
|
|
items:
|
|
type: string
|
|
query:
|
|
type: object
|
|
additionalProperties: true
|
|
required: [operation_type, selection]
|
|
responses:
|
|
'202':
|
|
description: Enqueued or deduped to an existing active run
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
additionalProperties: true
|
|
properties:
|
|
operation_run_id:
|
|
type: integer
|
|
status:
|
|
type: string
|
|
enum: [queued, running]
|
|
view_run_url:
|
|
type: string
|
|
required: [operation_run_id, status]
|