Skip to content
agent-data

Get Operation

GET
/api/v1/operations/{operation_id}
 
agent-data call bd63936c-8611-45a8-8ad8-083aa4c51aa9 get-operation --operation_id <operation_id>

Return the state of a long-running flight-search operation.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
operation_id
required
Operation Id

Specify the operation identifier returned alongside an asynchronous flight-search job. You may send either the bare operation suffix or the full operations/… resource name; the server normalizes missing prefixes automatically. The API returns 404 if the normalized operation ID is unknown.

string

Specify the operation identifier returned alongside an asynchronous flight-search job. You may send either the bare operation suffix or the full operations/… resource name; the server normalizes missing prefixes automatically. The API returns 404 if the normalized operation ID is unknown.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

Media type application/json
Envelope[OperationResource]
object
data
required
OperationResource
object
id
required
Id
string
done
required
Done
boolean
status
required
SearchJobStatus
string
Allowed values: pending running completed failed partial
progress
OperationProgress
object
current_step
Any of:
string
progress_percent
Any of:
integer
<= 100
resource
Resource
string
default: operation
created_at
required
Created At
string format: date-time
result_url
Any of:
string
updated_at
required
Updated At
string format: date-time
error_message
Any of:
string
meta
required
ResponseMeta
object
cache
Any of:
CacheMetadata
object
hit
required
Hit
boolean
ttl_seconds
required
Ttl Seconds
integer
resource
required
Resource
string
returned
Any of:
integer
request_id
Request Id
string
sources_used
Sources Used
Array<string>
total_results
Any of:
integer
data_freshness
Any of:
string format: date-time
processing_time_ms
required
Processing Time Ms
integer
warnings
Warnings
Array<object>
WarningItem
object
code
required
Code
string
source
required
Source
string
message
required
Message
string
Example 
{
  "data": {
    "status": "pending",
    "resource": "operation"
  }
}

422

Section titled “422 ”

Validation Error

Media type application/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
Example generated
{
  "detail": [
    {
      "ctx": {},
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example"
    }
  ]
}