{"schema_version":"mia-geo.agent-api.v1","provider":"mia-geo","base_url":"https://mia-geo.ambr.io","publication_path":"/agent-contract/v1.json","generated_from":{"kind":"fastapi_openapi_allowlist","openapi_version":"3.1.0","api_version":"0.2.0"},"contract_status":"stable","consumer_allowlist_required":false,"billing":{"customer_unit":"MIA Points"},"measurement_lifecycle":{"current_active_states":["admitting","queued","running","cancel_pending"],"current_terminal_states":["done","partial","failed","cancelled"],"status_reads_are_authoritative":true,"future_standardization_issue":9},"compatibility_policy":{"additive_changes":"allowed_within_v1","breaking_changes":"require_v2","deprecation_notice_days":90,"v1_support_window":"until_v2_notice_plus_90_days"},"operations":[{"operation_id":"geo.models.list","method":"GET","path":"/api/models","resource_scope":"model_catalog.read","parent_resource":null,"authentication":{"accepted_credentials":["oidc_session","account_bound_mia_pat","delegated_mia_platform_key"],"platform_key_requires_headers":["X-On-Behalf-Of-User","X-On-Behalf-Of-Account"],"account_context":"required","product_account_model":"immutable_platform_account_with_geo_project_data_scope","authorization_source":"canonical_platform_account_authority_and_mia_geo_resource_ownership"},"minimum_role":"authenticated_user","capability":"model_catalog.read","effect_class":"read","delegated_policy_eligible":true,"concurrency":{"mode":"safe_read","idempotency_key":"not_applicable"},"lifecycle":"synchronous","errors":[{"category":"authentication","http_status":401,"retryable":false,"recovery":"authenticate_as_the_acting_user"},{"category":"permission","http_status":403,"retryable":false,"recovery":"use_an_identity_that_owns_the_resource"},{"category":"validation","http_status":422,"retryable":false,"recovery":"correct_the_request"},{"category":"internal","http_status":500,"retryable":true,"recovery":"retry_with_backoff_then_contact_support"}],"introduced_in":"mia-geo.agent-api.v1","deprecated":false,"wire":{"openapi_operation_id":"models_models_get","parameters":[],"request_body":null,"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"success_response_schema_status":"untyped_openapi_pending_issue_8","rejects_unknown_request_fields":false}},{"operation_id":"geo.projects.list","method":"GET","path":"/api/projects","resource_scope":"owned_project.list","parent_resource":"acting_user","authentication":{"accepted_credentials":["oidc_session","account_bound_mia_pat","delegated_mia_platform_key"],"platform_key_requires_headers":["X-On-Behalf-Of-User","X-On-Behalf-Of-Account"],"account_context":"required","product_account_model":"immutable_platform_account_with_geo_project_data_scope","authorization_source":"canonical_platform_account_authority_and_mia_geo_resource_ownership"},"minimum_role":"authenticated_user","capability":"owned_project.list","effect_class":"read","delegated_policy_eligible":true,"concurrency":{"mode":"safe_read","idempotency_key":"not_applicable"},"lifecycle":"synchronous","errors":[{"category":"authentication","http_status":401,"retryable":false,"recovery":"authenticate_as_the_acting_user"},{"category":"permission","http_status":403,"retryable":false,"recovery":"use_an_identity_that_owns_the_resource"},{"category":"validation","http_status":422,"retryable":false,"recovery":"correct_the_request"},{"category":"internal","http_status":500,"retryable":true,"recovery":"retry_with_backoff_then_contact_support"}],"introduced_in":"mia-geo.agent-api.v1","deprecated":false,"wire":{"openapi_operation_id":"list_projects_projects_get","parameters":[{"name":"scope","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"}}],"request_body":null,"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"success_response_schema_status":"untyped_openapi_pending_issue_8","rejects_unknown_request_fields":false}},{"operation_id":"geo.projects.create","method":"POST","path":"/api/projects","resource_scope":"owned_project.create","parent_resource":"acting_user","authentication":{"accepted_credentials":["oidc_session","account_bound_mia_pat","delegated_mia_platform_key"],"platform_key_requires_headers":["X-On-Behalf-Of-User","X-On-Behalf-Of-Account"],"account_context":"required","product_account_model":"immutable_platform_account_with_geo_project_data_scope","authorization_source":"canonical_platform_account_authority_and_mia_geo_resource_ownership"},"minimum_role":"authenticated_user","capability":"owned_project.create","effect_class":"reversible_write","delegated_policy_eligible":true,"concurrency":{"mode":"conflict_on_duplicate","idempotency_key":"project_name"},"lifecycle":"synchronous","errors":[{"category":"authentication","http_status":401,"retryable":false,"recovery":"authenticate_as_the_acting_user"},{"category":"permission","http_status":403,"retryable":false,"recovery":"use_an_identity_that_owns_the_resource"},{"category":"validation","http_status":422,"retryable":false,"recovery":"correct_the_request"},{"category":"internal","http_status":500,"retryable":true,"recovery":"retry_with_backoff_then_contact_support"},{"category":"conflict","http_status":409,"retryable":false,"recovery":"select_the_existing_project_or_change_the_name"}],"introduced_in":"mia-geo.agent-api.v1","deprecated":false,"wire":{"openapi_operation_id":"create_project_projects_post","parameters":[],"request_body":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"success_response_schema_status":"untyped_openapi_pending_issue_8","rejects_unknown_request_fields":true}},{"operation_id":"geo.brands.list","method":"GET","path":"/api/brands","resource_scope":"owned_brand.list","parent_resource":"acting_user","authentication":{"accepted_credentials":["oidc_session","account_bound_mia_pat","delegated_mia_platform_key"],"platform_key_requires_headers":["X-On-Behalf-Of-User","X-On-Behalf-Of-Account"],"account_context":"required","product_account_model":"immutable_platform_account_with_geo_project_data_scope","authorization_source":"canonical_platform_account_authority_and_mia_geo_resource_ownership"},"minimum_role":"authenticated_user","capability":"owned_brand.list","effect_class":"read","delegated_policy_eligible":true,"concurrency":{"mode":"safe_read","idempotency_key":"not_applicable"},"lifecycle":"synchronous","errors":[{"category":"authentication","http_status":401,"retryable":false,"recovery":"authenticate_as_the_acting_user"},{"category":"permission","http_status":403,"retryable":false,"recovery":"use_an_identity_that_owns_the_resource"},{"category":"validation","http_status":422,"retryable":false,"recovery":"correct_the_request"},{"category":"internal","http_status":500,"retryable":true,"recovery":"retry_with_backoff_then_contact_support"}],"introduced_in":"mia-geo.agent-api.v1","deprecated":false,"wire":{"openapi_operation_id":"list_brands_brands_get","parameters":[{"name":"scope","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"}},{"name":"project_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Project Id"}}],"request_body":null,"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"success_response_schema_status":"untyped_openapi_pending_issue_8","rejects_unknown_request_fields":false}},{"operation_id":"geo.brands.create","method":"POST","path":"/api/brands","resource_scope":"owned_brand.create","parent_resource":"acting_user","authentication":{"accepted_credentials":["oidc_session","account_bound_mia_pat","delegated_mia_platform_key"],"platform_key_requires_headers":["X-On-Behalf-Of-User","X-On-Behalf-Of-Account"],"account_context":"required","product_account_model":"immutable_platform_account_with_geo_project_data_scope","authorization_source":"canonical_platform_account_authority_and_mia_geo_resource_ownership"},"minimum_role":"authenticated_user","capability":"owned_brand.create","effect_class":"reversible_write","delegated_policy_eligible":true,"concurrency":{"mode":"conflict_on_duplicate","idempotency_key":"unsupported"},"lifecycle":"synchronous","errors":[{"category":"authentication","http_status":401,"retryable":false,"recovery":"authenticate_as_the_acting_user"},{"category":"permission","http_status":403,"retryable":false,"recovery":"use_an_identity_that_owns_the_resource"},{"category":"validation","http_status":422,"retryable":false,"recovery":"correct_the_request"},{"category":"internal","http_status":500,"retryable":true,"recovery":"retry_with_backoff_then_contact_support"},{"category":"conflict","http_status":409,"retryable":false,"recovery":"select_the_existing_brand_or_change_the_name"}],"introduced_in":"mia-geo.agent-api.v1","deprecated":false,"wire":{"openapi_operation_id":"create_brand_brands_post","parameters":[],"request_body":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"success_response_schema_status":"untyped_openapi_pending_issue_8","rejects_unknown_request_fields":true}},{"operation_id":"geo.brand_keywords.list","method":"GET","path":"/api/brands/{brand_id}/keywords","resource_scope":"owned_brand.read","parent_resource":"brand_id","authentication":{"accepted_credentials":["oidc_session","account_bound_mia_pat","delegated_mia_platform_key"],"platform_key_requires_headers":["X-On-Behalf-Of-User","X-On-Behalf-Of-Account"],"account_context":"required","product_account_model":"immutable_platform_account_with_geo_project_data_scope","authorization_source":"canonical_platform_account_authority_and_mia_geo_resource_ownership"},"minimum_role":"authenticated_user","capability":"owned_brand.read","effect_class":"read","delegated_policy_eligible":true,"concurrency":{"mode":"safe_read","idempotency_key":"not_applicable"},"lifecycle":"synchronous","errors":[{"category":"authentication","http_status":401,"retryable":false,"recovery":"authenticate_as_the_acting_user"},{"category":"permission","http_status":403,"retryable":false,"recovery":"use_an_identity_that_owns_the_resource"},{"category":"validation","http_status":422,"retryable":false,"recovery":"correct_the_request"},{"category":"internal","http_status":500,"retryable":true,"recovery":"retry_with_backoff_then_contact_support"}],"introduced_in":"mia-geo.agent-api.v1","deprecated":false,"wire":{"openapi_operation_id":"list_keywords_brands__brand_id__keywords_get","parameters":[{"name":"brand_id","in":"path","required":true,"schema":{"type":"integer","title":"Brand Id"}}],"request_body":null,"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"success_response_schema_status":"untyped_openapi_pending_issue_8","rejects_unknown_request_fields":false}},{"operation_id":"geo.brand_keywords.create","method":"POST","path":"/api/brands/{brand_id}/keywords","resource_scope":"owned_brand.measurement_scope","parent_resource":"brand_id","authentication":{"accepted_credentials":["oidc_session","account_bound_mia_pat","delegated_mia_platform_key"],"platform_key_requires_headers":["X-On-Behalf-Of-User","X-On-Behalf-Of-Account"],"account_context":"required","product_account_model":"immutable_platform_account_with_geo_project_data_scope","authorization_source":"canonical_platform_account_authority_and_mia_geo_resource_ownership"},"minimum_role":"authenticated_user","capability":"owned_brand.measurement_scope","effect_class":"reversible_write","delegated_policy_eligible":true,"concurrency":{"mode":"idempotent_reconcile","idempotency_key":"brand_topic_market_language"},"lifecycle":"synchronous","errors":[{"category":"authentication","http_status":401,"retryable":false,"recovery":"authenticate_as_the_acting_user"},{"category":"permission","http_status":403,"retryable":false,"recovery":"use_an_identity_that_owns_the_resource"},{"category":"validation","http_status":422,"retryable":false,"recovery":"correct_the_request"},{"category":"internal","http_status":500,"retryable":true,"recovery":"retry_with_backoff_then_contact_support"}],"introduced_in":"mia-geo.agent-api.v1","deprecated":false,"wire":{"openapi_operation_id":"add_keyword_brands__brand_id__keywords_post","parameters":[{"name":"brand_id","in":"path","required":true,"schema":{"type":"integer","title":"Brand Id"}}],"request_body":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeywordIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"success_response_schema_status":"untyped_openapi_pending_issue_8","rejects_unknown_request_fields":true}},{"operation_id":"geo.keyword.get","method":"GET","path":"/api/keywords/{keyword_id}","resource_scope":"owned_keyword.read","parent_resource":"keyword_id","authentication":{"accepted_credentials":["oidc_session","account_bound_mia_pat","delegated_mia_platform_key"],"platform_key_requires_headers":["X-On-Behalf-Of-User","X-On-Behalf-Of-Account"],"account_context":"required","product_account_model":"immutable_platform_account_with_geo_project_data_scope","authorization_source":"canonical_platform_account_authority_and_mia_geo_resource_ownership"},"minimum_role":"authenticated_user","capability":"owned_keyword.read","effect_class":"read","delegated_policy_eligible":true,"concurrency":{"mode":"safe_read","idempotency_key":"not_applicable"},"lifecycle":"synchronous","errors":[{"category":"authentication","http_status":401,"retryable":false,"recovery":"authenticate_as_the_acting_user"},{"category":"permission","http_status":403,"retryable":false,"recovery":"use_an_identity_that_owns_the_resource"},{"category":"validation","http_status":422,"retryable":false,"recovery":"correct_the_request"},{"category":"internal","http_status":500,"retryable":true,"recovery":"retry_with_backoff_then_contact_support"}],"introduced_in":"mia-geo.agent-api.v1","deprecated":false,"wire":{"openapi_operation_id":"get_keyword_keywords__keyword_id__get","parameters":[{"name":"keyword_id","in":"path","required":true,"schema":{"type":"integer","title":"Keyword Id"}}],"request_body":null,"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"success_response_schema_status":"untyped_openapi_pending_issue_8","rejects_unknown_request_fields":false}},{"operation_id":"geo.keyword_insight.get","method":"GET","path":"/api/keywords/{keyword_id}/insight","resource_scope":"owned_keyword.read","parent_resource":"keyword_id","authentication":{"accepted_credentials":["oidc_session","account_bound_mia_pat","delegated_mia_platform_key"],"platform_key_requires_headers":["X-On-Behalf-Of-User","X-On-Behalf-Of-Account"],"account_context":"required","product_account_model":"immutable_platform_account_with_geo_project_data_scope","authorization_source":"canonical_platform_account_authority_and_mia_geo_resource_ownership"},"minimum_role":"authenticated_user","capability":"owned_keyword.read","effect_class":"read","delegated_policy_eligible":true,"concurrency":{"mode":"safe_read","idempotency_key":"not_applicable"},"lifecycle":"synchronous","errors":[{"category":"authentication","http_status":401,"retryable":false,"recovery":"authenticate_as_the_acting_user"},{"category":"permission","http_status":403,"retryable":false,"recovery":"use_an_identity_that_owns_the_resource"},{"category":"validation","http_status":422,"retryable":false,"recovery":"correct_the_request"},{"category":"internal","http_status":500,"retryable":true,"recovery":"retry_with_backoff_then_contact_support"},{"category":"conflict","http_status":409,"retryable":false,"recovery":"select_a_monitoring_profile"}],"introduced_in":"mia-geo.agent-api.v1","deprecated":false,"wire":{"openapi_operation_id":"insight_keywords__keyword_id__insight_get","parameters":[{"name":"keyword_id","in":"path","required":true,"schema":{"type":"integer","title":"Keyword Id"}},{"name":"monitoring_profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Monitoring Profile Id"}}],"request_body":null,"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"success_response_schema_status":"untyped_openapi_pending_issue_8","rejects_unknown_request_fields":false}},{"operation_id":"geo.run.estimate","method":"POST","path":"/api/estimate","resource_scope":"owned_keyword.measure","parent_resource":"keyword_id","authentication":{"accepted_credentials":["oidc_session","account_bound_mia_pat","delegated_mia_platform_key"],"platform_key_requires_headers":["X-On-Behalf-Of-User","X-On-Behalf-Of-Account"],"account_context":"required","product_account_model":"immutable_platform_account_with_geo_project_data_scope","authorization_source":"canonical_platform_account_authority_and_mia_geo_resource_ownership"},"minimum_role":"authenticated_user","capability":"owned_keyword.measure","effect_class":"read","delegated_policy_eligible":true,"concurrency":{"mode":"signed_precondition","schema":"mia-geo.run-estimate.v1","idempotency_key":"not_applicable"},"lifecycle":"synchronous","errors":[{"category":"authentication","http_status":401,"retryable":false,"recovery":"authenticate_as_the_acting_user"},{"category":"permission","http_status":403,"retryable":false,"recovery":"use_an_identity_that_owns_the_resource"},{"category":"validation","http_status":422,"retryable":false,"recovery":"correct_the_request"},{"category":"internal","http_status":500,"retryable":true,"recovery":"retry_with_backoff_then_contact_support"},{"category":"billing","http_status":503,"retryable":true,"recovery":"retry_when_mia_points_pricing_is_available"}],"introduced_in":"mia-geo.agent-api.v1","deprecated":false,"wire":{"openapi_operation_id":"estimate_cost_estimate_post","parameters":[],"request_body":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EstimateReq"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"success_response_schema_status":"untyped_openapi_pending_issue_8","rejects_unknown_request_fields":true}},{"operation_id":"geo.run.start","method":"POST","path":"/api/keywords/{keyword_id}/runs","resource_scope":"owned_keyword.measure","parent_resource":"keyword_id","authentication":{"accepted_credentials":["oidc_session","account_bound_mia_pat","delegated_mia_platform_key"],"platform_key_requires_headers":["X-On-Behalf-Of-User","X-On-Behalf-Of-Account"],"account_context":"required","product_account_model":"immutable_platform_account_with_geo_project_data_scope","authorization_source":"canonical_platform_account_authority_and_mia_geo_resource_ownership"},"minimum_role":"authenticated_user","capability":"owned_keyword.measure","effect_class":"paid","delegated_policy_eligible":true,"concurrency":{"mode":"signed_estimate_precondition","required_fields":["estimate_token","expected_points"],"idempotency_key":"unsupported_pending_mia_geo_issue_9"},"lifecycle":"asynchronous_run","errors":[{"category":"authentication","http_status":401,"retryable":false,"recovery":"authenticate_as_the_acting_user"},{"category":"permission","http_status":403,"retryable":false,"recovery":"use_an_identity_that_owns_the_resource"},{"category":"validation","http_status":422,"retryable":false,"recovery":"correct_the_request"},{"category":"internal","http_status":500,"retryable":true,"recovery":"retry_with_backoff_then_contact_support"},{"category":"billing","http_status":402,"retryable":false,"recovery":"add_mia_points"},{"category":"conflict","http_status":409,"retryable":false,"recovery":"request_and_confirm_a_fresh_estimate"},{"category":"retryable_outage","http_status":503,"retryable":true,"recovery":"check_authoritative_run_status_before_retrying"}],"introduced_in":"mia-geo.agent-api.v1","deprecated":false,"wire":{"openapi_operation_id":"trigger_run_keywords__keyword_id__runs_post","parameters":[{"name":"keyword_id","in":"path","required":true,"schema":{"type":"integer","title":"Keyword Id"}}],"request_body":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"success_response_schema_status":"untyped_openapi_pending_issue_8","rejects_unknown_request_fields":true}},{"operation_id":"geo.runs.list","method":"GET","path":"/api/runs","resource_scope":"owned_run.list","parent_resource":"acting_user","authentication":{"accepted_credentials":["oidc_session","account_bound_mia_pat","delegated_mia_platform_key"],"platform_key_requires_headers":["X-On-Behalf-Of-User","X-On-Behalf-Of-Account"],"account_context":"required","product_account_model":"immutable_platform_account_with_geo_project_data_scope","authorization_source":"canonical_platform_account_authority_and_mia_geo_resource_ownership"},"minimum_role":"authenticated_user","capability":"owned_run.list","effect_class":"read","delegated_policy_eligible":true,"concurrency":{"mode":"safe_read","idempotency_key":"not_applicable"},"lifecycle":"synchronous","errors":[{"category":"authentication","http_status":401,"retryable":false,"recovery":"authenticate_as_the_acting_user"},{"category":"permission","http_status":403,"retryable":false,"recovery":"use_an_identity_that_owns_the_resource"},{"category":"validation","http_status":422,"retryable":false,"recovery":"correct_the_request"},{"category":"internal","http_status":500,"retryable":true,"recovery":"retry_with_backoff_then_contact_support"}],"introduced_in":"mia-geo.agent-api.v1","deprecated":false,"wire":{"openapi_operation_id":"list_runs_runs_get","parameters":[{"name":"scope","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"}},{"name":"brand_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Brand Id"}},{"name":"keyword_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Keyword Id"}},{"name":"task_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Task Id"}},{"name":"monitoring_profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Monitoring Profile Id"}},{"name":"before_id","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Before Id"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":1000,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"include_internal","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Internal"}}],"request_body":null,"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"success_response_schema_status":"untyped_openapi_pending_issue_8","rejects_unknown_request_fields":false}},{"operation_id":"geo.run.get","method":"GET","path":"/api/runs/{run_id}","resource_scope":"owned_run.read","parent_resource":"run_id","authentication":{"accepted_credentials":["oidc_session","account_bound_mia_pat","delegated_mia_platform_key"],"platform_key_requires_headers":["X-On-Behalf-Of-User","X-On-Behalf-Of-Account"],"account_context":"required","product_account_model":"immutable_platform_account_with_geo_project_data_scope","authorization_source":"canonical_platform_account_authority_and_mia_geo_resource_ownership"},"minimum_role":"authenticated_user","capability":"owned_run.read","effect_class":"read","delegated_policy_eligible":true,"concurrency":{"mode":"safe_read","idempotency_key":"not_applicable"},"lifecycle":"synchronous","errors":[{"category":"authentication","http_status":401,"retryable":false,"recovery":"authenticate_as_the_acting_user"},{"category":"permission","http_status":403,"retryable":false,"recovery":"use_an_identity_that_owns_the_resource"},{"category":"validation","http_status":422,"retryable":false,"recovery":"correct_the_request"},{"category":"internal","http_status":500,"retryable":true,"recovery":"retry_with_backoff_then_contact_support"}],"introduced_in":"mia-geo.agent-api.v1","deprecated":false,"wire":{"openapi_operation_id":"get_run_runs__run_id__get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"integer","title":"Run Id"}},{"name":"scope","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"}}],"request_body":null,"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"success_response_schema_status":"untyped_openapi_pending_issue_8","rejects_unknown_request_fields":false}},{"operation_id":"geo.run.status","method":"GET","path":"/api/runs/{run_id}/status","resource_scope":"owned_run.read","parent_resource":"run_id","authentication":{"accepted_credentials":["oidc_session","account_bound_mia_pat","delegated_mia_platform_key"],"platform_key_requires_headers":["X-On-Behalf-Of-User","X-On-Behalf-Of-Account"],"account_context":"required","product_account_model":"immutable_platform_account_with_geo_project_data_scope","authorization_source":"canonical_platform_account_authority_and_mia_geo_resource_ownership"},"minimum_role":"authenticated_user","capability":"owned_run.read","effect_class":"read","delegated_policy_eligible":true,"concurrency":{"mode":"safe_read","idempotency_key":"not_applicable"},"lifecycle":"authoritative_status_read","errors":[{"category":"authentication","http_status":401,"retryable":false,"recovery":"authenticate_as_the_acting_user"},{"category":"permission","http_status":403,"retryable":false,"recovery":"use_an_identity_that_owns_the_resource"},{"category":"validation","http_status":422,"retryable":false,"recovery":"correct_the_request"},{"category":"internal","http_status":500,"retryable":true,"recovery":"retry_with_backoff_then_contact_support"}],"introduced_in":"mia-geo.agent-api.v1","deprecated":false,"wire":{"openapi_operation_id":"run_status_runs__run_id__status_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"integer","title":"Run Id"}}],"request_body":null,"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"success_response_schema_status":"untyped_openapi_pending_issue_8","rejects_unknown_request_fields":false}}],"components":{"schemas":{"BrandIn":{"properties":{"name":{"type":"string","title":"Name"},"aliases":{"items":{"type":"string"},"type":"array","title":"Aliases","default":[]},"landing_url":{"type":"string","title":"Landing Url","default":""},"region":{"type":"string","title":"Region","default":"中国大陆"},"language":{"type":"string","title":"Language","default":"简体中文"},"industry":{"type":"string","title":"Industry","default":""},"primary_platform":{"type":"string","title":"Primary Platform","default":"DeepSeek"},"site_mode":{"type":"string","enum":["website","materials","hybrid"],"title":"Site Mode","default":"website"},"project_id":{"type":"integer","minimum":1.0,"title":"Project Id"},"keywords":{"items":{"$ref":"#/components/schemas/KeywordIn"},"type":"array","title":"Keywords","default":[]}},"additionalProperties":false,"type":"object","required":["name","project_id"],"title":"BrandIn"},"EntityAliasesIn":{"properties":{"name":{"type":"string","title":"Name"},"aliases":{"items":{"type":"string"},"type":"array","title":"Aliases","default":[]}},"additionalProperties":false,"type":"object","required":["name"],"title":"EntityAliasesIn","description":"规范实体名 + 明确允许命中的别名；业务线名称不会自动推导。"},"EstimateReq":{"properties":{"keyword_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0.0},{"type":"null"}],"title":"Keyword Id"},"models":{"items":{"type":"string"},"type":"array","title":"Models"},"total_questions":{"type":"integer","minimum":0.0,"title":"Total Questions","default":0},"samples":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Samples","default":1},"cycle":{"type":"string","enum":["once","hourly","daily","weekly","monthly"],"title":"Cycle","default":"once"},"week_days":{"items":{"type":"integer"},"type":"array","maxItems":7,"title":"Week Days"},"month_days":{"items":{"type":"integer"},"type":"array","maxItems":31,"title":"Month Days"},"runs_per_round":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Runs Per Round","default":1},"run_type":{"type":"string","enum":["baseline","post","scheduled","manual"],"title":"Run Type","default":"baseline"},"web_search":{"type":"boolean","title":"Web Search","default":true},"measurement_mode":{"type":"string","enum":["market_context","controlled_benchmark","native_observation"],"title":"Measurement Mode","default":"controlled_benchmark"},"monitoring_profile_id":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Monitoring Profile Id"}},"additionalProperties":false,"type":"object","title":"EstimateReq"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"KeywordIn":{"properties":{"text":{"type":"string","title":"Text"},"market":{"type":"string","maxLength":16,"minLength":2,"title":"Market","default":"CN"},"language":{"anyOf":[{"type":"string","maxLength":16,"minLength":2},{"type":"null"}],"title":"Language"},"target_markets":{"items":{"type":"string"},"type":"array","title":"Target Markets"},"baidu_volume":{"type":"integer","title":"Baidu Volume","default":0},"competitors":{"items":{"anyOf":[{"type":"string"},{"$ref":"#/components/schemas/EntityAliasesIn"}]},"type":"array","title":"Competitors","default":[]},"longtails":{"items":{"$ref":"#/components/schemas/LongtailIn"},"type":"array","title":"Longtails","default":[]}},"additionalProperties":false,"type":"object","required":["text"],"title":"KeywordIn"},"LongtailIn":{"properties":{"text":{"type":"string","title":"Text"},"baidu_volume":{"type":"integer","title":"Baidu Volume","default":0},"source":{"type":"string","title":"Source","default":"manual"},"intent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intent"},"cluster":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cluster"},"measurement_scope":{"type":"string","enum":["benchmark","brand_probe","quickwin"],"title":"Measurement Scope","default":"benchmark"}},"additionalProperties":false,"type":"object","required":["text"],"title":"LongtailIn"},"ProjectIn":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description","default":""}},"additionalProperties":false,"type":"object","required":["name"],"title":"ProjectIn","description":"新建项目/工作区（单账号内对品牌分组）。"},"RunIn":{"properties":{"models":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Models"},"type":{"type":"string","enum":["baseline","post","scheduled","manual"],"title":"Type","default":"baseline"},"web_search":{"type":"boolean","title":"Web Search","default":true},"measurement_mode":{"type":"string","enum":["market_context","controlled_benchmark","native_observation"],"title":"Measurement Mode","default":"controlled_benchmark"},"monitoring_profile_id":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Monitoring Profile Id"},"expected_points":{"anyOf":[{"type":"integer","maximum":1000000000000.0,"minimum":0.0},{"type":"null"}],"title":"Expected Points"},"estimate_token":{"anyOf":[{"type":"string","minLength":32},{"type":"null"}],"title":"Estimate Token"}},"additionalProperties":false,"type":"object","title":"RunIn"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"contract_hash":"463b63130b1569560fda1a60634efe876fe5a54237fe8dccb48b2bb5ff5d0639"}