{ "components": { "callbacks": {}, "examples": {}, "headers": {}, "links": {}, "parameters": {}, "pathItems": {}, "requestBodies": {}, "responses": {}, "schemas": {}, "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } }, "info": { "description": "", "title": "Apollo", "version": "1", "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" } }, "x-aisa-catalogs": { "apollo": { "description": "", "title": "Apollo", "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" } }, "x-aisa-document": { "facts_hash": "9ab7612cf2d53be794cbf1d65d4a257f986ac6783e53c7c3a5d868e4593061c3", "generator_version": "3", "protocol_version": "1", "schema_version": "1" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" } } }, "x-aisa-configured-paths": [ "/apis/v1/apollo/account_stages", "/apis/v1/apollo/accounts", "/apis/v1/apollo/accounts/bulk_create", "/apis/v1/apollo/accounts/bulk_update", "/apis/v1/apollo/accounts/search", "/apis/v1/apollo/accounts/update_owners", "/apis/v1/apollo/accounts/{account_id}", "/apis/v1/apollo/accounts/{id}", "/apis/v1/apollo/contact_stages", "/apis/v1/apollo/contacts", "/apis/v1/apollo/contacts/bulk_create", "/apis/v1/apollo/contacts/bulk_update", "/apis/v1/apollo/contacts/search", "/apis/v1/apollo/contacts/update_owners", "/apis/v1/apollo/contacts/update_stages", "/apis/v1/apollo/contacts/{contact_id}", "/apis/v1/apollo/email_accounts", "/apis/v1/apollo/emailer_campaigns/remove_or_stop_contact_ids", "/apis/v1/apollo/emailer_campaigns/search", "/apis/v1/apollo/emailer_campaigns/{sequence_id}/abort", "/apis/v1/apollo/emailer_campaigns/{sequence_id}/add_contact_ids", "/apis/v1/apollo/emailer_campaigns/{sequence_id}/approve", "/apis/v1/apollo/emailer_campaigns/{sequence_id}/archive", "/apis/v1/apollo/emailer_messages/search", "/apis/v1/apollo/emailer_messages/{id}/activities", "/apis/v1/apollo/fields", "/apis/v1/apollo/labels", "/apis/v1/apollo/mixed_companies/search", "/apis/v1/apollo/mixed_people/api_search", "/apis/v1/apollo/news_articles/search", "/apis/v1/apollo/notes", "/apis/v1/apollo/opportunities", "/apis/v1/apollo/opportunities/search", "/apis/v1/apollo/opportunities/{opportunity_id}", "/apis/v1/apollo/opportunity_stages", "/apis/v1/apollo/organizations/bulk_enrich", "/apis/v1/apollo/organizations/enrich", "/apis/v1/apollo/organizations/{id}", "/apis/v1/apollo/organizations/{organization_id}/job_postings", "/apis/v1/apollo/people/bulk_match", "/apis/v1/apollo/people/match", "/apis/v1/apollo/phone_calls", "/apis/v1/apollo/phone_calls/search", "/apis/v1/apollo/phone_calls/{id}", "/apis/v1/apollo/reports/sync_report", "/apis/v1/apollo/tasks", "/apis/v1/apollo/tasks/bulk_create", "/apis/v1/apollo/tasks/search", "/apis/v1/apollo/typed_custom_fields", "/apis/v1/apollo/usage_stats/api_usage_stats", "/apis/v1/apollo/users/search" ], "x-aisa-document": { "composer_version": "26", "document_hash": "sha256:baf959c8cd02075556915e61a01788045931eaccde31e232c9e6a8cbe2c35d0f", "facts_hash": "9ab7612cf2d53be794cbf1d65d4a257f986ac6783e53c7c3a5d868e4593061c3", "generator_version": "3", "identity_base_document_hash": "sha256:69a680f3ec2f6c44d4f83d2d5271d56fc6aaf54ac057f3a6656c1892ac02857f", "identity_compatibility_hash": "sha256:3bc28cb12b6a6f37411c3d96a19e68e7ef629e36d32c2e39fa51f0c423aa0fa2", "protocol_version": "1", "response_pending": [], "schema_version": "1" }, "x-aisa-plans": { "builder": 1.0, "display_plan": "payg", "payg": 1.0, "similarweb_payg": 1.0, "team": 1.0, "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb" }, "x-aisa-provider": "apollo" }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "paths": { "/apis/v1/apollo/account_stages": { "get": { "description": "列出账户阶段。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_account_stages", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "account_stages": { "description": "账户阶段列表", "type": "string" }, "account_stages[].category": { "description": "类别", "type": "string" }, "account_stages[].default_exclude_for_leadgen": { "description": "潜在客户开发的默认排除项", "type": "boolean" }, "account_stages[].display_name": { "description": "显示名称", "type": "string" }, "account_stages[].display_order": { "description": "显示顺序", "type": "integer" }, "account_stages[].id": { "description": "阶段 ID", "type": "string" }, "account_stages[].is_meeting_set": { "description": "是否已安排会议", "type": "boolean" }, "account_stages[].name": { "description": "名称", "type": "string" }, "account_stages[].team_id": { "description": "团队 ID", "type": "string" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "列出账户阶段", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-account-stages", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:314313b9569254b2a9e2a71d318209d3dc610151425d1638b9434376402316b9", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7959984e59cd" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_account_stages", "path": "/apis/v1/apollo/account_stages" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/account_stages", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/accounts": { "post": { "description": "创建新账户。不允许域名重复。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_accounts", "requestBody": { "content": { "application/json": { "schema": { "properties": { "account_stage_id": { "description": "The Apollo ID for the account stage to which you want to assign the account. Call the list account stages endpoint to retrieve a list of all the account stage IDs available in your Apollo account.

If you do not specify the account stage, Apollo automatically assigns the account to a stage as determined by your team's Apollo account. To change the order of account stages, launch the Apollo product and go to Settings > Objects > Accounts. Then, access the Triggers tab and change the stage for when an account is created.

Example: `6095a710bd01d100a506d4b9`", "type": "string" }, "domain": { "description": "The domain name for the account.

Do not include `www.` or similar.

Example: `apollo.io` or `microsoft.com`", "type": "string" }, "name": { "description": "Name the account that you are creating. This should be a human-readable name.

Example: `The Irish Copywriters`", "type": "string" }, "owner_id": { "description": "The ID for the account owner within your team's Apollo account.

Use the get a list of users endpoint to retrieve IDs for all of the users within your Apollo account.

Example: `66302798d03b9601c7934ebf`", "type": "string" }, "phone": { "description": "The primary phone number for the account.

This can be the phone number for the corporate headquarters, a branch location, or a direct dial to the primary point of contact for the account.

Apollo sanitizes phone numbers, so you can enter them in any format. The sanitized number can be viewed in the endpoint response.

Examples: `555-555-0133`; `+44 7700 900852`", "type": "string" }, "raw_address": { "description": "The corporate location for the account. This can include a city, US state, and country.

Apollo matches the location you provide to the most applicable pre-defined location.

Examples: `Belfield, Dublin 4, Ireland`; `Dallas, United States`", "type": "string" }, "typed_custom_fields": { "additionalProperties": { "type": "string" }, "description": "Add information to custom fields in Apollo.

Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.

To utilize this parameter successfully, call the get a list of all custom fields endpoint and identify the `id` value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying `id` value for the picklist entry that you want to use as the input value.

Example: When the get a list of all custom fields endpoint returns an `id` of field: \n * `\"60c39ed82bd02f01154c470a\"` (datetime) \n \n\n then the value passed should be: \n\n `{\"60c39ed82bd02f01154c470a\": \"2025-08-07\"}`", "example": { "60c39ed82bd02f01154c470a": "2025-08-07" }, "type": "object" } }, "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "account": { "additionalProperties": true, "description": "已创建的账户", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "创建账户", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-accounts", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:3efe3b188b8fb1e0e2f9a701647b87acdbee7089e54ad5995ef638a12f826139", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a7b0c338b026" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_accounts", "path": "/apis/v1/apollo/accounts" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/accounts", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/accounts/bulk_create": { "post": { "description": "批量创建账户。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_accounts_bulk_create", "requestBody": { "content": { "application/json": { "examples": { "Basic Account Creation": { "value": { "accounts": [ { "domain": "acme.com", "name": "Acme Corporation", "phone": "+1-555-0135" }, { "domain": "example.com", "linkedin_url": "https://linkedin.com/company/techstart", "name": "TechStart Inc" } ] } }, "With CRM IDs (Returns Existing Without Updating)": { "value": { "accounts": [ { "name": "New Name", "phone": "+1-555-0159", "salesforce_id": "001pJNj9pix2idKsfj" }, { "hubspot_id": "12345678", "name": "Another New Name" } ] } }, "With Custom Fields and Labels": { "value": { "accounts": [ { "account_stage_id": "507f1f77bcf86cd799439014", "domain": "example.com", "name": "Enterprise Client", "typed_custom_fields": { "507f1f77bcf86cd799439020": "High Value", "507f1f77bcf86cd799439021": "Q4 2025" } } ], "append_label_names": [ "Enterprise", "Priority" ] } }, "With Deduplication (Returns Existing Without Updating)": { "value": { "accounts": [ { "domain": "existing-company.com", "name": "New Company Name" } ], "run_dedupe": true } } }, "schema": { "properties": { "accounts": { "description": "Array of account attribute objects (maximum 100 accounts per request)", "items": { "properties": { "account_stage_id": { "description": "Account stage/pipeline stage ID (BSON::ObjectId format)", "example": "507f1f77bcf86cd799439014", "type": "string" }, "domain": { "description": "Company domain (e.g., 'example.com')", "example": "acme.com", "type": "string" }, "facebook_url": { "description": "Facebook page URL", "example": "https://facebook.com/acme", "type": "string" }, "hubspot_id": { "description": "HubSpot company ID for CRM integration", "example": "12345678", "type": "string" }, "linkedin_url": { "description": "LinkedIn company page URL", "example": "https://linkedin.com/company/acme", "type": "string" }, "merged_crm_ids": { "description": "Additional CRM IDs for deduplication", "items": { "type": "string" }, "type": "array" }, "name": { "description": "账户名称", "example": "Acme Corporation", "type": "string" }, "organization_id": { "description": "Apollo organization ID", "example": "507f1f77bcf86cd799439012", "type": "string" }, "owner_id": { "description": "Account owner user ID (BSON::ObjectId format). Defaults to current user if not provided", "example": "507f1f77bcf86cd799439013", "type": "string" }, "parent_account_id": { "description": "Parent account ID for account hierarchy (BSON::ObjectId format)", "example": "507f1f77bcf86cd799439016", "type": "string" }, "phone": { "description": "Company phone number", "example": "+1-555-0135", "type": "string" }, "phone_status_cd": { "description": "Phone validation status", "type": "string" }, "raw_address": { "description": "Company address", "example": "123 Main St, San Francisco, CA 94105", "type": "string" }, "salesforce_id": { "description": "Salesforce account ID for CRM integration", "example": "001pJNj9pix2idKsfj", "type": "string" }, "twitter_url": { "description": "Twitter profile URL", "example": "https://twitter.com/acme", "type": "string" }, "typed_custom_fields": { "additionalProperties": { "type": "string" }, "description": "Custom field values as key-value pairs where key is the field_id and value is the field_value", "example": { "507f1f77bcf86cd799439020": "High Value", "507f1f77bcf86cd799439021": "Q4 2025" }, "type": "object" } }, "type": "object" }, "maxItems": 100, "type": "array" }, "append_label_names": { "description": "Array of label names to add to ALL accounts in this request", "example": [ "Enterprise", "High Priority" ], "items": { "type": "string" }, "type": "array" }, "run_dedupe": { "default": false, "description": "Enable aggressive deduplication by domain, organization_id, and name. When false (default), only matches by CRM IDs. When true, also matches by domain, organization_id, and name. Existing accounts are returned without modification in both modes", "example": true, "type": "boolean" } }, "required": [ "accounts" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "created_accounts": { "description": "此请求中创建的账户", "type": "string" }, "created_accounts[].account_stage_id": { "description": "账户阶段 ID", "type": "string" }, "created_accounts[].created_at": { "description": "创建时间戳", "type": "string" }, "created_accounts[].domain": { "description": "账户域名", "type": "string" }, "created_accounts[].id": { "description": "账户 ID", "type": "string" }, "created_accounts[].name": { "description": "账户名称", "type": "string" }, "created_accounts[].owner_id": { "description": "所有者 ID", "type": "string" }, "created_accounts[].phone": { "description": "电话号码", "type": "string" }, "created_accounts[].team_id": { "description": "团队 ID", "type": "string" }, "created_accounts[].updated_at": { "description": "更新时间戳", "type": "string" }, "existing_accounts": { "description": "已存在的账户（去重匹配项）", "type": "string" }, "existing_accounts[].account_stage_id": { "description": "账户阶段 ID", "type": "string" }, "existing_accounts[].created_at": { "description": "创建时间戳", "type": "string" }, "existing_accounts[].domain": { "description": "账户域名", "type": "string" }, "existing_accounts[].id": { "description": "账户 ID", "type": "string" }, "existing_accounts[].name": { "description": "账户名称", "type": "string" }, "existing_accounts[].owner_id": { "description": "所有者 ID", "type": "string" }, "existing_accounts[].phone": { "description": "电话号码", "type": "string" }, "existing_accounts[].team_id": { "description": "团队 ID", "type": "string" }, "existing_accounts[].updated_at": { "description": "更新时间戳", "type": "string" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "批量创建账户", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-accounts-bulk-create", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:f7763c06d7c4d93b7b47d893b1bf76878cda9a4ecd209c8481dfb22261b912fa", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1668e54e63f9" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_accounts_bulk_create", "path": "/apis/v1/apollo/accounts/bulk_create" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/accounts/bulk_create", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/accounts/bulk_update": { "post": { "description": "批量更新账户。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_accounts_bulk_update", "requestBody": { "content": { "application/json": { "schema": { "properties": { "account_attributes": { "description": "Array of account objects with individual updates. Use this for applying different updates to each account.", "items": { "properties": { "account_stage_id": { "description": "The Apollo account stage ID", "example": "6095a710bd01d100a506d4b7", "type": "string" }, "id": { "description": "The account ID to update", "example": "66e9abf95ac32901b20d1a0d", "type": "string" }, "name": { "description": "The account name", "example": "Acme Corporation", "type": "string" }, "owner_id": { "description": "The Apollo user ID to assign as owner", "example": "66302798d03b9601c7934ebf", "type": "string" }, "typed_custom_fields": { "additionalProperties": { "type": "string" }, "description": "Custom field values as key-value pairs", "example": { "60c39ed82bd02f01154c470a": "2025-08-07" }, "type": "object" } }, "required": [ "id" ], "type": "object" }, "type": "array" }, "account_ids": { "description": "Array of account IDs to update with the same values. Use this for applying the same updates to multiple accounts.", "example": [ "66e9abf95ac32901b20d1a0d", "66e9a4db056fe802d331fb8a" ], "items": { "type": "string" }, "type": "array" }, "account_stage_id": { "description": "When using account_ids, apply this account stage to all accounts", "example": "6095a710bd01d100a506d4b7", "type": "string" }, "async": { "description": "Set to true to process updates asynchronously. Only available when using account_ids. Not supported with account_attributes.", "example": false, "type": "boolean" }, "name": { "description": "When using account_ids, apply this name to all accounts", "example": "Updated Account Name", "type": "string" }, "owner_id": { "description": "When using account_ids, apply this owner to all accounts", "example": "66302798d03b9601c7934ebf", "type": "string" } }, "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "accounts": { "description": "已更新的账户", "type": "string" }, "accounts[].account_stage_id": { "description": "账户阶段 ID", "type": "string" }, "accounts[].id": { "description": "账户 ID", "type": "string" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "批量更新账户", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-accounts-bulk-update", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:474ca4a88887d05ccc93b0bf12f3522c0f54b4ed63aae983fecf6f29f28ba9a2", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "cf3634b917bc" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_accounts_bulk_update", "path": "/apis/v1/apollo/accounts/bulk_update" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/accounts/bulk_update", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/accounts/search": { "post": { "description": "搜索账户。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_accounts_search", "requestBody": { "content": { "application/json": { "schema": { "properties": { "account_label_ids": { "description": "The Apollo IDs for the labels that you want to include in your search results. If you add multiple labels, Apollo will include all accounts connected to any of the labels, along with the other parameters, in the search results. Example: `['6095a710bd01d100a506d4ae']`", "items": { "type": "string" }, "type": "array" }, "account_stage_ids": { "description": "The Apollo IDs for the account stages that you want to include in your search results. If you add multiple account stages, Apollo will include all accounts that match any of the stages, along with the other parameters, in the search results. Call the [list account stages endpoint](https://docs.apollo.io/reference/list-account-stages) to retrieve a list of all the account stage IDs available in your Apollo account. Example: `61b8e913e0f4d2012e3af74e`", "items": { "type": "string" }, "type": "array" }, "page": { "description": "The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the `per_page` parameter to make search results navigable and improve the performance of the endpoint. Example: `4`", "format": "int32", "type": "integer" }, "per_page": { "description": "The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance. Use the `page` parameter to navigate through the different pages of data. Example: `10`", "format": "int32", "type": "integer" }, "q_organization_name": { "description": "Add keywords to narrow the search of the accounts in your team's Apollo account. Keywords should directly match at least part of an account's name. For example, searching the keyword `marketing` might return the result `NY Marketing Unlimited`, but not `NY Market Analysts`. This parameter only searches account names, not other account fields. Examples: `apollo`; `microsoft`; `marketing`", "type": "string" }, "sort_ascending": { "default": false, "description": "Set to `true` to sort the matching accounts in ascending order. This parameter must be used with `sort_by_field`. Otherwise, the sorting logic is not applied. Example: `true`", "type": "boolean" }, "sort_by_field": { "description": "Sort the matching accounts by 1 of the following options:\n- `account_last_activity_date`: The most recent activity date recorded first.\n- `account_created_at`: The most recently created first.\n- `account_updated_at`: The most recently updated first.", "enum": [ "account_last_activity_date", "account_created_at", "account_updated_at" ], "type": "string" } }, "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "accounts": { "description": "响应数组", "items": { "additionalProperties": true, "description": "账户", "type": "object" }, "type": "array" }, "breadcrumbs": { "description": "响应数组", "items": { "additionalProperties": true, "description": "面包屑导航", "type": "object" }, "type": "array" }, "disable_eu_prospecting": { "description": "响应字段", "type": "boolean" }, "has_join": { "description": "响应字段", "type": "boolean" }, "num_fetch_result": { "additionalProperties": true, "description": "获取结果元数据", "type": [ "object", "null" ] }, "pagination": { "additionalProperties": true, "description": "分页元数据", "type": "object" }, "partial_results_limit": { "description": "响应字段", "type": "integer" }, "partial_results_only": { "description": "响应字段", "type": "boolean" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "搜索账户", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-accounts-search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:65d160b4870a989bb16cd6f82cf2ab3f15f22d45989c43f24dee1754cac78353", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5337238ad680" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_accounts_search", "path": "/apis/v1/apollo/accounts/search" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/accounts/search", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/accounts/update_owners": { "post": { "description": "批量更新多个账户的所有者。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_accounts_update_owners", "parameters": [ { "description": "账户 ID", "in": "query", "name": "account_ids[]", "required": true, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "新所有者 ID", "in": "query", "name": "owner_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "accounts": { "description": "已更新的账户", "type": "string" }, "accounts[].crm_owner_id": { "description": "CRM 所有者 ID", "type": "string" }, "accounts[].id": { "description": "账户 ID", "type": "string" }, "accounts[].owner_id": { "description": "所有者 ID", "type": "string" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "批量更新账户负责人", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-accounts-update-owners", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:ebf3e6437fc2830eedcd01c63d45a1e5f75850218ae86921de70a0b28f98c989", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b306f4b49856" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_accounts_update_owners", "path": "/apis/v1/apollo/accounts/update_owners" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/accounts/update_owners", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/accounts/{account_id}": { "patch": { "description": "更新现有账户的字段。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "patch_apollo_accounts_account_id", "parameters": [ { "description": "账户 ID", "in": "path", "name": "account_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "account_stage_id": { "description": "The Apollo ID for the account stage to which you want to assign the account. Enter a different ID to update the account stage.

Call the list account stages endpoint to retrieve a list of all the account stage IDs available in your Apollo account.

If you do not specify the account stage, Apollo automatically assigns the account to a stage as determined by your team's Apollo account. To change the order of account stages, launch the Apollo product and go to Settings > Objects > Accounts. Then, access the Triggers tab and change the stage for when an account is created.

Example: `61b8e913e0f4d2012e3af74e`", "type": "string" }, "domain": { "description": "Update the domain name for the account. Do not include `www.` or similar.

Example: `apollo.io` or `microsoft.com`", "type": "string" }, "name": { "description": "Update the account's name. This should be a human-readable name.

Example: `The Fast Irish Copywriters`", "type": "string" }, "owner_id": { "description": "The ID for the account owner within your team's Apollo account. Enter a different ID to update the owner of the account.

Use the get a list of users endpoint to retrieve IDs for all of the users within your Apollo account.

Example: `66302798d03b9601c7934ebf`", "type": "string" }, "phone": { "description": "Update the primary phone number for the account.

This can be the phone number for the corporate headquarters, a branch location, or a direct dial to the primary point of contact for the account.

Apollo sanitizes phone numbers, so you can enter them in any format. The sanitized number can be viewed in the endpoint response.

Examples: `555-555-0133`; `+44 7700 900852`", "type": "string" }, "raw_address": { "description": "Update the corporate location for the account. This can include a city, US state, and country.

Apollo matches the location you provide to the most applicable pre-defined location.

Examples: `Belfield, Dublin 4, Ireland`; `Dallas, United States`", "type": "string" }, "typed_custom_fields": { "additionalProperties": { "type": "string" }, "description": "Add information to custom fields in Apollo.

Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.

To utilize this parameter successfully, call the get a list of all custom fields endpoint and identify the `id` value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying `id` value for the picklist entry that you want to use as the input value.

Example: When the get a list of all custom fields endpoint returns an `id` of field: \n * `\"60c39ed82bd02f01154c470a\"` (datetime) \n \n\n then the value passed should be: \n\n `{\"60c39ed82bd02f01154c470a\": \"2025-08-07\"}`", "example": { "60c39ed82bd02f01154c470a": "2025-08-07" }, "type": "object" } }, "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "account": { "additionalProperties": true, "description": "已更新的账户", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "更新账户", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/patch_apollo-accounts-account-id", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:c6c609623505688db26dd95353f0991586d005887951e8c06794cc7f09c954fa", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1bd5d4692f7b" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "patch_apollo_accounts_account_id", "path": "/apis/v1/apollo/accounts/{account_id}" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/accounts/{account_id}", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/accounts/{id}": { "get": { "description": "按 ID 查看账户。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_accounts_id", "parameters": [ { "description": "账户 ID", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "account": { "additionalProperties": true, "description": "账户", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "查看账户", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-accounts-id", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:b78318eff7340733efc7d827394839aecbb41a8b4ce9a7a92768a86278470ab3", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8db59be70bfe" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_accounts_id", "path": "/apis/v1/apollo/accounts/{id}" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/accounts/{id}", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/contact_stages": { "get": { "description": "列出联系人阶段。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_contact_stages", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "contact_stages": { "description": "联系人阶段列表", "type": "string" }, "contact_stages[].category": { "description": "类别", "type": "string" }, "contact_stages[].display_name": { "description": "显示名称", "type": "string" }, "contact_stages[].display_order": { "description": "显示顺序", "type": "integer" }, "contact_stages[].id": { "description": "阶段 ID", "type": "string" }, "contact_stages[].ignore_trigger_override": { "description": "忽略触发器覆盖设置", "type": "boolean" }, "contact_stages[].is_meeting_set": { "description": "是否已安排会议", "type": "boolean" }, "contact_stages[].name": { "description": "名称", "type": "string" }, "contact_stages[].team_id": { "description": "团队 ID", "type": "string" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "列出联系人阶段", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-contact-stages", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:a21be582d64d92b19be19fea8e62425cb670b473e3d1b55651667426c13f2f53", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "aa33947107f0" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_contact_stages", "path": "/apis/v1/apollo/contact_stages" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/contact_stages", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/contacts": { "post": { "description": "创建新联系人。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_contacts", "requestBody": { "content": { "application/json": { "examples": { "Create contact with deduplication": { "summary": "Create a new contact with deduplication enabled", "value": { "email": "jane.doe@example.com", "first_name": "Jane", "last_name": "Doe", "organization_name": "Example Corp", "run_dedupe": true, "title": "Product Manager" } }, "Create contact without deduplication": { "summary": "Create a new contact without deduplication (default behavior)", "value": { "email": "john.smith@example.com", "first_name": "John", "last_name": "Smith", "organization_name": "Example Corp", "title": "Software Engineer" } } }, "schema": { "properties": { "account_id": { "description": "The Apollo ID for the account. Example: `63f53afe4ceeca00016bdd2f`", "type": "string" }, "contact_stage_id": { "description": "The Apollo ID for the contact stage. Example: `6095a710bd01d100a506d4ae`", "type": "string" }, "corporate_phone": { "description": "The work/office phone number. Example: `+44 7700 900852`", "type": "string" }, "direct_phone": { "description": "The primary phone number. Example: `555-555-0133`", "type": "string" }, "email": { "description": "The email address of the contact. Example: `example@email.com`", "type": "string" }, "first_name": { "description": "The first name of the contact you want to create. Example: `Tim`", "type": "string" }, "home_phone": { "description": "The home phone number. Example: `555-555-0133`", "type": "string" }, "label_names": { "description": "Lists to which the contact belongs.", "items": { "type": "string" }, "type": "array" }, "last_name": { "description": "The last name of the contact you want to create. Example: `Zheng`", "type": "string" }, "mobile_phone": { "description": "The mobile phone number. Example: `555-555-0133`", "type": "string" }, "organization_name": { "description": "The name of the contact's employer (company). Example: `apollo`", "type": "string" }, "other_phone": { "description": "Alternative phone number. Example: `555-555-0133`", "type": "string" }, "present_raw_address": { "description": "The personal location for the contact. Example: `Atlanta, United States`", "type": "string" }, "run_dedupe": { "default": false, "description": "Set to `true` to match against your existing contacts instead of always creating a new one. The default value is `false`.

When a match is found, Apollo **updates that existing contact in place** with the values you sent and returns it — the `id` in the response belongs to the pre-existing contact, not a new record. Fields you send overwrite the stored values, fields you omit are left untouched, and sending an empty value clears the field.

Matching is checked in order: `id`, CRM identifiers, `person_id`, `email` (against the contact's primary and additional emails), then name plus company. Because of the last rule, a contact can be matched and updated even when the email differs.

When deduplication is enabled, performance may be slightly impacted due to the additional matching checks. See the endpoint description for full details.", "type": "boolean" }, "title": { "description": "The current job title that the contact holds. Example: `senior research analyst`", "type": "string" }, "typed_custom_fields": { "additionalProperties": { "type": "string" }, "description": "Add information to custom fields in Apollo.

Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.

To utilize this parameter successfully, call the get a list of all custom fields endpoint and identify the `id` value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying `id` value for the picklist entry that you want to use as the input value.

Example: When the get a list of all custom fields endpoint returns an `id` of field: \n * `\"60c39ed82bd02f01154c470a\"` (datetime) \n \n\n then the value passed should be: \n\n `{\"60c39ed82bd02f01154c470a\": \"2025-08-07\"}`", "example": { "60c39ed82bd02f01154c470a": "2025-08-07" }, "type": "object" }, "website_url": { "description": "The corporate website URL. Example: `https://www.apollo.io/`", "type": "string" } }, "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "contact": { "additionalProperties": true, "description": "已创建的联系人", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "创建联系人", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-contacts", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:4a7a89e75801ee9b730b52cfaa6f1a5adbc9c398baee076590a1c293291e7ac0", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c14358c33fd6" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_contacts", "path": "/apis/v1/apollo/contacts" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/contacts", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/contacts/bulk_create": { "post": { "description": "批量创建联系人。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_contacts_bulk_create", "requestBody": { "content": { "application/json": { "examples": { "Basic Contact Creation": { "value": { "contacts": [ { "email": "john.doe@example.com", "first_name": "John", "last_name": "Doe", "organization_name": "Acme Corporation", "title": "Senior Manager" }, { "email": "jane.smith@example.com", "first_name": "Jane", "last_name": "Smith", "linkedin_url": "https://www.linkedin.com/in/jane-smith-4c8e21a9", "organization_name": "TechStart Inc", "title": "VP of Sales" } ] } }, "With CRM IDs (Returns Existing Without Updating)": { "value": { "contacts": [ { "email": "john.doe@example.com", "first_name": "John", "last_name": "Doe", "phone": "+1-555-0159", "salesforce_contact_id": "003xx000004TmiQAAS" }, { "email": "jane.smith@example.com", "first_name": "Jane", "hubspot_id": "12345678", "last_name": "Smith" } ] } }, "With Custom Fields and Labels": { "value": { "append_label_names": [ "VIP", "Decision Maker" ], "contacts": [ { "contact_stage_id": "507f1f77bcf86cd799439014", "email": "sarah.whitfield@example.com", "first_name": "Sarah", "last_name": "Whitfield", "organization_name": "Enterprise Corp", "title": "CTO", "typed_custom_fields": { "60c39ed82bd02f01154c470a": "2025-12-31", "60c39ed82bd02f01154c470b": "High Priority" } } ] } }, "With Full Deduplication (Returns Existing Without Updating)": { "value": { "contacts": [ { "email": "existing@example.com", "first_name": "New", "last_name": "Name", "title": "New Title" } ], "run_dedupe": true } }, "With Multiple Contact Details": { "value": { "contacts": [ { "contact_emails": [ { "email": "michael.brown@example.com", "position": 0 }, { "email": "mbrown@example.com", "position": 1 } ], "first_name": "Michael", "last_name": "Brown", "organization_name": "Tech Solutions", "phone_numbers": [ { "position": 0, "raw_number": "+1-555-0135" }, { "position": 1, "raw_number": "+1-555-0122" } ] } ] } }, "With Top-Level Owner Assignment": { "value": { "contacts": [ { "account_id": "507f1f77bcf86cd799439011", "email": "alice.chen@example.com", "first_name": "Alice", "last_name": "Chen", "organization_name": "CloudCo", "title": "Director of Engineering" }, { "account_id": "507f1f77bcf86cd799439011", "email": "bob.lee@example.com", "first_name": "Bob", "last_name": "Lee", "organization_name": "CloudCo", "title": "Head of Product" } ], "owner_id": "507f1f77bcf86cd799439013" } } }, "schema": { "properties": { "append_label_names": { "description": "Array of label names to add to ALL contacts in this request", "example": [ "Hot Lead", "Q1 2024" ], "items": { "type": "string" }, "type": "array" }, "contacts": { "description": "Array of contact objects to create (maximum 100 contacts per request)", "items": { "properties": { "account_id": { "description": "Associated account ID", "example": "507f1f77bcf86cd799439011", "type": "string" }, "contact_emails": { "description": "Array of email objects with position", "items": { "properties": { "email": { "example": "john.doe@example.com", "type": "string" }, "position": { "example": 0, "type": "integer" } }, "type": "object" }, "type": "array" }, "contact_stage_id": { "description": "联系人阶段 ID", "example": "507f1f77bcf86cd799439014", "type": "string" }, "email": { "description": "Contact's email address", "example": "john.doe@example.com", "type": "string" }, "facebook_url": { "description": "Facebook profile URL", "example": "https://www.facebook.com/johndoe", "type": "string" }, "first_name": { "description": "Contact's first name", "example": "John", "type": "string" }, "hubspot_id": { "description": "HubSpot ID for matching and deduplication", "example": "12345678", "type": "string" }, "last_name": { "description": "Contact's last name", "example": "Doe", "type": "string" }, "linkedin_url": { "description": "LinkedIn profile URL", "example": "https://www.linkedin.com/in/john-doe-3f9a7c21", "type": "string" }, "organization_id": { "description": "Associated organization ID", "example": "507f1f77bcf86cd799439012", "type": "string" }, "organization_name": { "description": "Company/organization name", "example": "Acme Corporation", "type": "string" }, "outreach_id": { "description": "Outreach.io ID", "example": "98765", "type": "string" }, "phone": { "description": "电话号码", "example": "+1-555-0135", "type": "string" }, "phone_numbers": { "description": "Array of phone number objects", "items": { "properties": { "position": { "example": 0, "type": "integer" }, "raw_number": { "example": "+1-555-0135", "type": "string" } }, "type": "object" }, "type": "array" }, "phone_status_cd": { "description": "Phone validation status", "type": "string" }, "photo_url": { "description": "Profile photo URL", "example": "https://example.com/photo.jpg", "type": "string" }, "present_raw_address": { "description": "Physical address", "example": "San Francisco, CA", "type": "string" }, "primary_title": { "description": "Primary job title (takes precedence over title)", "example": "VP of Sales", "type": "string" }, "salesforce_account_id": { "description": "Salesforce Account ID", "example": "001pJNj9pix2idKsfj", "type": "string" }, "salesforce_contact_id": { "description": "Salesforce Contact ID for matching", "example": "003xx000004TmiQAAS", "type": "string" }, "salesforce_id": { "description": "Salesforce ID for matching and deduplication", "example": "003xx000004TmiQAAS", "type": "string" }, "salesforce_lead_id": { "description": "Salesforce Lead ID", "example": "00Qxx000001abcDEFG", "type": "string" }, "salesloft_id": { "description": "SalesLoft ID", "example": "54321", "type": "string" }, "title": { "description": "Contact's job title", "example": "Senior Manager", "type": "string" }, "twitter_url": { "description": "Twitter profile URL", "example": "https://twitter.com/johndoe", "type": "string" }, "typed_custom_fields": { "additionalProperties": { "type": "string" }, "description": "Custom field values as key-value pairs where key is the field_id and value is the field_value", "example": { "60c39ed82bd02f01154c470a": "2025-08-07" }, "type": "object" } }, "type": "object" }, "maxItems": 100, "type": "array" }, "owner_id": { "description": "Owner user ID applied to all contacts in this batch. Defaults to current user if omitted. Returns 422 if the ID does not belong to the current team.", "example": "507f1f77bcf86cd799439013", "type": "string" }, "run_dedupe": { "default": false, "description": "Enable full deduplication across all sources. When false (default), creates duplicates for non-email_import sources and merges with email_import placeholders only. When true, returns existing contacts in `existing_contacts` without modifying them (except email_import placeholders, which are still merged).

Matching is checked in order: `id`, CRM identifiers, `person_id`, `email` (against the contact's primary and additional emails), then name plus company (matched on email domain, `organization_id`, or `organization_name`).

Unlike create a contact, this endpoint never overwrites a matched contact's fields.", "example": true, "type": "boolean" } }, "required": [ "contacts" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "created_contacts": { "description": "此请求中创建的联系人", "type": "string" }, "created_contacts[].account_id": { "description": "账户 ID", "type": "string" }, "created_contacts[].email": { "description": "电子邮件", "type": "string" }, "created_contacts[].first_name": { "description": "名字", "type": "string" }, "created_contacts[].id": { "description": "联系人 ID", "type": "string" }, "created_contacts[].last_name": { "description": "姓氏", "type": "string" }, "created_contacts[].organization_name": { "description": "组织名称", "type": "string" }, "created_contacts[].owner_id": { "description": "所有者 ID", "type": "string" }, "created_contacts[].phone_numbers": { "description": "电话号码", "type": "string" }, "created_contacts[].title": { "description": "标题", "type": "string" }, "created_contacts[].typed_custom_fields": { "description": "类型化自定义字段对象", "type": "object" }, "created_contacts[].updated_at": { "description": "更新时间戳", "type": "string" }, "existing_contacts": { "description": "已存在的联系人（去重匹配项）", "type": "string" }, "existing_contacts[].account_id": { "description": "账户 ID", "type": "string" }, "existing_contacts[].email": { "description": "电子邮件", "type": "string" }, "existing_contacts[].first_name": { "description": "名字", "type": "string" }, "existing_contacts[].id": { "description": "联系人 ID", "type": "string" }, "existing_contacts[].last_name": { "description": "姓氏", "type": "string" }, "existing_contacts[].organization_name": { "description": "组织名称", "type": "string" }, "existing_contacts[].owner_id": { "description": "所有者 ID", "type": "string" }, "existing_contacts[].phone_numbers": { "description": "电话号码", "type": "string" }, "existing_contacts[].title": { "description": "标题", "type": "string" }, "existing_contacts[].typed_custom_fields": { "description": "类型化自定义字段对象", "type": "object" }, "existing_contacts[].updated_at": { "description": "更新时间戳", "type": "string" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "批量创建联系人", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-contacts-bulk-create", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:6db95cc0bca89268140a7b3a674922af9ffe88ffa2419ac0e558c288227532d7", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2b5c760150eb" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_contacts_bulk_create", "path": "/apis/v1/apollo/contacts/bulk_create" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/contacts/bulk_create", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/contacts/bulk_update": { "post": { "description": "批量更新联系人。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_contacts_bulk_update", "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "required": [ "contact_ids" ] }, { "required": [ "contact_attributes" ] } ], "properties": { "account_id": { "description": "When using contact_ids, apply this account ID to all contacts", "example": "63f53afe4ceeca00016bdd2f", "type": "string" }, "async": { "description": "Force asynchronous processing. Automatically enabled for >100 contacts.", "example": false, "type": "boolean" }, "contact_attributes": { "description": "Array of contact objects with individual updates. Use this for applying different updates to each contact.", "items": { "properties": { "account_id": { "description": "The Apollo account ID to associate with the contact", "example": "63f53afe4ceeca00016bdd2f", "type": "string" }, "email": { "description": "The contact's email address", "example": "john.doe@example.com", "type": "string" }, "first_name": { "description": "The contact's first name", "example": "John", "type": "string" }, "id": { "description": "The contact ID to update", "example": "66e34b81740c50074e3d1bd4", "type": "string" }, "last_name": { "description": "The contact's last name", "example": "Doe", "type": "string" }, "linkedin_url": { "description": "The contact's LinkedIn profile URL", "example": "https://www.linkedin.com/in/john-doe-3f9a7c21", "type": "string" }, "organization_name": { "description": "The contact's organization name", "example": "Example Corp", "type": "string" }, "owner_id": { "description": "The Apollo user ID to assign as owner", "example": "66302798d03b9601c7934ebf", "type": "string" }, "present_raw_address": { "description": "The contact's location", "example": "San Francisco, CA", "type": "string" }, "title": { "description": "The contact's job title", "example": "Senior Manager", "type": "string" }, "typed_custom_fields": { "additionalProperties": { "type": "string" }, "description": "Custom field values as key-value pairs", "example": { "60c39ed82bd02f01154c470a": "2025-08-07" }, "type": "object" } }, "required": [ "id" ], "type": "object" }, "type": "array" }, "contact_ids": { "description": "Array of contact IDs to update with the same values. Use this for applying the same updates to multiple contacts.", "example": [ "66e34b81740c50074e3d1bd4", "66e370fbf5f5c003f0e1d0cf" ], "items": { "type": "string" }, "type": "array" }, "email": { "description": "When using contact_ids, apply this email to all contacts", "example": "updated@example.com", "type": "string" }, "first_name": { "description": "When using contact_ids, apply this first name to all contacts", "example": "Updated", "type": "string" }, "last_name": { "description": "When using contact_ids, apply this last name to all contacts", "example": "Name", "type": "string" }, "linkedin_url": { "description": "When using contact_ids, apply this LinkedIn URL to all contacts", "example": "https://www.linkedin.com/in/updated", "type": "string" }, "organization_name": { "description": "When using contact_ids, apply this organization name to all contacts", "example": "Updated Corp", "type": "string" }, "owner_id": { "description": "When using contact_ids, apply this owner to all contacts", "example": "66302798d03b9601c7934ebf", "type": "string" }, "present_raw_address": { "description": "When using contact_ids, apply this address to all contacts", "example": "New York, NY", "type": "string" }, "title": { "description": "When using contact_ids, apply this title to all contacts", "example": "Updated Title", "type": "string" }, "typed_custom_fields": { "additionalProperties": { "type": "string" }, "description": "When using contact_ids, apply these custom fields to all contacts", "example": { "60c39ed82bd02f01154c470a": "2025-08-07" }, "type": "object" }, "visible_entity_ids": { "description": "Specific contact IDs to return in the response (for performance)", "example": [ "66e34b81740c50074e3d1bd4" ], "items": { "type": "string" }, "type": "array" } }, "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "contacts": { "description": "已更新的联系人", "type": "string" }, "contacts[].account_id": { "description": "账户 ID", "type": "string" }, "contacts[].email": { "description": "电子邮件", "type": "string" }, "contacts[].first_name": { "description": "名字", "type": "string" }, "contacts[].id": { "description": "联系人 ID", "type": "string" }, "contacts[].last_name": { "description": "姓氏", "type": "string" }, "contacts[].linkedin_url": { "description": "LinkedIn URL", "type": "string" }, "contacts[].organization_name": { "description": "组织名称", "type": "string" }, "contacts[].owner_id": { "description": "所有者 ID", "type": "string" }, "contacts[].present_raw_address": { "description": "原始地址", "type": "string" }, "contacts[].title": { "description": "标题", "type": "string" }, "contacts[].updated_at": { "description": "更新时间戳", "type": "string" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "批量更新联系人", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-contacts-bulk-update", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:7e5e49de66f415fd4b46f63967d1df7ada1864416b815f70e6ce941324bc6b06", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "94f381c5855a" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_contacts_bulk_update", "path": "/apis/v1/apollo/contacts/bulk_update" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/contacts/bulk_update", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/contacts/search": { "post": { "description": "搜索联系人。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_contacts_search", "requestBody": { "content": { "application/json": { "schema": { "properties": { "contact_label_ids": { "description": "The Apollo IDs for the labels that you want to include in your search results. If you add multiple labels, Apollo will include all contacts connected to any of the labels, along with the other parameters, in the search results. Example: `['6095a710bd01d100a506d4ae']`", "items": { "type": "string" }, "type": "array" }, "contact_stage_ids": { "description": "The Apollo IDs for the contact stages that you want to include in your search results. If you add multiple contact stages, Apollo will include all contacts that match any of the stages, along with the other parameters, in the search results. Call the [list contact stages endpoint](https://docs.apollo.io/reference/list-contact-stages) to retrieve a list of all the contact stage IDs available in your Apollo account. Example: `6095a710bd01d100a506d4ae`", "items": { "type": "string" }, "type": "array" }, "page": { "description": "The page number of the Apollo data that you want to retrieve. Use this parameter in combination with the `per_page` parameter to make search results navigable and improve the performance of the endpoint. Example: `4`", "format": "int32", "type": "integer" }, "per_page": { "description": "The number of search results that should be returned for each page. Limiting the number of results per page improves the endpoint's performance. Use the `page` parameter to search the different pages of data. Example: `10`", "format": "int32", "type": "integer" }, "q_keywords": { "description": "Add a keyword search string to narrow the contacts in your team's Apollo account. Keywords should be related to the same search concept and can include names, job titles, employers or company names, or email addresses. Examples: `matthew helm`; `CEO`; `Sumware Software`", "type": "string" }, "sort_ascending": { "default": false, "description": "Set to `true` to sort the matching contacts in ascending order. This parameter must be used with `sort_by_field`. Otherwise, the sorting logic is not applied. Example: `true`", "type": "boolean" }, "sort_by_field": { "description": "Sort the matching contacts by 1 of the following options: \n- `contact_last_activity_date`: The most recent activity date recorded first.\n- `contact_email_last_opened_at`: The most recent email opened date first.\n- `contact_email_last_clicked_at`: The most recent email clicked first.\n- `contact_created_at`: The most recently created first.\n- `contact_updated_at`: The most recently updated first.", "type": "string" } }, "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "breadcrumbs": { "description": "响应数组", "items": { "additionalProperties": true, "description": "面包屑导航", "type": "object" }, "type": "array" }, "contacts": { "description": "响应数组", "items": { "additionalProperties": true, "description": "联系人", "type": "object" }, "type": "array" }, "disable_eu_prospecting": { "description": "响应字段", "type": "boolean" }, "has_join": { "description": "响应字段", "type": "boolean" }, "num_fetch_result": { "additionalProperties": true, "description": "获取结果元数据", "type": [ "object", "null" ] }, "pagination": { "additionalProperties": true, "description": "分页元数据", "type": "object" }, "partial_results_limit": { "description": "响应字段", "type": "integer" }, "partial_results_only": { "description": "响应字段", "type": "boolean" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "搜索联系人", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-contacts-search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:f0949578236317d865eed847df369e73df3bec4f013e0a62254b4c1535d13e0a", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "44ba30e71231" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_contacts_search", "path": "/apis/v1/apollo/contacts/search" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/contacts/search", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/contacts/update_owners": { "post": { "description": "更新多个联系人的负责人。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_contacts_update_owners", "parameters": [ { "description": "联系人 ID", "in": "query", "name": "contact_ids[]", "required": true, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "新所有者 ID", "in": "query", "name": "owner_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "contacts": { "description": "已更新的联系人", "type": "string" }, "contacts[].crm_owner_id": { "description": "CRM 所有者 ID", "type": "string" }, "contacts[].id": { "description": "联系人 ID", "type": "string" }, "contacts[].owner_id": { "description": "所有者 ID", "type": "string" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "批量更新联系人所有者", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-contacts-update-owners", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:e9f921d031285d6202c523deaf09685e6d2c8a02f38ad5c1111ecfcdb7c16ecd", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0426b96b52da" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_contacts_update_owners", "path": "/apis/v1/apollo/contacts/update_owners" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/contacts/update_owners", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/contacts/update_stages": { "post": { "description": "批量更新多个联系人的阶段。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_contacts_update_stages", "parameters": [ { "description": "联系人 ID", "in": "query", "name": "contact_ids[]", "required": true, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "新联系人阶段 ID", "in": "query", "name": "contact_stage_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "contacts": { "description": "已更新的联系人", "type": "string" }, "contacts[].contact_stage_id": { "description": "联系人阶段 ID", "type": "string" }, "contacts[].email": { "description": "电子邮件", "type": "string" }, "contacts[].first_name": { "description": "名字", "type": "string" }, "contacts[].id": { "description": "联系人 ID", "type": "string" }, "contacts[].last_name": { "description": "姓氏", "type": "string" }, "contacts[].organization_name": { "description": "组织名称", "type": "string" }, "contacts[].owner_id": { "description": "所有者 ID", "type": "string" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "批量更新联系人阶段", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-contacts-update-stages", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:3aa0c49e3b57c9b058730769dd9206767af6828f536a1293b0ace908a4c26a6c", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e0da0245de25" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_contacts_update_stages", "path": "/apis/v1/apollo/contacts/update_stages" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/contacts/update_stages", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/contacts/{contact_id}": { "get": { "description": "按 ID 查看联系人。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_contacts_contact_id", "parameters": [ { "description": "联系人 ID", "in": "path", "name": "contact_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "contact": { "description": "联系人对象", "type": "object" }, "contact.account_id": { "description": "账户 ID", "type": "string" }, "contact.email": { "description": "电子邮件", "type": "string" }, "contact.first_name": { "description": "名字", "type": "string" }, "contact.id": { "description": "联系人 ID", "type": "string" }, "contact.last_name": { "description": "姓氏", "type": "string" }, "contact.linkedin_url": { "description": "LinkedIn URL", "type": "string" }, "contact.organization_name": { "description": "组织名称", "type": "string" }, "contact.owner_id": { "description": "所有者 ID", "type": "string" }, "contact.phone_numbers": { "description": "电话号码", "type": "string" }, "contact.phone_numbers[].raw_number": { "description": "原始数值", "type": "string" }, "contact.phone_numbers[].sanitized_number": { "description": "清理后的号码", "type": "string" }, "contact.present_raw_address": { "description": "原始地址", "type": "string" }, "contact.title": { "description": "标题", "type": "string" }, "contact.updated_at": { "description": "更新时间戳", "type": "string" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Update or View Contact", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-contacts-contact-id", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:cafc79beae687d287801fffd66c369b5c3734b4e87ae1edc007d04c233911814", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bdbc0c09ed7e" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_contacts_contact_id", "path": "/apis/v1/apollo/contacts/{contact_id}" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/contacts/{contact_id}", "x-aisa-validation": "provider" }, "patch": { "description": "按 ID 查看联系人。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "patch_apollo_contacts_contact_id", "parameters": [ { "description": "联系人 ID", "in": "path", "name": "contact_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "account_id": { "description": "Update the account ID. Example: `63f53afe4ceeca00016bdd2f`", "type": "string" }, "contact_stage_id": { "description": "Update the contact stage ID. Example: `6095a710bd01d100a506d4af`", "type": "string" }, "corporate_phone": { "description": "Work/office phone.", "type": "string" }, "direct_phone": { "description": "Primary phone.", "type": "string" }, "email": { "description": "Update the contact email. Example: `example@email.com`", "type": "string" }, "first_name": { "description": "Update the contact's first name. Example: `Tim`", "type": "string" }, "home_phone": { "description": "Home phone.", "type": "string" }, "label_names": { "description": "Replace lists this contact belongs to. (Passing new values will overwrite existing lists.)", "items": { "type": "string" }, "type": "array" }, "last_name": { "description": "Update the contact's last name. Example: `Zheng`", "type": "string" }, "mobile_phone": { "description": "Mobile phone.", "type": "string" }, "organization_name": { "description": "Update the employer (company) name. Example: `apollo`", "type": "string" }, "other_phone": { "description": "Alternate phone.", "type": "string" }, "present_raw_address": { "description": "Update location (city/state/country). Example: `Atlanta, United States`", "type": "string" }, "title": { "description": "Update the job title. Example: `senior research analyst`", "type": "string" }, "typed_custom_fields": { "additionalProperties": { "type": "string" }, "description": "Add information to custom fields in Apollo.

Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.

To utilize this parameter successfully, call the get a list of all custom fields endpoint and identify the `id` value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying `id` value for the picklist entry that you want to use as the input value.

Example: When the get a list of all custom fields endpoint returns an `id` of field: \n * `\"60c39ed82bd02f01154c470a\"` (datetime) \n \n\n then the value passed should be: \n\n `{\"60c39ed82bd02f01154c470a\": \"2025-08-07\"}`", "example": { "60c39ed82bd02f01154c470a": "2025-08-07" }, "type": "object" }, "website_url": { "description": "Update the employer website URL. Example: `https://www.apollo.io/`", "type": "string" } }, "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "contact": { "description": "已更新的联系人", "type": "object" }, "contact.account_id": { "description": "账户 ID", "type": "string" }, "contact.email": { "description": "电子邮件", "type": "string" }, "contact.first_name": { "description": "名字", "type": "string" }, "contact.id": { "description": "联系人 ID", "type": "string" }, "contact.last_name": { "description": "姓氏", "type": "string" }, "contact.organization_name": { "description": "组织名称", "type": "string" }, "contact.owner_id": { "description": "所有者 ID", "type": "string" }, "contact.present_raw_address": { "description": "原始地址", "type": "string" }, "contact.title": { "description": "标题", "type": "string" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Update or View Contact", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/patch_apollo-contacts-contact-id", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:af9a5661bc0af5f5a5bf37e030b661f98a1d48a01a5506ee56ba354272e5ab8f", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bdbc0c09ed7e" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_contacts_contact_id", "path": "/apis/v1/apollo/contacts/{contact_id}" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/contacts/{contact_id}", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/email_accounts": { "get": { "description": "获取电子邮件账户列表。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_email_accounts", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "email_accounts": { "description": "电子邮件账户（返回时）。", "items": { "type": "string" }, "type": "array" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "获取电子邮件账户列表", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-email-accounts", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:469561e98eb7969b4c20abc036c4856a38898ba2b23a779ecec5ee4241e7650e", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b3dee57d06be" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_email_accounts", "path": "/apis/v1/apollo/email_accounts" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/email_accounts", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/emailer_campaigns/remove_or_stop_contact_ids": { "post": { "description": "更新序列中的联系人状态。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_emailer_campaigns_remove_or_stop_contact_ids", "parameters": [ { "description": "联系人 ID。", "in": "query", "name": "contact_ids[]", "required": true, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "序列 ID。", "in": "query", "name": "emailer_campaign_ids[]", "required": true, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "以下值之一：mark_as_finished、remove、stop。", "in": "query", "name": "mode", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "success": { "description": "更新是否成功（返回时）。", "type": "boolean" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "更新序列中的联系人状态", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-remove-or-stop-contact-ids", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:20a3de1cca78a177acf6ca961db49d2b2e1f232b43dc020e82021ae12f72afdd", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6c0be94ded0d" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_emailer_campaigns_remove_or_stop_contact_ids", "path": "/apis/v1/apollo/emailer_campaigns/remove_or_stop_contact_ids" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/emailer_campaigns/remove_or_stop_contact_ids", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/emailer_campaigns/search": { "post": { "description": "在您的 Apollo 账户中搜索序列（电子邮件营销活动）。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_emailer_campaigns_search", "parameters": [ { "description": "页码。", "in": "query", "name": "page", "required": false, "schema": { "type": "integer" } }, { "description": "每页结果数。", "in": "query", "name": "per_page", "required": false, "schema": { "type": "integer" } }, { "description": "用于匹配序列名称的关键词。", "in": "query", "name": "q_name", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "emailer_campaigns": { "description": "序列记录（返回时）。", "items": { "type": "string" }, "type": "array" }, "pagination": { "description": "分页元数据（返回时）。", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "搜索序列", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:d63cb1faae10a7de1ece34d1438668c85e1a473353310a0b8bdf48f2fcd7e5ee", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ea9942cfeddf" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_emailer_campaigns_search", "path": "/apis/v1/apollo/emailer_campaigns/search" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/emailer_campaigns/search", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/emailer_campaigns/{sequence_id}/abort": { "post": { "description": "停用序列。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_emailer_campaigns_sequence_id_abort", "parameters": [ { "description": "序列 ID。", "in": "path", "name": "sequence_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "emailer_campaign": { "description": "序列对象（返回时）。", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "停用序列", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-sequence-id-abort", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:cc8ac3b8dd33e2200fb7a7f8636765d9dfa40d36d68c2eee5fe0f8a0978bec69", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a8c903c4af9f" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_emailer_campaigns_sequence_id_abort", "path": "/apis/v1/apollo/emailer_campaigns/{sequence_id}/abort" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/emailer_campaigns/{sequence_id}/abort", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/emailer_campaigns/{sequence_id}/add_contact_ids": { "post": { "description": "将联系人添加到序列。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_emailer_campaigns_sequence_id_add_contact_ids", "parameters": [ { "description": "序列（邮件营销活动）ID。", "in": "path", "name": "sequence_id", "required": true, "schema": { "type": "string" } }, { "description": "要添加的联系人 ID。请提供 contact_ids[] 或 label_names[]（也可两者都提供）。", "in": "query", "name": "contact_ids[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "序列 ID（与 sequence_id 相同）。", "in": "query", "name": "emailer_campaign_id", "required": true, "schema": { "type": "string" } }, { "description": "要添加到联系人的标签名称。请提供 label_names[] 或 contact_ids[]（也可同时提供）。", "in": "query", "name": "label_names[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "用于发送邮件的邮箱账户 ID（可指定一个或多个）。", "in": "query", "name": "send_email_from_email_account_id", "required": true, "schema": { "type": "string" } }, { "description": "可选的发件地址别名。", "in": "query", "name": "send_email_from_email_address", "required": false, "schema": { "type": "string" } }, { "description": "允许联系人同时活跃于其他序列中。", "in": "query", "name": "sequence_active_in_other_campaigns", "required": false, "schema": { "type": "boolean" } }, { "description": "允许已在其他序列中完成的联系人。", "in": "query", "name": "sequence_finished_in_other_campaigns", "required": false, "schema": { "type": "boolean" } }, { "description": "允许职位发生变动的联系人。", "in": "query", "name": "sequence_job_change", "required": false, "schema": { "type": "boolean" } }, { "description": "允许没有电子邮件地址的联系人。", "in": "query", "name": "sequence_no_email", "required": false, "schema": { "type": "boolean" } }, { "description": "允许电子邮件未经验证的联系人。", "in": "query", "name": "sequence_unverified_email", "required": false, "schema": { "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "success": { "description": "添加是否成功（返回时）。", "type": "boolean" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "将联系人添加到序列", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-sequence-id-add-contact-ids", "x-aisa-identity": { "canonical_operation_id": "post_apollo_emailer_campaigns_add_contact_ids", "historical_aliases": [ { "canonical_source_file": "openapi/apollo.json", "canonical_source_sha256": "b862a76afba7c6821b6e4d0264d7567ab5fa442c566ee276024f846d86728764", "locale": "zh", "method": "POST", "operation_id": "post_apollo_emailer_campaigns_sequence_id_add_contact_ids", "public_path": "/apis/v1/apollo/emailer_campaigns/{sequence_id}/add_contact_ids", "published_ref": "e0ee9af05d7407976af62a72ac4e3499703a4f6a", "source_file": "openapi/zh/apollo.json", "source_sha256": "0240b36a721716c71cb7587813f7a832e0bb2b519b49217f73ff607666837815" } ], "schema_version": 1, "sha256": "sha256:baa386af467f49a315a1a8b2cd4aad7e66819e0d87e80b085a4d9e7e509f9f09" }, "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:378788aae1190adc12379d13624c91cde312b4bf816d349850128e222b2d20d2", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e80bfe3cd1aa" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_emailer_campaigns_add_contact_ids", "path": "/apis/v1/apollo/emailer_campaigns/{sequence_id}/add_contact_ids" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/emailer_campaigns/{sequence_id}/add_contact_ids", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/emailer_campaigns/{sequence_id}/approve": { "post": { "description": "激活序列。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_emailer_campaigns_sequence_id_approve", "parameters": [ { "description": "序列 ID。", "in": "path", "name": "sequence_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "emailer_campaign": { "description": "序列对象（返回时）。", "type": "object" }, "emailer_steps": { "description": "序列步骤（返回时）。", "items": { "type": "string" }, "type": "array" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "激活序列", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-sequence-id-approve", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:17990a9d32d4c8022e561bd01e09d8118e5a6afa0834309add3f41477f6834d2", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8539cc0b9640" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_emailer_campaigns_sequence_id_approve", "path": "/apis/v1/apollo/emailer_campaigns/{sequence_id}/approve" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/emailer_campaigns/{sequence_id}/approve", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/emailer_campaigns/{sequence_id}/archive": { "post": { "description": "归档序列（将其标记为非活动状态并结束联系人流程）。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_emailer_campaigns_sequence_id_archive", "parameters": [ { "description": "序列 ID。", "in": "path", "name": "sequence_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "emailer_campaign": { "description": "已归档的序列对象（返回时）。", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "归档序列", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-sequence-id-archive", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:94e1663e0669adaa3bded728593875c4f78a6cedb98427852645c0a4262a0d09", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f7fb9165ac2b" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_emailer_campaigns_sequence_id_archive", "path": "/apis/v1/apollo/emailer_campaigns/{sequence_id}/archive" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/emailer_campaigns/{sequence_id}/archive", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/emailer_messages/search": { "get": { "description": "搜索外联电子邮件。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_emailer_messages_search", "parameters": [ { "description": "按电子邮件账户和别名筛选。", "in": "query", "name": "email_account_id_and_aliases", "required": false, "schema": { "type": "string" } }, { "description": "仅包含这些序列 ID。", "in": "query", "name": "emailer_campaign_ids[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "按回复类别筛选。", "in": "query", "name": "emailer_message_reply_classes[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "按消息统计信息筛选（例如 open、click）。", "in": "query", "name": "emailer_message_stats[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "排除这些序列 ID。", "in": "query", "name": "not_emailer_campaign_ids[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "页码。", "in": "query", "name": "page", "required": false, "schema": { "type": "integer" } }, { "description": "每页结果数。", "in": "query", "name": "per_page", "required": false, "schema": { "type": "integer" } }, { "description": "按用户 ID 筛选。", "in": "query", "name": "user_ids[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "emailer_messages": { "description": "外联邮件（如有返回）。", "items": { "type": "string" }, "type": "array" }, "pagination": { "description": "分页元数据（返回时）。", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "搜索外联电子邮件", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-emailer-messages-search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:196f05db7e420b16f773463af71c8550de29f4218ac836f55bbf48db98603aac", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "ca78f0166a41" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_emailer_messages_search", "path": "/apis/v1/apollo/emailer_messages/search" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/emailer_messages/search", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/emailer_messages/{id}/activities": { "get": { "description": "查看特定外联邮件的统计数据。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_emailer_messages_id_activities", "parameters": [ { "description": "邮件发送器消息 ID。", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "activities": { "description": "活动事件（返回时）。", "items": { "type": "string" }, "type": "array" }, "emailer_message": { "description": "Email 对象（如返回）。", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "检查邮件统计信息", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-emailer-messages-id-activities", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:8ea33aecc718e3981106b0b615b8a7006415d6b1119d8cbceecb5f33677268af", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2ac7981241ee" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_emailer_messages_id_activities", "path": "/apis/v1/apollo/emailer_messages/{id}/activities" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/emailer_messages/{id}/activities", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/fields": { "get": { "description": "获取字段列表。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_fields", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "fields": { "description": "字段定义（返回时）。", "items": { "type": "string" }, "type": "array" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get a List of Fields + Create a Custom Field", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-fields", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:6fdc4268c35253f368ecec0d72600008a9c7db4d8e8b68ea177fb69f39080242", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c54be117335c" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_fields", "path": "/apis/v1/apollo/fields" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/fields", "x-aisa-validation": "provider" }, "post": { "description": "获取字段列表。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_fields", "requestBody": { "content": { "application/json": { "schema": { "properties": { "label": { "description": "Name of the custom field you want to create. Example: `Test Name`", "type": "string" }, "meta": { "properties": { "max_length": { "type": "number" } }, "type": "object" }, "modality": { "description": "The modality of the custom field you want to create. Example: `contact`", "enum": [ "contact", "account", "opportunity" ], "type": "string" }, "type": { "description": "What kind of custom field you want to create. Example: `textarea`", "enum": [ "string", "textarea", "number", "date", "datetime", "boolean" ], "type": "string" } }, "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "typed_custom_fields": { "description": "已创建的字段（如返回）。", "items": { "type": "string" }, "type": "array" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Get a List of Fields + Create a Custom Field", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-fields", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:3f54e177b12e8bd94d3679845152cecf81a8680027c03ea1014dad1fa85395a0", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c54be117335c" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_fields", "path": "/apis/v1/apollo/fields" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/fields", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/labels": { "get": { "description": "获取所有列表（标签）的列表。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_labels", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "[]": { "description": "对象列表（返回时）。", "items": { "type": "string" }, "type": "array" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "获取所有列表", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-labels", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:8486d4434b6bbc5e4728ff013d13a8894b38f756f016fcb252a080a215c8b522", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "20baefe1a96b" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_labels", "path": "/apis/v1/apollo/labels" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/labels", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/mixed_companies/search": { "post": { "description": "Find companies matching criteria: name, domain, headcount, industry, location, funding stage and technologies in use. Returns `organizations` and `accounts` side by side — organizations are Apollo's global database, accounts are records that already exist in this Apollo workspace — plus `pagination` and `breadcrumbs` echoing the filters that were applied. Use it to build a target list. When you already know the domain, `get_apollo_organizations_enrich` answers directly and costs less.\n\n\n按用量计费；默认请求预估费用：$0.01975 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_mixed_companies_search", "parameters": [ { "description": "根据组织当前使用的技术查找组织。Apollo 支持按 1,500 多种技术进行筛选。Apollo 根据多个来源计算技术数据。此数据会定期更新。下载此 CSV 文件可查看支持的技术完整列表。对于 CSV 文件中列出的技术，请使用下划线（_）替换空格和句点。示例：salesforce; google_analytics; wordpress_org", "in": "query", "name": "currently_using_any_of_technology_uids[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "公司在最近一轮融资中获得的最高金额。将此参数与 latest_funding_amount_range[min] 结合使用，可为公司最近一轮融资设置金额范围。数字中请勿输入货币符号、逗号或小数点。示例：5000000；15000000", "in": "query", "name": "latest_funding_amount_range[max]", "required": false, "schema": { "type": "integer" } }, { "description": "公司在最近一轮融资中获得的最低金额。将此参数与 latest_funding_amount_range[max] 结合使用，可为公司最近一轮融资设置金额范围。数字中请勿输入货币符号、逗号或小数点。示例：5000000；15000000", "in": "query", "name": "latest_funding_amount_range[min]", "required": false, "schema": { "type": "integer" } }, { "description": "公司获得最近一轮融资的最晚日期。将此参数与 latest_funding_date_range[min] 结合使用，可设置公司获得最近一轮融资的日期范围。示例：2025-09-25", "in": "query", "name": "latest_funding_date_range[max]", "required": false, "schema": { "type": "string" } }, { "description": "公司获得最近一轮融资的最早日期。将此参数与 latest_funding_date_range[max] 结合使用，可设置公司获得最近一轮融资的日期范围。示例：2025-07-25", "in": "query", "name": "latest_funding_date_range[min]", "required": false, "schema": { "type": "string" } }, { "description": "要包含在搜索结果中的公司的 Apollo ID。Apollo 数据库中的每家公司都会分配一个唯一 ID。要查找这些 ID，请在调用此端点时识别 organization_id 的值。示例：5e66b6381e05b4008c8331b8", "in": "query", "name": "organization_ids[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "公司正在招聘的职位所在地。示例：atlanta；japan", "in": "query", "name": "organization_job_locations[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "公司发布职位的最晚日期。请将此参数与 organization_job_posted_at_range[min] 结合使用，以设置职位发布日期范围。示例：2025-09-25", "in": "query", "name": "organization_job_posted_at_range[max]", "required": false, "schema": { "type": "string" } }, { "description": "该公司发布职位的最早日期。将此参数与 organization_job_posted_at_range[max] 结合使用，以设置职位发布日期范围。示例：2025-07-25", "in": "query", "name": "organization_job_posted_at_range[min]", "required": false, "schema": { "type": "string" } }, { "description": "公司总部所在地。可在城市、美国各州和国家/地区范围内搜索。如果公司设有多个办公地点，结果仍以总部所在地为准。例如，如果搜索 chicago，但某公司的总部位于 boston，则所有总部位于 Boston 的公司都不会出现在搜索结果中，即使它们符合其他参数。要根据位置排除公司，请使用 organization_not_locations 参数。示例：texas; tokyo; spain", "in": "query", "name": "organization_locations[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "根据公司总部所在地从搜索结果中排除公司。您可以使用城市、美国州和国家/地区作为要排除的位置。此参数有助于确保您不会在不希望开发的地区寻找潜在客户。例如，如果使用 ireland 作为值，搜索结果中将不会出现总部位于爱尔兰的公司。示例：minnesota; ireland; seoul", "in": "query", "name": "organization_not_locations[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "公司员工人数范围。您可以据此按员工人数查找公司。可以添加多个范围以扩大搜索结果。添加的每个范围都必须是字符串，范围的下限和上限数字之间只能使用逗号分隔。示例：1,10; 250,500; 10000,20000", "in": "query", "name": "organization_num_employees_ranges[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "公司当前有效招聘职位的最大数量。请将此参数与 organization_num_jobs_range[min] 结合使用，以设置招聘职位数量范围。示例：50；500", "in": "query", "name": "organization_num_jobs_range[max]", "required": false, "schema": { "type": "integer" } }, { "description": "公司当前有效职位发布数量的最小值。请将此参数与 organization_num_jobs_range[max] 结合使用，以设置职位发布数量范围。示例：50；500", "in": "query", "name": "organization_num_jobs_range[min]", "required": false, "schema": { "type": "integer" } }, { "description": "要检索的 Apollo 数据页码。将此参数与 per_page 参数结合使用，使搜索结果可分页浏览并提高端点性能。示例：4", "in": "query", "name": "page", "required": false, "schema": { "type": "integer" } }, { "description": "每页应返回的搜索结果数量。限制每页的结果数量可提高端点性能。使用 page 参数搜索不同的数据页。示例：10", "in": "query", "name": "per_page", "required": false, "schema": { "type": "integer" } }, { "description": "此人雇主的域名。可以是当前雇主或以前雇主的域名。请勿包含 www.、@ 符号或类似内容。此参数在单个请求中最多接受 1,000 个域名。示例：apollo.io；microsoft.com", "in": "query", "name": "q_organization_domains_list[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "公司当前招聘职位中列出的职位名称。示例：销售经理；研究分析师", "in": "query", "name": "q_organization_job_titles[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "根据与公司相关的关键词筛选搜索结果。例如，可以输入 mining 作为值，仅返回与采矿行业相关的公司。示例：mining; sales strategy; consulting", "in": "query", "name": "q_organization_keyword_tags[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "筛选搜索结果，使其包含特定公司名称。如果为此参数输入的值与公司名称不匹配，即使该公司符合其他参数，也不会出现在搜索结果中。接受部分匹配。例如，如果按值 marketing 进行筛选，名为 NY Marketing Unlimited 的公司仍可作为搜索结果，但 NY Market Analysis 不符合条件。示例：apollo or mining", "in": "query", "name": "q_organization_name", "required": false, "schema": { "type": "string" } }, { "description": "根据组织营收搜索组织。使用此参数设置组织营收范围的上限。使用 revenue_range[min] 参数设置营收范围的下限。数值中请勿输入货币符号、逗号或小数点。示例：50000000", "in": "query", "name": "revenue_range[max]", "required": false, "schema": { "type": "integer" } }, { "description": "根据收入搜索组织。使用此参数设置组织收入范围的下限。使用 revenue_range[max] 参数设置收入范围的上限。数值中请勿输入货币符号、逗号或小数点。示例：300000", "in": "query", "name": "revenue_range[min]", "required": false, "schema": { "type": "integer" } }, { "description": "公司在所有融资轮次中获得的资金总额上限。将此参数与 total_funding_range[min] 结合使用，可为公司的所有融资轮次设置金额范围。数值中请勿输入货币符号、逗号或小数点。示例：50000000；350000000", "in": "query", "name": "total_funding_range[max]", "required": false, "schema": { "type": "integer" } }, { "description": "公司在所有融资轮次中获得的资金总额下限。将此参数与 total_funding_range[max] 结合使用，可为公司的所有融资轮次设置金额范围。数值中请勿输入货币符号、逗号或小数点。示例：50000000；350000000", "in": "query", "name": "total_funding_range[min]", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "accounts": { "description": "响应数组", "items": { "type": "string" }, "type": "array" }, "breadcrumbs": { "description": "响应数组", "items": { "type": "string" }, "type": "array" }, "derived_params": { "description": "响应字段", "type": "string" }, "disable_eu_prospecting": { "description": "响应字段", "type": "boolean" }, "has_join": { "description": "响应字段", "type": "boolean" }, "model_ids": { "description": "响应数组", "items": { "type": "string" }, "type": "array" }, "num_fetch_result": { "description": "响应字段", "type": "string" }, "organizations": { "description": "响应数组", "items": { "type": "string" }, "type": "array" }, "pagination": { "description": "响应对象", "type": "object" }, "partial_results_limit": { "description": "响应字段", "type": "integer" }, "partial_results_only": { "description": "响应字段", "type": "boolean" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "组织搜索", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-mixed-companies-search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "plan_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01975, "estimate_source": "profile_seed", "evidence_source": "request_snapshot", "request_cost_drivers": { "formula": { "fixed_units": 1 }, "inputs": [], "kind": "plan_units" }, "unit": "provider_credit", "unit_rate_usd": 0.0 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:1f45818067049a6b7dc82cdd0ee0b61bc76df6942634a91aa84a15432ab995ae", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "dd7f50354676", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "85473a16cd94" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_mixed_companies_search", "path": "/apis/v1/apollo/mixed_companies/search" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/mixed_companies/search", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/mixed_people/api_search": { "post": { "description": "使用 People API Search 端点在 Apollo 数据库中查找全新的人员。该端点提供多种过滤器，帮助您缩小搜索范围。此端点针对 API 使用进行了优化，不消耗额度。此端点主要用于发掘全新的潜在客户。此端点不返回电子邮件地址或电话号码。请使用 People Enrichment 或 Bulk People Enrichment 端点扩充数据。此端点需要主 API 密钥。有关如何创建主 API 密钥，请参阅 Create API Keys。为保障 Apollo 面向所有用户的性能，此端点最多显示 50,000 条记录（每页 100 条，最多 500 页）。请添加更多过滤器，尽可能缩小搜索结果范围。此限制不会约束您对 Apollo 数据库的访问；您只需分批访问数据。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_mixed_people_api_search", "parameters": [ { "description": "您要查找的人员的电子邮件状态。您可以添加多个状态以扩大搜索范围。可搜索的状态包括：verified unverified likely to engage unavailable", "in": "query", "name": "contact_email_status[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "根据目标人员当前雇主使用的任意技术，将其从搜索结果中排除。Apollo 支持按 1,500 多种技术进行筛选。Apollo 根据多个来源计算技术数据。这些数据会定期更新。下载此 CSV 文件可查看支持的完整技术列表。对于 CSV 文件中列出的技术，请使用下划线 (_) 替换空格和句点。示例：salesforce; google_analytics; wordpress_org", "in": "query", "name": "currently_not_using_any_of_technology_uids[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "根据目标人员当前雇主使用的所有技术查找人员。Apollo 支持按 1,500 多种技术进行筛选。Apollo 根据多个来源计算技术数据。这些数据会定期更新。下载此 CSV 文件可查看支持的完整技术列表。对于 CSV 文件中列出的技术，请使用下划线 (_) 替换空格和句点。示例：salesforce; google_analytics; wordpress_org", "in": "query", "name": "currently_using_all_of_technology_uids[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "根据人员当前雇主使用的任意技术查找人员。Apollo 支持按 1,500 多种技术进行筛选。Apollo 根据多个来源计算技术数据。此数据会定期更新。下载此 CSV 文件可查看支持的技术完整列表。对于 CSV 文件中列出的技术，请使用下划线（_）替换空格和句点。示例：salesforce; google_analytics; wordpress_org", "in": "query", "name": "currently_using_any_of_technology_uids[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "此参数决定响应中是否返回职位名称与 person_titles[] 参数中定义的职位名称相似的人员。使用 person_titles[] 时，将此参数设置为 false 可仅返回职位名称严格匹配的结果。", "in": "query", "name": "include_similar_titles", "required": false, "schema": { "type": "boolean" } }, { "description": "要在搜索结果中包含的公司（雇主）的 Apollo ID。Apollo 数据库中的每家公司都被分配了唯一 ID。要查找 ID，请调用 Organization Search 端点并确定 organization_id 的值。示例：5e66b6381e05b4008c8331b8", "in": "query", "name": "organization_ids[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "此人的雇主正在积极招聘的职位所在地。示例：atlanta；japan", "in": "query", "name": "organization_job_locations[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "人员当前雇主发布职位的最晚日期。请将此参数与 organization_job_posted_at_range[min] 结合使用，以设置职位发布日期范围。示例：2025-09-25", "in": "query", "name": "organization_job_posted_at_range[max]", "required": false, "schema": { "type": "string" } }, { "description": "此人当前雇主发布职位的最早日期。将此参数与 organization_job_posted_at_range[max] 结合使用，可设置职位发布日期范围。示例：2025-07-25", "in": "query", "name": "organization_job_posted_at_range[min]", "required": false, "schema": { "type": "string" } }, { "description": "某人当前雇主的公司总部所在地。您可以搜索城市、美国各州和国家/地区。如果一家公司有多个办公地点，结果仍以总部所在地为准。例如，如果您搜索 chicago，但某公司的总部位于 boston，则该波士顿公司中的员工不会出现在结果中，即使他们符合其他参数。要根据个人所在地查找人员，请使用 person_locations 参数。示例：texas；tokyo；spain", "in": "query", "name": "organization_locations[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "此人当前所在公司的员工人数范围。您可以借此根据雇主的员工人数查找人员。您可以添加多个范围以扩大搜索结果。添加的每个范围都必须是字符串，范围的上下限数字之间只能用逗号分隔。示例：1,10; 250,500; 10000,20000", "in": "query", "name": "organization_num_employees_ranges[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "此人当前雇主的有效招聘职位数量上限。请将此参数与 organization_num_jobs_range[min] 结合使用，以设置招聘职位数量范围。示例：50；500", "in": "query", "name": "organization_num_jobs_range[max]", "required": false, "schema": { "type": "integer" } }, { "description": "此人当前雇主发布的有效职位的最小数量。将此参数与 organization_num_jobs_range[max] 结合使用，以设置职位发布数量范围。示例：50；500", "in": "query", "name": "organization_num_jobs_range[min]", "required": false, "schema": { "type": "integer" } }, { "description": "要检索的 Apollo 数据页码。将此参数与 per_page 参数结合使用，使搜索结果可分页浏览并提高端点性能。示例：4", "in": "query", "name": "page", "required": false, "schema": { "type": "integer" } }, { "description": "每页应返回的搜索结果数量。限制每页的结果数量可提高端点性能。使用 page 参数搜索不同的数据页。示例：10", "in": "query", "name": "per_page", "required": false, "schema": { "type": "integer" } }, { "description": "人员的居住地点。可搜索城市、美国各州和国家/地区。如需根据人员当前雇主的总部所在地查找人员，请使用 organization_locations 参数。示例：california；ireland；chicago", "in": "query", "name": "person_locations[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "人员在其当前雇主中的职位资历。这使您能够查找目前处于特定汇报层级的人员，例如 Director 级别或高级 IC 级别。人员只需匹配您添加的任意 1 个资历级别即可包含在搜索结果中。添加更多资历级别会扩大搜索结果范围。搜索仅根据人员当前的职位名称返回结果，因此搜索 Director 级别的员工时，只会返回当前拥有 Director 级别职位名称的人员。如果某人以前是 Director，但目前是 VP，则不会包含在搜索结果中。将此参数与 person_titles[] 参数结合使用，可根据特定职能和资历级别查找人员。此参数可使用以下选项：owner founder c_suite partner vp head director manager senior entry intern", "in": "query", "name": "person_seniorities[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "您要查找的人员所担任的职位。人员只需匹配您添加的任意 1 个职位，即可被纳入搜索结果。添加更多职位可以扩大搜索结果范围。结果还会包含含有相同词语的职位，即使并非完全匹配。例如，搜索 marketing manager 可能会返回职位为 content marketing manager 的人员。将此参数与 person_seniorities[] 参数结合使用，可根据特定职能和资历级别查找人员。示例：sales development representative；marketing manager；research analyst", "in": "query", "name": "person_titles[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "用于筛选结果的词语字符串。", "in": "query", "name": "q_keywords", "required": false, "schema": { "type": "string" } }, { "description": "此人雇主的域名。可以是当前雇主或以前雇主的域名。请勿包含 www.、@ 符号或类似内容。此参数在单个请求中最多接受 1,000 个域名。示例：apollo.io；microsoft.com", "in": "query", "name": "q_organization_domains_list[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "此人当前雇主发布的有效招聘职位中列出的职位名称。示例：销售经理；研究分析师", "in": "query", "name": "q_organization_job_titles[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "人员当前雇主产生的最高营收。将此参数与 revenue_range[min] 结合使用以设置营收范围。数值中请勿输入货币符号、逗号或小数点。示例：500000；1500000", "in": "query", "name": "revenue_range[max]", "required": false, "schema": { "type": "integer" } }, { "description": "人员当前雇主产生的最低营收。将此参数与 revenue_range[max] 结合使用以设置营收范围。数值中请勿输入货币符号、逗号或小数点。示例：500000；1500000", "in": "query", "name": "revenue_range[min]", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "people": { "description": "响应数组", "items": { "type": "string" }, "type": "array" }, "total_entries": { "description": "响应字段", "type": "integer" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "People API 搜索", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-mixed-people-api-search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:08ddce7098c773abc6b4b27451fdcb73ad2ef835516913c5256323218e8aa1e8", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "1ecb8de294fc" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_mixed_people_api_search", "path": "/apis/v1/apollo/mixed_people/api_search" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/mixed_people/api_search", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/news_articles/search": { "post": { "description": "News coverage for specific companies. `organization_ids[]` is required — omitting it returns HTTP 422 with \"organization_ids is required\", so resolve the companies first with `get_apollo_organizations_enrich` or `post_apollo_mixed_companies_search`. Narrow further with `categories[]` (funding, hires, launches and similar), `published_at[min]`, `published_at[max]`, and page with `page` and `per_page`. Returns `news_articles` and `pagination`. Use it to catch a trigger event before reaching out.\n\n\n按用量计费；默认请求预估费用：$0.01975 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_news_articles_search", "parameters": [ { "description": "筛选搜索结果，使其仅包含特定新闻类别或子类别。使用 Apollo 中面向公司的新闻搜索筛选器，查找所有可能的类别和子类别。示例：招聘；投资；合同", "in": "query", "name": "categories[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "你希望包含在搜索结果中的公司 Apollo ID。Apollo 数据库中的每家公司都会被分配一个唯一 ID。要查找 ID，请调用 Organization Search 端点并识别 organization_id 的值。示例：5e66b6381e05b4008c8331b8", "in": "query", "name": "organization_ids[]", "required": true, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "要检索的 Apollo 数据页码。将此参数与 per_page 参数结合使用，使搜索结果可分页浏览并提高端点性能。示例：4", "in": "query", "name": "page", "required": false, "schema": { "type": "integer" } }, { "description": "每页应返回的搜索结果数量。限制每页的结果数量可提高端点性能。使用 page 参数搜索不同的数据页。示例：10", "in": "query", "name": "per_page", "required": false, "schema": { "type": "integer" } }, { "description": "设置要搜索的日期范围上限。此参数应与 published_at[min] 参数结合使用。此日期应晚于 published_at[min] 日期。日期格式应为 YYYY-MM-DD。示例：2025-05-15", "in": "query", "name": "published_at[max]", "required": false, "schema": { "type": "string" } }, { "description": "设置要搜索的日期范围下限。请将此参数与 published_at[max] 参数结合使用。此日期应早于 published_at[max] 日期。日期格式应为 YYYY-MM-DD。示例：2025-02-15", "in": "query", "name": "published_at[min]", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "news_articles": { "description": "响应数组", "items": { "type": "string" }, "type": "array" }, "pagination": { "description": "响应对象", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "新闻文章搜索", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-news-articles-search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "plan_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01975, "estimate_source": "profile_seed", "evidence_source": "request_snapshot", "request_cost_drivers": { "formula": { "fixed_units": 1 }, "inputs": [], "kind": "plan_units" }, "unit": "provider_credit", "unit_rate_usd": 0.0 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:690317cf0435061d76d0543a41ec7b8deac6b156fa7555cd95c420dee2770afa", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "dd7f50354676", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "257b8e819ad7" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_news_articles_search", "path": "/apis/v1/apollo/news_articles/search" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/news_articles/search", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/notes": { "get": { "description": "获取备注列表。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_notes", "parameters": [ { "description": "Filter by an account ID. At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".", "in": "query", "name": "account_id", "required": false, "schema": { "type": "string" } }, { "description": "Filter by a calendar event ID. At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".", "in": "query", "name": "calendar_event_id", "required": false, "schema": { "type": "string" } }, { "description": "Filter by a contact ID. At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".", "in": "query", "name": "contact_id", "required": false, "schema": { "type": "string" } }, { "description": "Filter by contact IDs. At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".", "in": "query", "name": "contact_ids", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "Filter by a conversation ID. At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".", "in": "query", "name": "conversation_id", "required": false, "schema": { "type": "string" } }, { "description": "Filter by conversation IDs. At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".", "in": "query", "name": "conversation_ids", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "Filter by an opportunity ID. At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".", "in": "query", "name": "opportunity_id", "required": false, "schema": { "type": "string" } }, { "description": "Page number (when supported). At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".", "in": "query", "name": "page", "required": false, "schema": { "type": "integer" } }, { "description": "Results per page (when supported). At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".", "in": "query", "name": "per_page", "required": false, "schema": { "type": "integer" } }, { "description": "Only include notes created on/after this date (when supported). At least one filter is required on this endpoint; calling it with none returns HTTP 400 \"At least one argument is required\".", "in": "query", "name": "start_date", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "notes": { "description": "备注（返回时）。", "items": { "type": "string" }, "type": "array" }, "pagination": { "description": "分页元数据（返回时）。", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "获取笔记列表", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-notes", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:73d236ae796a8952f34d241eec1ce6b8cefb8d62b2f32786b2da7b0ec65738f5", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e65c63c8eb8f" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_notes", "path": "/apis/v1/apollo/notes" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/notes", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/opportunities": { "post": { "description": "创建交易（商机）。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_opportunities", "requestBody": { "content": { "application/json": { "schema": { "properties": { "account_id": { "description": "The ID for the account within your Apollo instance. This is the company that you are targeting as part of the deal being created.

Each company in the Apollo database is assigned a unique ID. To find IDs, call the organization search endpoint and identify the values for `organization_id`.

Example: `5e66b6381e05b4008c8331b8`", "type": "string" }, "amount": { "description": "The monetary value of the deal being created.

Do not enter commas or currency symbols for the value. The currency is automatically populated by the settings within your Apollo account. Commas are not accepted and result in the deal amount being left blank.

Example: `55123478` (results in a deal value of `$55,123,478` if the default currency is USD)", "type": "string" }, "closed_date": { "description": "The estimated close date for the deal. This can be a future or past date.

The date should be formatted as `YYYY-MM-DD`.

Example: `2025-10-30`", "format": "date", "type": "string" }, "name": { "description": "Name the deal you are creating. This should be a human-readable name.

Example: `Massive Q3 Deal`", "type": "string" }, "opportunity_stage_id": { "description": "The ID for the deal stage within your team's Apollo account.

Each deal stage is assigned a unique ID. To find deal stage IDs, call the list deal stages endpoint and identify the value for `id` for each stage.

Example: `6095a710bd01d100a506d4bd`", "type": "string" }, "owner_id": { "description": "The ID for the deal owner within your team's Apollo account.

Use the get a list of users endpoint to retrieve IDs for all of the users within your Apollo account.

Example: `66302798d03b9601c7934ebf`", "type": "string" }, "typed_custom_fields": { "additionalProperties": { "type": "string" }, "description": "Add information to custom fields in Apollo.

Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.

To utilize this parameter successfully, call the get a list of all custom fields endpoint and identify the `id` value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying `id` value for the picklist entry that you want to use as the input value.

Example: When the get a list of all custom fields endpoint returns an `id` of field: \n * `\"60c39ed82bd02f01154c470a\"` (datetime) \n \n\n then the value passed should be: \n\n `{\"60c39ed82bd02f01154c470a\": \"2025-08-07\"}`", "example": { "60c39ed82bd02f01154c470a": "2025-08-07" }, "type": "object" } }, "required": [ "name" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "opportunity": { "additionalProperties": true, "description": "已创建的商机", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "创建交易", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-opportunities", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:9660b5489f920f328232720d6a9d192f195dd5e91e2f0276622905b4014a5b83", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f1307a28b15a" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_opportunities", "path": "/apis/v1/apollo/opportunities" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/opportunities", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/opportunities/search": { "get": { "description": "列出所有交易（商机）。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_opportunities_search", "parameters": [ { "description": "页码", "in": "query", "name": "page", "required": false, "schema": { "type": "integer" } }, { "description": "每页条目数", "in": "query", "name": "per_page", "required": false, "schema": { "type": "integer" } }, { "description": "排序字段", "in": "query", "name": "sort_by_field", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "opportunities": { "description": "机会列表", "type": "string" }, "opportunities[].account_id": { "description": "账户 ID", "type": "string" }, "opportunities[].amount": { "description": "金额", "type": "number" }, "opportunities[].created_at": { "description": "创建时间戳", "type": "string" }, "opportunities[].id": { "description": "商机 ID", "type": "string" }, "opportunities[].is_closed": { "description": "是否已关闭", "type": "boolean" }, "opportunities[].is_won": { "description": "是否已赢单", "type": "boolean" }, "opportunities[].name": { "description": "名称", "type": "string" }, "opportunities[].opportunity_stage_id": { "description": "阶段 ID", "type": "string" }, "opportunities[].owner_id": { "description": "所有者 ID", "type": "string" }, "pagination": { "description": "分页对象", "type": "object" }, "pagination.page": { "description": "页码", "type": "integer" }, "pagination.per_page": { "description": "每页条目数", "type": "integer" }, "pagination.total_entries": { "description": "条目总数", "type": "integer" }, "pagination.total_pages": { "description": "总页数", "type": "integer" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "列出所有交易", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-opportunities-search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:5729bb495a1e76ad490d4d5ccc0b75255537d9500f75675aeeb7289910c18b02", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "546b2f93deac" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_opportunities_search", "path": "/apis/v1/apollo/opportunities/search" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/opportunities/search", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/opportunities/{opportunity_id}": { "get": { "description": "按 ID 查看交易（商机）。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_opportunities_opportunity_id", "parameters": [ { "description": "商机 ID", "in": "path", "name": "opportunity_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "opportunity": { "description": "商机对象", "type": "object" }, "opportunity.account_id": { "description": "账户 ID", "type": "string" }, "opportunity.amount": { "description": "金额", "type": "number" }, "opportunity.created_at": { "description": "创建时间戳", "type": "string" }, "opportunity.id": { "description": "商机 ID", "type": "string" }, "opportunity.is_closed": { "description": "是否已关闭", "type": "boolean" }, "opportunity.is_won": { "description": "是否已赢单", "type": "boolean" }, "opportunity.name": { "description": "名称", "type": "string" }, "opportunity.opportunity_stage_id": { "description": "阶段 ID", "type": "string" }, "opportunity.owner_id": { "description": "所有者 ID", "type": "string" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "View or Update Deal", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-opportunities-opportunity-id", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:97549b29b88b7b563c41b8968d653958327d4168689404a79361f99bce152dd5", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6b7c5496f6f4" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_opportunities_opportunity_id", "path": "/apis/v1/apollo/opportunities/{opportunity_id}" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/opportunities/{opportunity_id}", "x-aisa-validation": "provider" }, "patch": { "description": "按 ID 查看交易（商机）。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "patch_apollo_opportunities_opportunity_id", "parameters": [ { "description": "商机 ID", "in": "path", "name": "opportunity_id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "amount": { "description": "The monetary value of the deal. Enter a different value to update the deal amount.

Do not enter commas or currency symbols for the value. The currency is automatically populated by the settings within your Apollo account. Commas are not accepted and result in the deal amount being left blank.

Example: `55123478` (results in a deal value of `$55,123,478` if the default currency is USD)", "type": "string" }, "closed_date": { "description": "Update the estimated close date for the deal. This can be a future or past date.

The date should be formatted as `YYYY-MM-DD`.

Example: `2025-10-30`", "format": "date", "type": "string" }, "name": { "description": "Update the name of the deal. This should be a human-readable name.

Example: `Massive Q3 Deal`", "type": "string" }, "opportunity_stage_id": { "description": "The ID for the deal stage within your team's Apollo account. Enter a different ID to update the deal stage.

Each deal stage is assigned a unique ID. To find deal stage IDs, call the list deal stages endpoint and identify the value for `id` for each stage.

Example: `6095a710bd01d100a506d4bd`", "type": "string" }, "owner_id": { "description": "The ID for the deal owner within your team's Apollo account. Enter a different ID to update the owner of the deal.

Use the get a list of users endpoint to retrieve IDs for all of the users within your Apollo account.

Example: `66302798d03b9601c7934ebf`", "type": "string" }, "typed_custom_fields": { "additionalProperties": { "type": "string" }, "description": "Add information to custom fields in Apollo.

Your custom fields are unique to your team's Apollo account. This means that the examples in this documentation may not work for your testing purposes.

To utilize this parameter successfully, call the get a list of all custom fields endpoint and identify the `id` value for the custom field, as well as the appropriate data type. For example, if a custom field accepts picklist entries, you need to pass the accompanying `id` value for the picklist entry that you want to use as the input value.

Example: When the get a list of all custom fields endpoint returns an `id` of field: \n * `\"60c39ed82bd02f01154c470a\"` (datetime) \n \n\n then the value passed should be: \n\n `{\"60c39ed82bd02f01154c470a\": \"2025-08-07\"}`", "example": { "60c39ed82bd02f01154c470a": "2025-08-07" }, "type": "object" } }, "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "opportunity": { "additionalProperties": true, "description": "更新后的商机", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "View or Update Deal", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/patch_apollo-opportunities-opportunity-id", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:057cec5799be2f45d3130f7f5883b4d3b5e92a3ed693d1e65911bc2590c70315", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "6b7c5496f6f4" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_opportunities_opportunity_id", "path": "/apis/v1/apollo/opportunities/{opportunity_id}" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/opportunities/{opportunity_id}", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/opportunity_stages": { "get": { "description": "列出交易阶段（商机阶段）。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_opportunity_stages", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "opportunity_stages": { "description": "商机阶段列表", "type": "string" }, "opportunity_stages[].description": { "description": "描述", "type": "string" }, "opportunity_stages[].display_order": { "description": "显示顺序", "type": "integer" }, "opportunity_stages[].forecast_category_cd": { "description": "预测类别代码", "type": "string" }, "opportunity_stages[].id": { "description": "阶段 ID", "type": "string" }, "opportunity_stages[].is_closed": { "description": "是否已关闭", "type": "boolean" }, "opportunity_stages[].is_won": { "description": "是否已赢单", "type": "boolean" }, "opportunity_stages[].name": { "description": "名称", "type": "string" }, "opportunity_stages[].opportunity_pipeline_id": { "description": "商机管道 ID", "type": "string" }, "opportunity_stages[].probability": { "description": "概率", "type": "number" }, "opportunity_stages[].team_id": { "description": "团队 ID", "type": "string" }, "opportunity_stages[].type": { "description": "类型", "type": "string" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "列出交易阶段", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-opportunity-stages", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:9eec6c1baffdfc121cc9b273a46fc5453a666de4eaad09172c01f628738ce5db", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "12970000620b" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_opportunity_stages", "path": "/apis/v1/apollo/opportunity_stages" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/opportunity_stages", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/organizations/bulk_enrich": { "post": { "description": "Enrich up to 10 companies in one call. Body takes `domains`, an array of bare domains. Returns the enriched organizations alongside `status`, `total_requested_domains`, `unique_domains`, `unique_records` and `unique_enriched_records` — compare the requested and enriched counts rather than assuming every domain resolved. For one domain `get_apollo_organizations_enrich` is a plain GET.\n\n\n按用量计费；默认请求预估费用：$0.1975 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_organizations_bulk_enrich", "parameters": [ { "description": "要扩充信息的每家公司的域名。请勿包含 www.、@ 符号或类似内容。示例：apollo.io 和 microsoft.com", "in": "query", "name": "domains[]", "required": true, "schema": { "items": { "type": "string" }, "type": "array" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "error_code": { "description": "响应字段", "type": "string" }, "error_message": { "description": "响应字段", "type": "string" }, "missing_records": { "description": "响应字段", "type": "integer" }, "organizations": { "description": "响应数组", "items": { "type": "string" }, "type": "array" }, "status": { "description": "响应字段", "type": "string" }, "total_requested_domains": { "description": "响应字段", "type": "integer" }, "unique_domains": { "description": "响应字段", "type": "integer" }, "unique_enriched_records": { "description": "响应字段", "type": "integer" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "批量组织信息扩充", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-organizations-bulk-enrich", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.1975, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 10, "unit": "provider_credit", "unit_rate_usd": 0.0 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:34cd913109840173288457860b98874e42a20695acdb78696d39e79571a11a97", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "dd7f50354676", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "2750fcc5c11e" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_organizations_bulk_enrich", "path": "/apis/v1/apollo/organizations/bulk_enrich" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/organizations/bulk_enrich", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/organizations/enrich": { "get": { "description": "Enrich one company by domain. `domain` is the only parameter and it must be the bare domain (apple.com), not a full URL. Returns an `organization` object with `id`, `name`, `website_url`, `linkedin_url`, `twitter_url`, `facebook_url`, `angellist_url`, `phone`, `founded_year`, `alexa_ranking`, `publicly_traded_symbol`, `publicly_traded_exchange` and `languages`. Use it as the entry point when all you have is a domain. For several domains at once use `post_apollo_organizations_bulk_enrich`; for the full record including funding and technology detail use `get_apollo_organizations_id`, which needs the Apollo organization id this call returns.\n\n\n按用量计费；默认请求预估费用：$0.01975 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_organizations_enrich", "parameters": [ { "description": "要进行信息补充的公司域名。请勿包含 www.、@ 符号或类似内容。示例：apollo.io 或 microsoft.com", "in": "query", "name": "domain", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "organization": { "description": "响应对象", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "组织信息扩充", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-organizations-enrich", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "plan_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01975, "estimate_source": "profile_seed", "evidence_source": "request_snapshot", "request_cost_drivers": { "formula": { "fixed_units": 1 }, "inputs": [], "kind": "plan_units" }, "unit": "provider_credit", "unit_rate_usd": 0.0 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:5cea0efc1bf053916f6f5a3d31677ad11c5b364aab24a45ac629edf2e801e2ec", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "dd7f50354676", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5fb0090dbb38" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_organizations_enrich", "path": "/apis/v1/apollo/organizations/enrich" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/organizations/enrich", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/organizations/{id}": { "get": { "description": "The complete Apollo record for one company, by Apollo organization id (not by domain). Returns an `organization` object carrying everything enrichment returns plus the deeper fields: funding history, technology stack, department headcounts and related organizations. Get the id from `get_apollo_organizations_enrich` or `post_apollo_mixed_companies_search` first — this endpoint cannot take a domain.\n\n\n按用量计费；默认请求预估费用：$0.01975 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_organizations_id", "parameters": [ { "description": "要研究的组织的 Apollo ID。要查找组织 ID，请调用 Organization Search 端点，并确定该组织的 organizaton_id 值。示例：5e66b6381e05b4008c8331b8", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "organization": { "description": "响应对象", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "获取完整的组织信息", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-organizations-id", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "plan_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01975, "estimate_source": "profile_seed", "evidence_source": "request_snapshot", "request_cost_drivers": { "formula": { "fixed_units": 1 }, "inputs": [], "kind": "plan_units" }, "unit": "provider_credit", "unit_rate_usd": 0.0 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:5cea0efc1bf053916f6f5a3d31677ad11c5b364aab24a45ac629edf2e801e2ec", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "dd7f50354676", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "977a7bd8437c" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_organizations_id", "path": "/apis/v1/apollo/organizations/{id}" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/organizations/{id}", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/organizations/{organization_id}/job_postings": { "get": { "description": "Live job postings for one company, by Apollo organization id. Each posting carries its title, location, posted date and source URL. Useful as a hiring signal — which functions a company is expanding, and where. Get the organization id from `get_apollo_organizations_enrich` first. This reads Apollo's job board data, not the company's own careers page, so absence of postings is not proof a company is not hiring.\n\n\n按用量计费；默认请求预估费用：$0.01975 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_organizations_organization_id_job_postings", "parameters": [ { "description": "要查找其职位发布信息的公司的组织 ID。Apollo 数据库中的每家公司都会被分配一个唯一 ID。要查找 ID，请调用 Organization Search 端点并识别 organization_id 的值。示例：5e66b6381e05b4008c8331b8", "in": "path", "name": "organization_id", "required": true, "schema": { "type": "string" } }, { "description": "要检索的 Apollo 数据页码。将此参数与 per_page 参数结合使用，使搜索结果可分页浏览并提高端点性能。示例：4", "in": "query", "name": "page", "required": false, "schema": { "type": "integer" } }, { "description": "每页应返回的搜索结果数量。限制每页的结果数量可提高端点性能。使用 page 参数搜索不同的数据页。示例：10", "in": "query", "name": "per_page", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "organization_job_postings": { "description": "响应数组", "items": { "type": "string" }, "type": "array" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "组织招聘职位", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-organizations-organization-id-job-postings", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "plan_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01975, "estimate_source": "profile_seed", "evidence_source": "request_snapshot", "request_cost_drivers": { "formula": { "fixed_units": 1 }, "inputs": [], "kind": "plan_units" }, "unit": "provider_credit", "unit_rate_usd": 0.0 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:1e98904de06a156205e936b43186b6f50fdfbdbd4fa6087e536caf45a5223652", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "dd7f50354676", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0c80c8c2dfa4" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_organizations_organization_id_job_postings", "path": "/apis/v1/apollo/organizations/{organization_id}/job_postings" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/organizations/{organization_id}/job_postings", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/people/bulk_match": { "post": { "description": "Enrich up to 10 people in one call. Body takes `details`, an array of the same identifier objects `post_apollo_people_match` accepts. Returns `matches` alongside `status`, `total_requested_enrichments`, `unique_enriched_records`, `missing_records` and `credits_consumed` — read `missing_records` rather than assuming every input matched. Costs one credit per record enriched, not per call. Use this over a loop of single calls: same credits, one round trip. For a single person `post_apollo_people_match` is simpler.\n\n\n按用量计费；默认请求预估费用：$1.7775 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_people_bulk_match", "parameters": [ { "description": "如果要使用所有可用电话号码（包括手机号码）丰富所有匹配人员的数据，请设置为 true。根据您的 Apollo 定价方案，这可能会消耗额度。默认值为 false。如果此参数设置为 true，则必须为 webhook_url 参数输入 Webhook URL。Apollo 将异步验证电话号码，然后向您提供的 Webhook URL 发送仅包含电话号码详细信息的 JSON 响应。电话号码可能需要几分钟才能送达。", "examples": { "default": { "value": false } }, "in": "query", "name": "reveal_phone_number", "required": false, "schema": { "default": false, "type": "boolean" } }, { "description": "设为 true 以启用电子邮件瀑布式数据丰富", "examples": { "default": { "value": false } }, "in": "query", "name": "run_waterfall_email", "required": false, "schema": { "default": false, "type": "boolean" } }, { "description": "设置为 true 以启用电话瀑布式数据补充", "examples": { "default": { "value": false } }, "in": "query", "name": "run_waterfall_phone", "required": false, "schema": { "default": false, "type": "boolean" } }, { "description": "如果将 reveal_phone_number 参数设置为 true，则此参数为必填项。否则，请勿使用此参数。输入 Webhook URL，以指定 Apollo 应将包含所请求电话号码的 JSON 响应发送到何处。Apollo 建议测试此流程，确保你能够收到包含电话号码的单独响应。如果电话号码未发送到 Webhook URL，请尝试对 Webhook URL 应用 UTF-8 编码。示例：https://webhook.site/cc4cf44e-e047-4774-8dac-473d28474e40；https%3A%2F%2Fwebhook.site%2Fcc4cf44e-e047-4774-8dac-473d28474e40", "in": "query", "name": "webhook_url", "required": false, "schema": { "format": "https_url", "maxLength": 2048, "minLength": 1, "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "details": { "description": "请在此数组中以对象形式提供要扩充信息的每个人的资料。最多可添加 10 人。", "items": { "description": "One person to enrich. Give whatever identifiers you have — the more, the likelier the match.", "properties": { "domain": { "description": "Domain of the person's employer, without www. Example: apollo.io", "type": "string" }, "email": { "description": "Email address of the person.", "type": "string" }, "first_name": { "description": "First name, used with last_name. Example: tim", "type": "string" }, "hashed_email": { "description": "MD5 or SHA-256 hash of the email address.", "type": "string" }, "id": { "description": "Apollo person id, e.g. from a people search.", "type": "string" }, "last_name": { "description": "Last name, used with first_name. Example: zheng", "type": "string" }, "linkedin_url": { "description": "LinkedIn profile URL of the person.", "type": "string" }, "name": { "description": "Full name, e.g. \"tim zheng\"; replaces first_name + last_name.", "type": "string" }, "organization_name": { "description": "Name of the person's employer. Example: apollo", "type": "string" } }, "type": "object" }, "type": "array" }, "reveal_personal_emails": { "description": "如果要使用个人电子邮件地址丰富所有匹配人员的数据，请设置为 true。这可能会消耗 Apollo 定价方案中的额度。默认值为 false。如果某人居住在符合 GDPR 要求的地区，Apollo 将不会披露其个人电子邮件地址。", "type": "boolean" } }, "required": [ "details" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "credits_consumed": { "description": "响应字段", "type": "integer" }, "error_code": { "description": "响应字段", "type": "string" }, "error_message": { "description": "响应字段", "type": "string" }, "matches": { "description": "响应数组", "items": { "type": "string" }, "type": "array" }, "missing_records": { "description": "响应字段", "type": "integer" }, "status": { "description": "响应字段", "type": "string" }, "total_requested_enrichments": { "description": "响应字段", "type": "integer" }, "unique_enriched_records": { "description": "响应字段", "type": "integer" }, "waterfall": { "description": "响应对象", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "批量人员信息扩充", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-constraints": { "conditional_requirements": [ { "if_any_boolean_true": [ { "in": "query", "name": "reveal_phone_number", "selector": "reveal_phone_number" }, { "in": "query", "name": "run_waterfall_email", "selector": "run_waterfall_email" }, { "in": "query", "name": "run_waterfall_phone", "selector": "run_waterfall_phone" } ], "require_all": [ { "in": "query", "name": "webhook_url", "selector": "webhook_url" } ] } ] }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-people-bulk-match", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 1.7775, "estimate_source": "profile_seed", "evidence_source": "response_body", "unit": "provider_credit", "unit_rate_usd": 0.0 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-source": { "content_hash": "sha256:9dd58fde99c92aef856ad0f47b70d50086b0c7eff9baa8f3148006399f9b2a71", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "d10d440e9796", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "99241d7c699e" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_people_bulk_match", "path": "/apis/v1/apollo/people/bulk_match" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/people/bulk_match", "x-aisa-validation": "mixed" } }, "/apis/v1/apollo/people/match": { "post": { "description": "Enrich one person: give whatever identifiers you have and get back Apollo's full record for them. Send identifiers in the JSON request body, not the query string. Accepts `email`, `first_name` plus `last_name`, `name`, `domain`, `organization_name`, `linkedin_url` or `hashed_email` — the more you supply, the likelier the match. Returns a `person` object with `id`, `name`, `title`, `headline`, `linkedin_url`, `twitter_url`, `github_url`, `photo_url`, `organization_id` and an `employment_history` array, plus a `request_id`. Personal emails and phone numbers are withheld unless `reveal_personal_emails` (body) or `reveal_phone_number` (query) is set, and those cost extra credits. A 200 does not guarantee a match — check whether `person` actually came back. Use `post_apollo_people_bulk_match` for up to 10 people in one call; use `post_apollo_mixed_people_api_search` when you do not have an identifier and need to find candidates first.\n\n\n公开参考价格：每次成功请求 $0.01975 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_people_match", "parameters": [ { "description": "如果希望使用所有可用电话号码（包括手机号码）丰富此人的数据，请设置为 true。根据你的 Apollo 定价方案，这可能会消耗额度。默认值为 false。如果将此参数设置为 true，则必须为 webhook_url 参数输入 Webhook URL。Apollo 将异步验证电话号码，然后向你提供的 Webhook URL 发送仅包含此人电话号码详细信息的 JSON 响应。电话号码可能需要几分钟才能送达。", "examples": { "default": { "value": false } }, "in": "query", "name": "reveal_phone_number", "required": false, "schema": { "default": false, "type": "boolean" } }, { "description": "设为 true 以启用电子邮件瀑布式数据丰富", "examples": { "default": { "value": false } }, "in": "query", "name": "run_waterfall_email", "required": false, "schema": { "default": false, "type": "boolean" } }, { "description": "设置为 true 以启用电话瀑布式数据补充", "examples": { "default": { "value": false } }, "in": "query", "name": "run_waterfall_phone", "required": false, "schema": { "default": false, "type": "boolean" } }, { "description": "如果将 reveal_phone_number 参数设置为 true，则此参数为必填项。否则，请勿使用此参数。输入 Webhook URL，以指定 Apollo 应将包含所请求电话号码的 JSON 响应发送到何处。Apollo 建议测试此流程，确保你能够收到包含电话号码的单独响应。如果电话号码未发送到 Webhook URL，请尝试对 Webhook URL 应用 UTF-8 编码。示例：https://webhook.site/cc4cf44e-e047-4774-8dac-473d28474e40；https%3A%2F%2Fwebhook.site%2Fcc4cf44e-e047-4774-8dac-473d28474e40", "in": "query", "name": "webhook_url", "required": false, "schema": { "format": "https_url", "maxLength": 2048, "minLength": 1, "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "domain": "apollo.io", "name": "tim zheng" }, "schema": { "anyOf": [ { "properties": { "first_name": { "minLength": 1, "type": "string" } }, "required": [ "first_name" ] }, { "properties": { "last_name": { "minLength": 1, "type": "string" } }, "required": [ "last_name" ] }, { "properties": { "name": { "minLength": 1, "type": "string" } }, "required": [ "name" ] }, { "properties": { "email": { "minLength": 1, "type": "string" } }, "required": [ "email" ] }, { "properties": { "hashed_email": { "minLength": 1, "type": "string" } }, "required": [ "hashed_email" ] }, { "properties": { "organization_name": { "minLength": 1, "type": "string" } }, "required": [ "organization_name" ] }, { "properties": { "domain": { "minLength": 1, "type": "string" } }, "required": [ "domain" ] }, { "properties": { "id": { "minLength": 1, "type": "string" } }, "required": [ "id" ] }, { "properties": { "linkedin_url": { "minLength": 1, "type": "string" } }, "required": [ "linkedin_url" ] } ], "description": "Identify one person. Give at least one identifier; the more you supply, the likelier the match.", "minProperties": 1, "properties": { "domain": { "description": "此人的雇主域名。可以是当前雇主或以前雇主的域名。请勿包含 www.、@ 符号或类似内容。示例：apollo.io 或 microsoft.com", "type": "string" }, "email": { "description": "此人的电子邮件地址。示例：example@email.com", "type": "string" }, "first_name": { "description": "人员的名字。通常与 last_name 参数结合使用。示例：tim", "type": "string" }, "hashed_email": { "description": "人员电子邮件地址的哈希值。电子邮件地址应符合 MD5 或 SHA-256 哈希格式。示例：8d935115b9ff4489f2d1f9249503cadf (MD5) 或 97817c0c49994eb500ad0a5e7e2d8aed51977b26424d508f66e4e8887746a152 (SHA-256)", "type": "string" }, "id": { "description": "人员的 Apollo ID。Apollo 数据库中的每个人员都分配有唯一 ID。要查找 ID，请调用 People API Search 端点，并确定 person_id 的值。示例：587cf802f65125cad923a266", "type": "string" }, "last_name": { "description": "人员的姓氏。通常与 first_name 参数结合使用。示例：zheng", "type": "string" }, "linkedin_url": { "description": "此人的 LinkedIn 个人资料 URL。示例：http://www.linkedin.com/in/tim-zheng-677ba010", "type": "string" }, "name": { "description": "人员的全名。通常由名字和姓氏组成，并以空格分隔。如果使用此参数，则无需使用 first_name 和 last_name 参数。示例：tim zheng", "type": "string" }, "organization_name": { "description": "此人的雇主名称。可以是当前雇主或前雇主。示例：apollo", "type": "string" }, "reveal_personal_emails": { "description": "如果希望使用个人电子邮件地址丰富此人的数据，请设置为 true。这可能会消耗 Apollo 定价方案中的额度。默认值为 false。如果此人居住在符合 GDPR 要求的地区，Apollo 将不会披露其个人电子邮件地址。", "type": "boolean" } }, "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "person": { "description": "响应对象", "type": "object" }, "waterfall": { "description": "响应对象", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "人员信息补充", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-constraints": { "conditional_requirements": [ { "if_any_boolean_true": [ { "in": "query", "name": "reveal_phone_number", "selector": "reveal_phone_number" }, { "in": "query", "name": "run_waterfall_email", "selector": "run_waterfall_email" }, { "in": "query", "name": "run_waterfall_phone", "selector": "run_waterfall_phone" } ], "require_all": [ { "in": "query", "name": "webhook_url", "selector": "webhook_url" } ] } ] }, "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-people-match", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.01975, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-source": { "content_hash": "sha256:7fadde251ef476cd68e84646c8c1e05b0edda6294f57904448bc4f2a3f8c6c70", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "d7af3fddf48b", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "8b83f4a4d426" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_people_match", "path": "/apis/v1/apollo/people/match" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/people/match", "x-aisa-validation": "mixed" } }, "/apis/v1/apollo/phone_calls": { "post": { "description": "创建通话记录。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_phone_calls", "parameters": [ { "description": "账户 ID。", "in": "query", "name": "account_id", "required": false, "schema": { "type": "string" } }, { "description": "联系人 ID。", "in": "query", "name": "contact_id", "required": false, "schema": { "type": "string" } }, { "description": "持续时间（秒）。", "in": "query", "name": "duration", "required": false, "schema": { "type": "integer" } }, { "description": "ISO 8601 格式的结束时间。", "in": "query", "name": "end_time", "required": false, "schema": { "type": "string" } }, { "description": "主叫电话号码。", "in": "query", "name": "from_number", "required": false, "schema": { "type": "string" } }, { "description": "是否创建个人记录。", "in": "query", "name": "logged", "required": false, "schema": { "type": "boolean" } }, { "description": "结果 ID。", "in": "query", "name": "phone_call_outcome_id", "required": false, "schema": { "type": "string" } }, { "description": "用途 ID。", "in": "query", "name": "phone_call_purpose_id", "required": false, "schema": { "type": "string" } }, { "description": "ISO 8601 格式的开始时间。", "in": "query", "name": "start_time", "required": false, "schema": { "type": "string" } }, { "description": "通话状态。", "in": "query", "name": "status", "required": false, "schema": { "type": "string" } }, { "description": "已拨电话号码。", "in": "query", "name": "to_number", "required": false, "schema": { "type": "string" } }, { "description": "调用方用户 ID。", "in": "query", "name": "user_id[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "phone_call": { "description": "通话记录（返回时）。", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "创建通话记录", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-phone-calls", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:20b81e0c919f2ce8023dbb7aecf36febd6a5764facb4414906af4808b5a14464", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b3e0eb13c5aa" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_phone_calls", "path": "/apis/v1/apollo/phone_calls" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/phone_calls", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/phone_calls/search": { "get": { "description": "搜索通话记录。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_phone_calls_search", "parameters": [ { "description": "联系人标签 ID。", "in": "query", "name": "contact_label_ids[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "电话会议日期范围的上限（YYYY-MM-DD）。", "in": "query", "name": "date_range[max]", "required": false, "schema": { "type": "string" } }, { "description": "通话日期范围的下限（YYYY-MM-DD）。", "in": "query", "name": "date_range[min]", "required": false, "schema": { "type": "string" } }, { "description": "时长上限（秒）。", "in": "query", "name": "duration[max]", "required": false, "schema": { "type": "integer" } }, { "description": "时长下限（秒）。", "in": "query", "name": "duration[min]", "required": false, "schema": { "type": "integer" } }, { "description": "呼入或呼出。", "in": "query", "name": "inbound", "required": false, "schema": { "type": "string" } }, { "description": "页码。", "in": "query", "name": "page", "required": false, "schema": { "type": "integer" } }, { "description": "每页结果数。", "in": "query", "name": "per_page", "required": false, "schema": { "type": "integer" } }, { "description": "结果 ID。", "in": "query", "name": "phone_call_outcome_ids[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "用途 ID。", "in": "query", "name": "phone_call_purpose_ids[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "关键词筛选条件。", "in": "query", "name": "q_keywords", "required": false, "schema": { "type": "string" } }, { "description": "用户 ID。", "in": "query", "name": "user_ids[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "pagination": { "description": "分页元数据（返回时）。", "type": "object" }, "phone_calls": { "description": "通话记录（如返回）。", "items": { "type": "string" }, "type": "array" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "搜索通话记录", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-phone-calls-search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:0edd26c318e511a416d697c33f70ba395547391e86b8eafacef0180e2d07b999", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "912915ce0d0c" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_phone_calls_search", "path": "/apis/v1/apollo/phone_calls/search" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/phone_calls/search", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/phone_calls/{id}": { "put": { "description": "更新通话记录。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "put_apollo_phone_calls_id", "parameters": [ { "description": "通话记录 ID。", "in": "path", "name": "id", "required": true, "schema": { "type": "string" } }, { "description": "账户 ID。", "in": "query", "name": "account_id", "required": false, "schema": { "type": "string" } }, { "description": "联系人 ID。", "in": "query", "name": "contact_id", "required": false, "schema": { "type": "string" } }, { "description": "持续时间（秒）。", "in": "query", "name": "duration", "required": false, "schema": { "type": "integer" } }, { "description": "ISO 8601 格式的结束时间。", "in": "query", "name": "end_time", "required": false, "schema": { "type": "string" } }, { "description": "主叫电话号码。", "in": "query", "name": "from_number", "required": false, "schema": { "type": "string" } }, { "description": "是否创建个人记录。", "in": "query", "name": "logged", "required": false, "schema": { "type": "boolean" } }, { "description": "结果 ID。", "in": "query", "name": "phone_call_outcome_id", "required": false, "schema": { "type": "string" } }, { "description": "用途 ID。", "in": "query", "name": "phone_call_purpose_id", "required": false, "schema": { "type": "string" } }, { "description": "ISO 8601 格式的开始时间。", "in": "query", "name": "start_time", "required": false, "schema": { "type": "string" } }, { "description": "通话状态。", "in": "query", "name": "status", "required": false, "schema": { "type": "string" } }, { "description": "已拨电话号码。", "in": "query", "name": "to_number", "required": false, "schema": { "type": "string" } }, { "description": "调用方用户 ID。", "in": "query", "name": "user_id[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "phone_call": { "description": "更新后的通话记录（如有返回）。", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "更新通话记录", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/put_apollo-phone-calls-id", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:a65b8a23d363087b2289b42491b7ae4dd54ea33f25dd9edd9037a4a558cd906e", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "c6143a5cb2a5" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "put_apollo_phone_calls_id", "path": "/apis/v1/apollo/phone_calls/{id}" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/phone_calls/{id}", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/reports/sync_report": { "post": { "description": "查询分析报告。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_reports_sync_report", "requestBody": { "content": { "application/json": { "examples": { "Custom date range — call activity for Q1": { "value": { "date_ranges": [ { "modality": "custom_range" } ], "filters": { "smart_datetime_range": { "max": "2024-03-31", "min": "2024-01-01" } }, "group_by": [ { "name": "smart_user_id" } ], "group_by_totals_selected": true, "metrics": [ { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "num_phone_calls" }, { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "num_phone_calls_connect" }, { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "percent_phone_calls_connect" } ], "pivot_group_by": [], "pivot_group_by_totals_selected": false, "sorts": [] } }, "Flat totals — email performance": { "value": { "date_ranges": [ { "modality": "last_30_days" } ], "filters": {}, "group_by": [], "group_by_totals_selected": false, "metrics": [ { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "num_emails_sent" }, { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "num_emails_opened" }, { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "percent_emails_opened_tracked" } ], "pivot_group_by": [], "pivot_group_by_totals_selected": false, "sorts": [] } }, "Grouped — email activity by user": { "value": { "date_ranges": [ { "modality": "current_month" } ], "filters": {}, "group_by": [ { "name": "smart_user_id" } ], "group_by_totals_selected": true, "metrics": [ { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "num_emails_sent" }, { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "num_emails_replied" }, { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "percent_emails_replied" } ], "pivot_group_by": [], "pivot_group_by_totals_selected": false, "sorts": [ { "asc": false, "metric": { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "num_emails_sent" } } ] } }, "Grouped — email volume by month": { "value": { "date_ranges": [ { "modality": "last_12_months" } ], "filters": {}, "group_by": [ { "name": "smart_datetime_month" } ], "group_by_totals_selected": false, "metrics": [ { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "num_emails_sent" } ], "pivot_group_by": [], "pivot_group_by_totals_selected": false, "sorts": [] } }, "Pivot — emails sent by user x contact stage": { "value": { "date_ranges": [ { "modality": "last_30_days" } ], "filters": {}, "group_by": [ { "name": "smart_user_id" } ], "group_by_totals_selected": true, "metrics": [ { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "num_emails_sent" } ], "pivot_group_by": [ { "name": "contact_stage_id" } ], "pivot_group_by_totals_selected": true, "sorts": [] } }, "Sorted — top 5 reps by reply rate": { "value": { "date_ranges": [ { "modality": "current_quarter" } ], "filters": {}, "group_by": [ { "limit": 5, "name": "smart_user_id" } ], "group_by_totals_selected": false, "metrics": [ { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "num_emails_sent" }, { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "num_emails_replied" }, { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "percent_emails_replied" } ], "pivot_group_by": [], "pivot_group_by_totals_selected": false, "sorts": [ { "asc": false, "metric": { "smart_datetime_reference": "activity_datetime", "smart_user_id_reference": "user_id", "value": "percent_emails_replied" } } ] } } }, "schema": { "properties": { "date_ranges": { "description": "The time window for the query. Provide one object with a modality preset. For a custom date range, set modality to custom_range and add a smart_datetime_range key in filters with {\"min\": \"YYYY-MM-DD\", \"max\": \"YYYY-MM-DD\"}.", "items": { "properties": { "modality": { "description": "Date range preset. Valid values: today, yesterday, current_week, current_month, current_quarter, current_year, last_7_days, last_2_weeks, last_30_days, last_3_months, last_6_months, last_12_months, last_4_quarters, last_2_years, previous_week, previous_month, previous_quarter, previous_year, all_time, custom_range (requires smart_datetime_range in filters).", "type": "string" } }, "required": [ "modality" ], "type": "object" }, "maxItems": 1, "type": "array" }, "filters": { "additionalProperties": true, "description": "Key/value filter map to narrow the result set. Pass an empty object {} for no filters. Common filter keys are documented in the properties below; additional dimension-based filters may also be passed using the same key names as group_by[].name values. Refer to the Metrics and Dimensions Reference for a complete list.", "properties": { "account_stage_ids": { "description": "Filter to specific account stage IDs.", "items": { "type": "string" }, "type": "array" }, "contact_stage_ids": { "description": "Filter to specific contact stage IDs.", "items": { "type": "string" }, "type": "array" }, "email_account_ids": { "description": "Filter to specific sender mailbox IDs.", "items": { "type": "string" }, "type": "array" }, "emailer_campaign_ids": { "description": "Filter to specific sequence IDs.", "items": { "type": "string" }, "type": "array" }, "opportunity_stage_ids": { "description": "Filter to specific opportunity stage IDs.", "items": { "type": "string" }, "type": "array" }, "smart_datetime_range": { "description": "Required when date_ranges[].modality is custom_range. Specifies the exact date window as ISO 8601 date strings.", "properties": { "max": { "description": "End date (inclusive). Format: YYYY-MM-DD.

Example: 2024-03-31", "type": "string" }, "min": { "description": "Start date (inclusive). Format: YYYY-MM-DD.

Example: 2024-01-01", "type": "string" } }, "required": [ "min", "max" ], "type": "object" }, "smart_subteam_id": { "description": "Filter to specific sub-team IDs.", "items": { "type": "string" }, "type": "array" }, "smart_user_id": { "description": "Filter to specific team member IDs. Use \"current\" for the authenticated user.

Example: [\"current\"]", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "group_by": { "description": "The dimension to group results by (row dimension). Pass one object to break results down by that dimension. Pass an empty array [] for flat totals with no grouping.

Only one entry is supported. Refer to the Metrics and Dimensions Reference for valid dimension names.", "items": { "properties": { "limit": { "description": "Maximum number of dimension values to return.", "type": "integer" }, "name": { "description": "The dimension name.

Example: smart_user_id", "type": "string" } }, "required": [ "name" ], "type": "object" }, "maxItems": 1, "type": "array" }, "group_by_totals_selected": { "description": "When true, the response includes an aggregated totals row in addition to the per-dimension-value rows.", "type": "boolean" }, "metrics": { "description": "The metrics to query. Each object specifies which metric to measure and which date and user columns the engine should use for that metric. The smart_datetime_reference and smart_user_id_reference values are metric-specific — using the wrong values will return no data. Refer to the Metrics and Dimensions Reference for valid metric names and the correct reference fields for each.

Pass an empty array [] to return a response with no metric columns.", "items": { "properties": { "display_name": { "description": "Optional label override for this metric's column in the response.", "type": "string" }, "smart_datetime_reference": { "description": "The date column name to use for this metric time range. Valid values depend on the metric. See the smart reference field values table for supported values by metric type. Unsupported values may cause the related date or user filter not to apply.

Example: activity_datetime", "type": "string" }, "smart_user_id_reference": { "description": "The user column name that filters per user. Many metrics use user_id. See the smart reference field values table for supported values by metric family. Unsupported values may cause the related date or user filter not to apply.

Example: user_id", "type": "string" }, "value": { "description": "The metric identifier. For built-in metrics, use the metric name (e.g. num_emails_sent). For team-defined custom metrics, use the format custom_metric_{id} where {id} is the custom metric's id.", "type": "string" } }, "required": [ "value", "smart_datetime_reference", "smart_user_id_reference" ], "type": "object" }, "type": "array" }, "min_ratio_denominator": { "default": 0, "description": "Minimum denominator threshold for ratio metrics. Rows where the denominator falls below this value are excluded from ratio calculations.", "type": "integer" }, "pivot_group_by": { "description": "The dimension to pivot on (column dimension). Used together with group_by to produce a two-dimensional cross-tab table: group_by defines the row dimension and pivot_group_by defines the column dimension. Pass an empty array [] for non-pivot queries.

Only one entry is supported.", "items": { "properties": { "limit": { "description": "Maximum number of pivot column values to return.", "type": "integer" }, "name": { "description": "The dimension name to pivot on.

Example: emailer_campaign_id", "type": "string" } }, "required": [ "name" ], "type": "object" }, "maxItems": 1, "type": "array" }, "pivot_group_by_totals_selected": { "description": "When true, the pivot response includes an aggregated totals column in addition to the per-pivot-value columns.", "type": "boolean" }, "skip_group_by_values": { "description": "Exclude specific dimension values from the result rows. Values must match the raw key field returned in bucket responses for the active group_by dimension (e.g. a contact stage ID string, a user ID string, or a date string for datetime dimensions). Maximum 500 entries.", "items": { "type": "string" }, "maxItems": 500, "type": "array" }, "sorts": { "description": "Sort order for the result rows. Only the first entry is applied. Pass an empty array [] to use the default order.

Sorting is supported by metric value — provide the metric field with the same structure as an entry in the metrics array. The asc field controls direction (true = ascending, false = descending).

Sorting by dimension value (e.g. alphabetically by user name) is not supported via the API.", "items": { "properties": { "asc": { "description": "Sort ascending (true) or descending (false).", "type": "boolean" }, "metric": { "description": "Sort by a metric column. Provide the same structure as a metric entry in the metrics array.", "properties": { "smart_datetime_reference": { "type": "string" }, "smart_user_id_reference": { "type": "string" }, "value": { "type": "string" } }, "type": "object" } }, "required": [ "asc" ], "type": "object" }, "type": "array" } }, "required": [ "metrics", "group_by", "sorts", "filters", "group_by_totals_selected", "pivot_group_by_totals_selected", "date_ranges" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "report": { "description": "报告结果（结构取决于请求）。", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "查询分析报告", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-reports-sync-report", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:ae97effd45080a298065849aa857fbaf8a76f86a4b6351abf6a27424b8308caf", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7d41c50d34d4" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_reports_sync_report", "path": "/apis/v1/apollo/reports/sync_report" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/reports/sync_report", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/tasks": { "post": { "description": "创建任务。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_tasks", "requestBody": { "content": { "application/json": { "examples": { "Create a call task": { "value": { "contact_id": "66e34b81740c50074e3d1bd4", "due_at": "2025-02-15T10:00:00Z", "note": "Discuss product demo results and next steps.", "priority": "high", "status": "scheduled", "title": "Follow-up call", "type": "call", "user_id": "66302798d03b9601c7934ebf" } } }, "schema": { "properties": { "contact_id": { "description": "The Apollo ID for the contact that you want to be on the receiving end of the action.

To find contact IDs, call the search for contacts endpoint and identify the `id` value for the contact.

Example: `66e34b81740c50074e3d1bd4`", "type": "string" }, "due_at": { "description": "The full date and time when the task will be due.

Your entry should adhere to the ISO 8601 date-time format. Apollo uses Greenwich Mean Time (GMT) by default. If you do not account for time zone differences, you could add a task due date that falls on a different day than you intended.

The value you enter can either adhere to GMT, or you can adjust the time manually by specifying in hours and minutes how much you want to offset GMT.

Example: `2025-02-15T08:10:30Z`; `2025-03-25T10:15:30+05:00`", "format": "date-time", "type": "string" }, "note": { "description": "Add a description for the task. This should be a human-readable message.

This parameter is not required, but it is recommended as it provides the task owner with more context on the action they need to take.

Example: `This contact expressed interest in the Sequences feature specifically. Be prepared to discuss.`", "type": "string" }, "priority": { "default": "medium", "description": "Assign a priority to the task you are creating: ", "type": "string" }, "status": { "description": "The status of the task being created. For future-facing tasks, you should use the `scheduled` status.

For tasks that are already completed, you can use `completed` or `skipped`.

Example: `scheduled`", "type": "string" }, "title": { "description": "A title for the task. If omitted, Apollo will display an auto-generated title based on the task type and contact name.

Example: `Follow up on demo request`", "type": "string" }, "type": { "description": "Set the task to be 1 of the following task types. This enables the task owner to know the type of action they need to take. ", "type": "string" }, "user_id": { "description": "The ID for the task owner within your team's Apollo account. This is the user that will take action on the contacts.

Use the get a list of users endpoint to retrieve IDs for all of the users within your Apollo account.

Example: `66302798d03b9601c7934ebf`", "type": "string" } }, "required": [ "user_id", "contact_id", "type", "status", "due_at" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "task": { "description": "已创建的任务（返回时）。", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "创建任务", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-tasks", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:1c7f8afc5a0294a06f10a4a723834141f5080dc1a9f95ab39aa27e1fd0e540a7", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b6cbc7704368" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_tasks", "path": "/apis/v1/apollo/tasks" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tasks", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/tasks/bulk_create": { "post": { "description": "批量创建任务。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_tasks_bulk_create", "requestBody": { "content": { "application/json": { "examples": { "Create call tasks for multiple contacts": { "value": { "contact_ids": [ "66e34b81740c50074e3d1bd4", "66e34b81740c50074e3d1bd5", "66e34b81740c50074e3d1bd6" ], "due_at": "2025-02-15T10:00:00Z", "note": "Follow up on demo request.", "priority": "high", "status": "scheduled", "type": "call", "user_id": "66302798d03b9601c7934ebf" } } }, "schema": { "properties": { "contact_ids": { "description": "The Apollo IDs for the contacts that you want to be on the receiving end of the action.

If you add multiple contact IDs, individual tasks will be created for each of the contacts using the same task type, due date, and other details.

To find contact IDs, call the search for contacts endpoint and identify the `id` value for the contact.

Example: `66e34b81740c50074e3d1bd4`", "items": { "type": "string" }, "type": "array" }, "due_at": { "description": "The full date and time when the task will be due.

Your entry should adhere to the ISO 8601 date-time format. Apollo uses Greenwich Mean Time (GMT) by default. If you do not account for time zone differences, you could add a task due date that falls on a different day than you intended.

The value you enter can either adhere to GMT, or you can adjust the time manually by specifying in hours and minutes how much you want to offset GMT.

Example: `2025-02-15T08:10:30Z`; `2025-03-25T10:15:30+05:00`", "format": "date-time", "type": "string" }, "note": { "description": "Add a description for the task. This should be a human-readable message.

This parameter is not required, but it is recommended as it provides the task owner with more context on the action they need to take.

Example: `This contact expressed interest in the Sequences feature specifically. Be prepared to discuss.`", "type": "string" }, "priority": { "default": "medium", "description": "Assign a priority to the task you are creating: ", "type": "string" }, "status": { "description": "The status of the task being created. For future-facing tasks, you should use the `scheduled` status.

For tasks that are already completed, you can use `completed` or `skipped`.

Example: `scheduled`", "type": "string" }, "type": { "description": "Set the task to be 1 of the following task types. This enables the task owner to know the type of action they need to take. ", "type": "string" }, "user_id": { "description": "The ID for the task owner within your team's Apollo account. This is the user that will take action on the contacts.

Use the get a list of users endpoint to retrieve IDs for all of the users within your Apollo account.

Example: `66302798d03b9601c7934ebf`", "type": "string" } }, "required": [ "user_id", "contact_ids", "type", "status", "due_at" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "tasks": { "description": "已创建的任务（如有返回）。", "items": { "type": "string" }, "type": "array" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "批量创建任务", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-tasks-bulk-create", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:c3870ec62b396db3e3e8d411319708092a7e633eefb94d826ee24e5553916ece", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "067dc0b7ba35" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_tasks_bulk_create", "path": "/apis/v1/apollo/tasks/bulk_create" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tasks/bulk_create", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/tasks/search": { "post": { "description": "搜索任务。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_tasks_search", "parameters": [ { "description": "可选的开放因子。", "in": "query", "name": "open_factor_names[]", "required": false, "schema": { "items": { "type": "string" }, "type": "array" } }, { "description": "页码。", "in": "query", "name": "page", "required": false, "schema": { "type": "integer" } }, { "description": "每页结果数。", "in": "query", "name": "per_page", "required": false, "schema": { "type": "integer" } }, { "description": "排序字段。", "in": "query", "name": "sort_by_field", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "pagination": { "description": "分页元数据（返回时）。", "type": "object" }, "tasks": { "description": "任务（返回时）。", "items": { "type": "string" }, "type": "array" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "搜索任务", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-tasks-search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:5d93524b30f8a9f38278015fa9c462080eff7e674b91b9103a0f41425ad8f06c", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "353382a4d1bb" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_tasks_search", "path": "/apis/v1/apollo/tasks/search" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/tasks/search", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/typed_custom_fields": { "get": { "description": "获取所有自定义字段的列表。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_typed_custom_fields", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "typed_custom_fields": { "description": "自定义字段定义（返回时）。", "items": { "type": "string" }, "type": "array" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "获取所有自定义字段的列表", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-typed-custom-fields", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:8ee4f8924bdf96bee8e7d02165ccd27caad15ec66b7d923806337655d2be5400", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "231fb84a1493" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_typed_custom_fields", "path": "/apis/v1/apollo/typed_custom_fields" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/typed_custom_fields", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/usage_stats/api_usage_stats": { "post": { "description": "查看 API 使用情况统计信息和速率限制。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_apollo_usage_stats_api_usage_stats", "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "api_usage_stats": { "description": "使用统计信息和速率限制（如有返回）。", "type": "object" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "查看 API 使用统计信息和速率限制", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-usage-stats-api-usage-stats", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:12c87854a68b04a8d41d3e27462c546d9a38af322e71a38555003a6bbfdc6862", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a942568990c3" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_apollo_usage_stats_api_usage_stats", "path": "/apis/v1/apollo/usage_stats/api_usage_stats" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/usage_stats/api_usage_stats", "x-aisa-validation": "provider" } }, "/apis/v1/apollo/users/search": { "get": { "description": "获取用户列表。需要主 API 密钥。\n\n\n公开参考价格：每次成功请求 $0.012 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_apollo_users_search", "parameters": [ { "description": "页码。", "in": "query", "name": "page", "required": false, "schema": { "type": "integer" } }, { "description": "每页结果数。", "in": "query", "name": "per_page", "required": false, "schema": { "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "pagination": { "description": "分页元数据（返回时）。", "type": "object" }, "users": { "description": "用户（如返回）。", "items": { "type": "string" }, "type": "array" } }, "type": "object" } } }, "description": "成功响应" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "获取用户列表", "tags": [ "default" ], "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "mpp_methods": [], "quote": { "header": "X-AISA-Cost-Mode", "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "apollo", "x-aisa-category": "14", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-users-search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_pricing": "fixed_success", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": true }, "x-aisa-response-source": { "content_hash": "sha256:172657926cf5336ede0f8bca5f63044fa460b90460e6c27a36e1762b26b09a46", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" } }, "x-aisa-revision": { "customer_pricing_ref": "613706296d43", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "101335a2c464" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "get_apollo_users_search", "path": "/apis/v1/apollo/users/search" }, "x-aisa-source": { "content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a", "converter": "reviewed-official-apollo-contact-bulk-body-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e", "converter": "reviewed-official-apollo-query-arrays-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30", "converter": "reviewed-official-apollo-object-bodies-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d", "converter": "reviewed-official-apollo-bulk-update-request-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f", "converter": "reviewed-apollo-nonempty-identity-client-guard@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752", "converter": "reviewed-request-location-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "prior_source": { "content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Apollo People enrichment request locations only: post_apollo_people_match identity fields and reveal_personal_emails move from query to the JSON body; post_apollo_people_bulk_match reveal_personal_emails moves from query to the JSON body. Runtime forwards only the four declared query fields and the opaque body. Other operations, responses and prices unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Complete the existing client-schema requirement for identity input; prevent flags-only or all-empty lookups. No Runtime admission, price, target or request-location change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only accounts/bulk_update JSON requestBody replaced with exact official requestBody. Array types, nested required id and shared update fields retained. Other operations, responses, Runtime, pricing, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Exactly14 existing JSON object request bodies on provider-owned Apollo operations match captured official schemas. No query/path changes, People enrichment guard changes, responses, costs, Runtime config, authority or whole-source maintenance clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only three existing required query ID schemas corrected from string to official array-of-strings. Names, locations, requiredness, other contracts, prices, authority and whole-source clocks unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Only contacts/bulk_update obsolete query inputs replaced by exact required official JSON body. Runtime provider-owned opaque forwarding verified in876; no Runtime, price, response, other operation, authority or whole-source clock change.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/api/v1/users/search", "x-aisa-validation": "provider" } } }, "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://api.aisa.one" } ] }