Skip to content
StackTaktDocs

Start Discovery Run

POST
/discovery/runs

One-shot, user-triggered discovery. Executes synchronously (ADR-0012 keeps discovery in-process for the MVP) and returns the run in its final state.

Parameters

Section titled “ Parameters ”
Section titled “Cookie Parameters ”
st_session
Any of:
string

Request Body required

Section titled “Request Body required ”
DiscoveryRunRequest
object
connection_id
required
Connection Id
string format: uuid
tenant_id
required
Tenant Id
string format: uuid

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Successful Response

DiscoveryRunRecord
object
connection_id
required
Connection Id
string format: uuid
counts
required
Counts
object
key
additional properties
integer
error
required
Any of:
DiscoveryRunError
object
detail
required
Detail
string
service_call
required
Service Call
string
finished_at
required
Any of:
string format: date-time
id
required
Id
string format: uuid
started_at
required
Started At
string format: date-time
status
required
Status
string
tenant_aws_account_id
Any of:
string format: uuid
tenant_id
required
Tenant Id
string format: uuid

422

Section titled “422 ”

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string