{
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
},
"schemas": {},
"responses": {},
"parameters": {},
"examples": {},
"requestBodies": {},
"headers": {},
"links": {},
"callbacks": {},
"pathItems": {}
},
"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-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": {
"facts_hash": "9ab7612cf2d53be794cbf1d65d4a257f986ac6783e53c7c3a5d868e4593061c3",
"generator_version": "3",
"protocol_version": "1",
"schema_version": "1",
"composer_version": "27",
"response_pending": [],
"document_hash": "sha256:9133e8b23c59377d40e66fdac54331d366c39240613bf2a2ac78438faeea0398",
"identity_base_document_hash": "sha256:0bf2a798e9958794fdee566fea39ab17873d0203efe1abf20397326127e9b762",
"identity_compatibility_hash": "sha256:3bc28cb12b6a6f37411c3d96a19e68e7ef629e36d32c2e39fa51f0c423aa0fa2"
},
"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",
"x-aisa-catalogs": {
"apollo": {
"title": "Apollo",
"description": "",
"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-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
}
}
}
}
},
"jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
"openapi": "3.1.0",
"security": [
{
"bearerAuth": []
}
],
"servers": [
{
"url": "https://api.aisa.one"
}
],
"paths": {
"/apis/v1/apollo/account_stages": {
"get": {
"description": "List account stages. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_account_stages",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"account_stages": {
"type": "string",
"description": "Account stages list"
},
"account_stages[].id": {
"type": "string",
"description": "Stage ID"
},
"account_stages[].team_id": {
"type": "string",
"description": "Team ID"
},
"account_stages[].display_name": {
"type": "string",
"description": "Display name"
},
"account_stages[].name": {
"type": "string",
"description": "Name"
},
"account_stages[].display_order": {
"type": "integer",
"description": "Display order"
},
"account_stages[].default_exclude_for_leadgen": {
"type": "boolean",
"description": "Default exclude for leadgen"
},
"account_stages[].category": {
"type": "string",
"description": "Category"
},
"account_stages[].is_meeting_set": {
"type": "boolean",
"description": "Is meeting set"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "List Account Stages",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "7959984e59cd"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/account_stages",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_account_stages",
"method": "ANY",
"path": "/apis/v1/apollo/account_stages"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:314313b9569254b2a9e2a71d318209d3dc610151425d1638b9434376402316b9"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-account-stages"
}
},
"/apis/v1/apollo/accounts": {
"post": {
"description": "Create a new account. Duplicate domains are not allowed. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_accounts",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"account": {
"type": "object",
"description": "Created account",
"additionalProperties": true
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Create an Account",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "a7b0c338b026"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/accounts",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_accounts",
"method": "ANY",
"path": "/apis/v1/apollo/accounts"
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name the account that you are creating. This should be a human-readable name.
Example: `The Irish Copywriters`"
},
"domain": {
"type": "string",
"description": "The domain name for the account.
Do not include `www.` or similar.
Example: `apollo.io` or `microsoft.com`"
},
"owner_id": {
"type": "string",
"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`"
},
"account_stage_id": {
"type": "string",
"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`"
},
"phone": {
"type": "string",
"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`"
},
"raw_address": {
"type": "string",
"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`"
},
"typed_custom_fields": {
"type": "object",
"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\"}`",
"additionalProperties": {
"type": "string"
},
"example": {
"60c39ed82bd02f01154c470a": "2025-08-07"
}
}
}
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:3efe3b188b8fb1e0e2f9a701647b87acdbee7089e54ad5995ef638a12f826139"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-accounts"
}
},
"/apis/v1/apollo/accounts/bulk_create": {
"post": {
"description": "Bulk create accounts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_accounts_bulk_create",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"created_accounts": {
"type": "string",
"description": "Accounts created in this request"
},
"created_accounts[].id": {
"type": "string",
"description": "Account ID"
},
"created_accounts[].name": {
"type": "string",
"description": "Account name"
},
"created_accounts[].domain": {
"type": "string",
"description": "Account domain"
},
"created_accounts[].team_id": {
"type": "string",
"description": "Team ID"
},
"created_accounts[].owner_id": {
"type": "string",
"description": "Owner ID"
},
"created_accounts[].account_stage_id": {
"type": "string",
"description": "Account stage ID"
},
"created_accounts[].phone": {
"type": "string",
"description": "Phone number"
},
"created_accounts[].created_at": {
"type": "string",
"description": "Created timestamp"
},
"created_accounts[].updated_at": {
"type": "string",
"description": "Updated timestamp"
},
"existing_accounts": {
"type": "string",
"description": "Accounts that already existed (dedupe matches)"
},
"existing_accounts[].id": {
"type": "string",
"description": "Account ID"
},
"existing_accounts[].name": {
"type": "string",
"description": "Account name"
},
"existing_accounts[].domain": {
"type": "string",
"description": "Account domain"
},
"existing_accounts[].team_id": {
"type": "string",
"description": "Team ID"
},
"existing_accounts[].owner_id": {
"type": "string",
"description": "Owner ID"
},
"existing_accounts[].account_stage_id": {
"type": "string",
"description": "Account stage ID"
},
"existing_accounts[].phone": {
"type": "string",
"description": "Phone number"
},
"existing_accounts[].created_at": {
"type": "string",
"description": "Created timestamp"
},
"existing_accounts[].updated_at": {
"type": "string",
"description": "Updated timestamp"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Bulk Create Accounts",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "1668e54e63f9"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/accounts/bulk_create",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_accounts_bulk_create",
"method": "ANY",
"path": "/apis/v1/apollo/accounts/bulk_create"
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"accounts"
],
"properties": {
"accounts": {
"type": "array",
"description": "Array of account attribute objects (maximum 100 accounts per request)",
"maxItems": 100,
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Account name",
"example": "Acme Corporation"
},
"domain": {
"type": "string",
"description": "Company domain (e.g., 'example.com')",
"example": "acme.com"
},
"owner_id": {
"type": "string",
"description": "Account owner user ID (BSON::ObjectId format). Defaults to current user if not provided",
"example": "507f1f77bcf86cd799439013"
},
"phone": {
"type": "string",
"description": "Company phone number",
"example": "+1-555-0135"
},
"phone_status_cd": {
"type": "string",
"description": "Phone validation status"
},
"raw_address": {
"type": "string",
"description": "Company address",
"example": "123 Main St, San Francisco, CA 94105"
},
"linkedin_url": {
"type": "string",
"description": "LinkedIn company page URL",
"example": "https://linkedin.com/company/acme"
},
"facebook_url": {
"type": "string",
"description": "Facebook page URL",
"example": "https://facebook.com/acme"
},
"twitter_url": {
"type": "string",
"description": "Twitter profile URL",
"example": "https://twitter.com/acme"
},
"salesforce_id": {
"type": "string",
"description": "Salesforce account ID for CRM integration",
"example": "001pJNj9pix2idKsfj"
},
"hubspot_id": {
"type": "string",
"description": "HubSpot company ID for CRM integration",
"example": "12345678"
},
"merged_crm_ids": {
"type": "array",
"description": "Additional CRM IDs for deduplication",
"items": {
"type": "string"
}
},
"organization_id": {
"type": "string",
"description": "Apollo organization ID",
"example": "507f1f77bcf86cd799439012"
},
"parent_account_id": {
"type": "string",
"description": "Parent account ID for account hierarchy (BSON::ObjectId format)",
"example": "507f1f77bcf86cd799439016"
},
"account_stage_id": {
"type": "string",
"description": "Account stage/pipeline stage ID (BSON::ObjectId format)",
"example": "507f1f77bcf86cd799439014"
},
"typed_custom_fields": {
"type": "object",
"description": "Custom field values as key-value pairs where key is the field_id and value is the field_value",
"additionalProperties": {
"type": "string"
},
"example": {
"507f1f77bcf86cd799439020": "High Value",
"507f1f77bcf86cd799439021": "Q4 2025"
}
}
}
}
},
"append_label_names": {
"type": "array",
"description": "Array of label names to add to ALL accounts in this request",
"items": {
"type": "string"
},
"example": [
"Enterprise",
"High Priority"
]
},
"run_dedupe": {
"type": "boolean",
"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",
"default": false,
"example": true
}
}
},
"examples": {
"Basic Account Creation": {
"value": {
"accounts": [
{
"name": "Acme Corporation",
"domain": "acme.com",
"phone": "+1-555-0135"
},
{
"name": "TechStart Inc",
"domain": "example.com",
"linkedin_url": "https://linkedin.com/company/techstart"
}
]
}
},
"With Deduplication (Returns Existing Without Updating)": {
"value": {
"accounts": [
{
"domain": "existing-company.com",
"name": "New Company Name"
}
],
"run_dedupe": true
}
},
"With CRM IDs (Returns Existing Without Updating)": {
"value": {
"accounts": [
{
"salesforce_id": "001pJNj9pix2idKsfj",
"name": "New Name",
"phone": "+1-555-0159"
},
{
"hubspot_id": "12345678",
"name": "Another New Name"
}
]
}
},
"With Custom Fields and Labels": {
"value": {
"accounts": [
{
"name": "Enterprise Client",
"domain": "example.com",
"account_stage_id": "507f1f77bcf86cd799439014",
"typed_custom_fields": {
"507f1f77bcf86cd799439020": "High Value",
"507f1f77bcf86cd799439021": "Q4 2025"
}
}
],
"append_label_names": [
"Enterprise",
"Priority"
]
}
}
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:f7763c06d7c4d93b7b47d893b1bf76878cda9a4ecd209c8481dfb22261b912fa"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-accounts-bulk-create"
}
},
"/apis/v1/apollo/accounts/bulk_update": {
"post": {
"description": "Bulk update accounts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_accounts_bulk_update",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"accounts": {
"type": "string",
"description": "Updated accounts"
},
"accounts[].id": {
"type": "string",
"description": "Account ID"
},
"accounts[].account_stage_id": {
"type": "string",
"description": "Account stage ID"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Bulk Update Accounts",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "cf3634b917bc"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/accounts/bulk_update",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_accounts_bulk_update",
"method": "ANY",
"path": "/apis/v1/apollo/accounts/bulk_update"
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"account_ids": {
"type": "array",
"description": "Array of account IDs to update with the same values. Use this for applying the same updates to multiple accounts.",
"items": {
"type": "string"
},
"example": [
"66e9abf95ac32901b20d1a0d",
"66e9a4db056fe802d331fb8a"
]
},
"account_attributes": {
"type": "array",
"description": "Array of account objects with individual updates. Use this for applying different updates to each account.",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The account ID to update",
"example": "66e9abf95ac32901b20d1a0d"
},
"name": {
"type": "string",
"description": "The account name",
"example": "Acme Corporation"
},
"owner_id": {
"type": "string",
"description": "The Apollo user ID to assign as owner",
"example": "66302798d03b9601c7934ebf"
},
"account_stage_id": {
"type": "string",
"description": "The Apollo account stage ID",
"example": "6095a710bd01d100a506d4b7"
},
"typed_custom_fields": {
"type": "object",
"description": "Custom field values as key-value pairs",
"additionalProperties": {
"type": "string"
},
"example": {
"60c39ed82bd02f01154c470a": "2025-08-07"
}
}
},
"required": [
"id"
]
}
},
"name": {
"type": "string",
"description": "When using account_ids, apply this name to all accounts",
"example": "Updated Account Name"
},
"owner_id": {
"type": "string",
"description": "When using account_ids, apply this owner to all accounts",
"example": "66302798d03b9601c7934ebf"
},
"account_stage_id": {
"type": "string",
"description": "When using account_ids, apply this account stage to all accounts",
"example": "6095a710bd01d100a506d4b7"
},
"async": {
"type": "boolean",
"description": "Set to true to process updates asynchronously. Only available when using account_ids. Not supported with account_attributes.",
"example": false
}
}
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:474ca4a88887d05ccc93b0bf12f3522c0f54b4ed63aae983fecf6f29f28ba9a2"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-accounts-bulk-update"
}
},
"/apis/v1/apollo/accounts/search": {
"post": {
"description": "Search for accounts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_accounts_search",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"breadcrumbs": {
"type": "array",
"items": {
"type": "object",
"description": "Breadcrumb",
"additionalProperties": true
},
"description": "Response array"
},
"partial_results_only": {
"type": "boolean",
"description": "Response field"
},
"has_join": {
"type": "boolean",
"description": "Response field"
},
"disable_eu_prospecting": {
"type": "boolean",
"description": "Response field"
},
"partial_results_limit": {
"type": "integer",
"description": "Response field"
},
"pagination": {
"type": "object",
"description": "Pagination metadata",
"additionalProperties": true
},
"accounts": {
"type": "array",
"items": {
"type": "object",
"description": "Account",
"additionalProperties": true
},
"description": "Response array"
},
"num_fetch_result": {
"type": [
"object",
"null"
],
"description": "Fetch-result metadata",
"additionalProperties": true
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Search for Accounts",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "5337238ad680"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/accounts/search",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_accounts_search",
"method": "ANY",
"path": "/apis/v1/apollo/accounts/search"
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"q_organization_name": {
"type": "string",
"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`"
},
"account_stage_ids": {
"type": "array",
"items": {
"type": "string"
},
"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`"
},
"account_label_ids": {
"type": "array",
"items": {
"type": "string"
},
"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']`"
},
"sort_by_field": {
"type": "string",
"enum": [
"account_last_activity_date",
"account_created_at",
"account_updated_at"
],
"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."
},
"sort_ascending": {
"type": "boolean",
"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`"
},
"page": {
"type": "integer",
"format": "int32",
"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`"
},
"per_page": {
"type": "integer",
"format": "int32",
"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`"
}
}
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:65d160b4870a989bb16cd6f82cf2ab3f15f22d45989c43f24dee1754cac78353"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-accounts-search"
}
},
"/apis/v1/apollo/accounts/update_owners": {
"post": {
"description": "Update account owner for multiple accounts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_accounts_update_owners",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"accounts": {
"type": "string",
"description": "Updated accounts"
},
"accounts[].id": {
"type": "string",
"description": "Account ID"
},
"accounts[].owner_id": {
"type": "string",
"description": "Owner ID"
},
"accounts[].crm_owner_id": {
"type": "string",
"description": "CRM owner ID"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Update Account Owner for Multiple Accounts",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "b306f4b49856"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/accounts/update_owners",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_accounts_update_owners",
"method": "ANY",
"path": "/apis/v1/apollo/accounts/update_owners"
},
"parameters": [
{
"name": "account_ids[]",
"in": "query",
"required": true,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Account IDs"
},
{
"name": "owner_id",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "New owner ID"
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:ebf3e6437fc2830eedcd01c63d45a1e5f75850218ae86921de70a0b28f98c989"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-accounts-update-owners"
}
},
"/apis/v1/apollo/accounts/{account_id}": {
"patch": {
"description": "Update fields on an existing account. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "patch_apollo_accounts_account_id",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"account": {
"type": "object",
"description": "Updated account",
"additionalProperties": true
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Update an Account",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "1bd5d4692f7b"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/accounts/{account_id}",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "patch_apollo_accounts_account_id",
"method": "ANY",
"path": "/apis/v1/apollo/accounts/{account_id}"
},
"parameters": [
{
"name": "account_id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "Account ID"
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Update the account's name. This should be a human-readable name.
Example: `The Fast Irish Copywriters`"
},
"domain": {
"type": "string",
"description": "Update the domain name for the account. Do not include `www.` or similar.
Example: `apollo.io` or `microsoft.com`"
},
"owner_id": {
"type": "string",
"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`"
},
"account_stage_id": {
"type": "string",
"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`"
},
"raw_address": {
"type": "string",
"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`"
},
"phone": {
"type": "string",
"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`"
},
"typed_custom_fields": {
"type": "object",
"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\"}`",
"additionalProperties": {
"type": "string"
},
"example": {
"60c39ed82bd02f01154c470a": "2025-08-07"
}
}
}
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:c6c609623505688db26dd95353f0991586d005887951e8c06794cc7f09c954fa"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/patch_apollo-accounts-account-id"
}
},
"/apis/v1/apollo/accounts/{id}": {
"get": {
"description": "View an account by ID. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_accounts_id",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"account": {
"type": "object",
"description": "Account",
"additionalProperties": true
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "View an Account",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "8db59be70bfe"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/accounts/{id}",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_accounts_id",
"method": "ANY",
"path": "/apis/v1/apollo/accounts/{id}"
},
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "Account ID"
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:b78318eff7340733efc7d827394839aecbb41a8b4ce9a7a92768a86278470ab3"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-accounts-id"
}
},
"/apis/v1/apollo/contact_stages": {
"get": {
"description": "List contact stages. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_contact_stages",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"contact_stages": {
"type": "string",
"description": "Contact stages list"
},
"contact_stages[].id": {
"type": "string",
"description": "Stage ID"
},
"contact_stages[].team_id": {
"type": "string",
"description": "Team ID"
},
"contact_stages[].display_name": {
"type": "string",
"description": "Display name"
},
"contact_stages[].name": {
"type": "string",
"description": "Name"
},
"contact_stages[].display_order": {
"type": "integer",
"description": "Display order"
},
"contact_stages[].ignore_trigger_override": {
"type": "boolean",
"description": "Ignore trigger override"
},
"contact_stages[].category": {
"type": "string",
"description": "Category"
},
"contact_stages[].is_meeting_set": {
"type": "boolean",
"description": "Is meeting set"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "List Contact Stages",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "aa33947107f0"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/contact_stages",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_contact_stages",
"method": "ANY",
"path": "/apis/v1/apollo/contact_stages"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:a21be582d64d92b19be19fea8e62425cb670b473e3d1b55651667426c13f2f53"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-contact-stages"
}
},
"/apis/v1/apollo/contacts": {
"post": {
"description": "Create a new contact. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_contacts",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"contact": {
"type": "object",
"description": "Created contact",
"additionalProperties": true
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Create a Contact",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "c14358c33fd6"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/contacts",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_contacts",
"method": "ANY",
"path": "/apis/v1/apollo/contacts"
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"first_name": {
"type": "string",
"description": "The first name of the contact you want to create. Example: `Tim`"
},
"last_name": {
"type": "string",
"description": "The last name of the contact you want to create. Example: `Zheng`"
},
"organization_name": {
"type": "string",
"description": "The name of the contact's employer (company). Example: `apollo`"
},
"title": {
"type": "string",
"description": "The current job title that the contact holds. Example: `senior research analyst`"
},
"account_id": {
"type": "string",
"description": "The Apollo ID for the account. Example: `63f53afe4ceeca00016bdd2f`"
},
"email": {
"type": "string",
"description": "The email address of the contact. Example: `example@email.com`"
},
"website_url": {
"type": "string",
"description": "The corporate website URL. Example: `https://www.apollo.io/`"
},
"label_names": {
"type": "array",
"description": "Lists to which the contact belongs.",
"items": {
"type": "string"
}
},
"contact_stage_id": {
"type": "string",
"description": "The Apollo ID for the contact stage. Example: `6095a710bd01d100a506d4ae`"
},
"present_raw_address": {
"type": "string",
"description": "The personal location for the contact. Example: `Atlanta, United States`"
},
"direct_phone": {
"type": "string",
"description": "The primary phone number. Example: `555-555-0133`"
},
"corporate_phone": {
"type": "string",
"description": "The work/office phone number. Example: `+44 7700 900852`"
},
"mobile_phone": {
"type": "string",
"description": "The mobile phone number. Example: `555-555-0133`"
},
"home_phone": {
"type": "string",
"description": "The home phone number. Example: `555-555-0133`"
},
"other_phone": {
"type": "string",
"description": "Alternative phone number. Example: `555-555-0133`"
},
"typed_custom_fields": {
"type": "object",
"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\"}`",
"additionalProperties": {
"type": "string"
},
"example": {
"60c39ed82bd02f01154c470a": "2025-08-07"
}
},
"run_dedupe": {
"type": "boolean",
"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.",
"default": false
}
}
},
"examples": {
"Create contact without deduplication": {
"summary": "Create a new contact without deduplication (default behavior)",
"value": {
"first_name": "John",
"last_name": "Smith",
"email": "john.smith@example.com",
"organization_name": "Example Corp",
"title": "Software Engineer"
}
},
"Create contact with deduplication": {
"summary": "Create a new contact with deduplication enabled",
"value": {
"first_name": "Jane",
"last_name": "Doe",
"email": "jane.doe@example.com",
"organization_name": "Example Corp",
"title": "Product Manager",
"run_dedupe": true
}
}
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:4a7a89e75801ee9b730b52cfaa6f1a5adbc9c398baee076590a1c293291e7ac0"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-contacts"
}
},
"/apis/v1/apollo/contacts/bulk_create": {
"post": {
"description": "Bulk create contacts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_contacts_bulk_create",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"created_contacts": {
"type": "string",
"description": "Contacts created in this request"
},
"created_contacts[].id": {
"type": "string",
"description": "Contact ID"
},
"created_contacts[].first_name": {
"type": "string",
"description": "First name"
},
"created_contacts[].last_name": {
"type": "string",
"description": "Last name"
},
"created_contacts[].organization_name": {
"type": "string",
"description": "Organization name"
},
"created_contacts[].title": {
"type": "string",
"description": "Title"
},
"created_contacts[].owner_id": {
"type": "string",
"description": "Owner ID"
},
"created_contacts[].account_id": {
"type": "string",
"description": "Account ID"
},
"created_contacts[].email": {
"type": "string",
"description": "Email"
},
"created_contacts[].phone_numbers": {
"type": "string",
"description": "Phone numbers"
},
"created_contacts[].typed_custom_fields": {
"type": "object",
"description": "Typed custom fields object"
},
"created_contacts[].updated_at": {
"type": "string",
"description": "Updated timestamp"
},
"existing_contacts": {
"type": "string",
"description": "Contacts that already existed (dedupe matches)"
},
"existing_contacts[].id": {
"type": "string",
"description": "Contact ID"
},
"existing_contacts[].first_name": {
"type": "string",
"description": "First name"
},
"existing_contacts[].last_name": {
"type": "string",
"description": "Last name"
},
"existing_contacts[].organization_name": {
"type": "string",
"description": "Organization name"
},
"existing_contacts[].title": {
"type": "string",
"description": "Title"
},
"existing_contacts[].owner_id": {
"type": "string",
"description": "Owner ID"
},
"existing_contacts[].account_id": {
"type": "string",
"description": "Account ID"
},
"existing_contacts[].email": {
"type": "string",
"description": "Email"
},
"existing_contacts[].phone_numbers": {
"type": "string",
"description": "Phone numbers"
},
"existing_contacts[].typed_custom_fields": {
"type": "object",
"description": "Typed custom fields object"
},
"existing_contacts[].updated_at": {
"type": "string",
"description": "Updated timestamp"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Bulk Create Contacts",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "2b5c760150eb"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/contacts/bulk_create",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_contacts_bulk_create",
"method": "ANY",
"path": "/apis/v1/apollo/contacts/bulk_create"
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"contacts"
],
"properties": {
"contacts": {
"type": "array",
"description": "Array of contact objects to create (maximum 100 contacts per request)",
"maxItems": 100,
"items": {
"type": "object",
"properties": {
"first_name": {
"type": "string",
"description": "Contact's first name",
"example": "John"
},
"last_name": {
"type": "string",
"description": "Contact's last name",
"example": "Doe"
},
"email": {
"type": "string",
"description": "Contact's email address",
"example": "john.doe@example.com"
},
"title": {
"type": "string",
"description": "Contact's job title",
"example": "Senior Manager"
},
"primary_title": {
"type": "string",
"description": "Primary job title (takes precedence over title)",
"example": "VP of Sales"
},
"organization_name": {
"type": "string",
"description": "Company/organization name",
"example": "Acme Corporation"
},
"phone": {
"type": "string",
"description": "Phone number",
"example": "+1-555-0135"
},
"present_raw_address": {
"type": "string",
"description": "Physical address",
"example": "San Francisco, CA"
},
"linkedin_url": {
"type": "string",
"description": "LinkedIn profile URL",
"example": "https://www.linkedin.com/in/john-doe-3f9a7c21"
},
"facebook_url": {
"type": "string",
"description": "Facebook profile URL",
"example": "https://www.facebook.com/johndoe"
},
"twitter_url": {
"type": "string",
"description": "Twitter profile URL",
"example": "https://twitter.com/johndoe"
},
"photo_url": {
"type": "string",
"description": "Profile photo URL",
"example": "https://example.com/photo.jpg"
},
"account_id": {
"type": "string",
"description": "Associated account ID",
"example": "507f1f77bcf86cd799439011"
},
"organization_id": {
"type": "string",
"description": "Associated organization ID",
"example": "507f1f77bcf86cd799439012"
},
"contact_stage_id": {
"type": "string",
"description": "Contact stage ID",
"example": "507f1f77bcf86cd799439014"
},
"salesforce_id": {
"type": "string",
"description": "Salesforce ID for matching and deduplication",
"example": "003xx000004TmiQAAS"
},
"hubspot_id": {
"type": "string",
"description": "HubSpot ID for matching and deduplication",
"example": "12345678"
},
"salesforce_lead_id": {
"type": "string",
"description": "Salesforce Lead ID",
"example": "00Qxx000001abcDEFG"
},
"salesforce_contact_id": {
"type": "string",
"description": "Salesforce Contact ID for matching",
"example": "003xx000004TmiQAAS"
},
"salesforce_account_id": {
"type": "string",
"description": "Salesforce Account ID",
"example": "001pJNj9pix2idKsfj"
},
"outreach_id": {
"type": "string",
"description": "Outreach.io ID",
"example": "98765"
},
"salesloft_id": {
"type": "string",
"description": "SalesLoft ID",
"example": "54321"
},
"phone_status_cd": {
"type": "string",
"description": "Phone validation status"
},
"typed_custom_fields": {
"type": "object",
"description": "Custom field values as key-value pairs where key is the field_id and value is the field_value",
"additionalProperties": {
"type": "string"
},
"example": {
"60c39ed82bd02f01154c470a": "2025-08-07"
}
},
"contact_emails": {
"type": "array",
"description": "Array of email objects with position",
"items": {
"type": "object",
"properties": {
"email": {
"type": "string",
"example": "john.doe@example.com"
},
"position": {
"type": "integer",
"example": 0
}
}
}
},
"phone_numbers": {
"type": "array",
"description": "Array of phone number objects",
"items": {
"type": "object",
"properties": {
"raw_number": {
"type": "string",
"example": "+1-555-0135"
},
"position": {
"type": "integer",
"example": 0
}
}
}
}
}
}
},
"append_label_names": {
"type": "array",
"description": "Array of label names to add to ALL contacts in this request",
"items": {
"type": "string"
},
"example": [
"Hot Lead",
"Q1 2024"
]
},
"owner_id": {
"type": "string",
"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"
},
"run_dedupe": {
"type": "boolean",
"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.",
"default": false,
"example": true
}
}
},
"examples": {
"Basic Contact Creation": {
"value": {
"contacts": [
{
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"title": "Senior Manager",
"organization_name": "Acme Corporation"
},
{
"first_name": "Jane",
"last_name": "Smith",
"email": "jane.smith@example.com",
"title": "VP of Sales",
"organization_name": "TechStart Inc",
"linkedin_url": "https://www.linkedin.com/in/jane-smith-4c8e21a9"
}
]
}
},
"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 CRM IDs (Returns Existing Without Updating)": {
"value": {
"contacts": [
{
"salesforce_contact_id": "003xx000004TmiQAAS",
"first_name": "John",
"last_name": "Doe",
"email": "john.doe@example.com",
"phone": "+1-555-0159"
},
{
"hubspot_id": "12345678",
"first_name": "Jane",
"last_name": "Smith",
"email": "jane.smith@example.com"
}
]
}
},
"With Custom Fields and Labels": {
"value": {
"contacts": [
{
"first_name": "Sarah",
"last_name": "Whitfield",
"email": "sarah.whitfield@example.com",
"title": "CTO",
"organization_name": "Enterprise Corp",
"contact_stage_id": "507f1f77bcf86cd799439014",
"typed_custom_fields": {
"60c39ed82bd02f01154c470a": "2025-12-31",
"60c39ed82bd02f01154c470b": "High Priority"
}
}
],
"append_label_names": [
"VIP",
"Decision Maker"
]
}
},
"With Multiple Contact Details": {
"value": {
"contacts": [
{
"first_name": "Michael",
"last_name": "Brown",
"organization_name": "Tech Solutions",
"contact_emails": [
{
"email": "michael.brown@example.com",
"position": 0
},
{
"email": "mbrown@example.com",
"position": 1
}
],
"phone_numbers": [
{
"raw_number": "+1-555-0135",
"position": 0
},
{
"raw_number": "+1-555-0122",
"position": 1
}
]
}
]
}
},
"With Top-Level Owner Assignment": {
"value": {
"contacts": [
{
"first_name": "Alice",
"last_name": "Chen",
"email": "alice.chen@example.com",
"title": "Director of Engineering",
"organization_name": "CloudCo",
"account_id": "507f1f77bcf86cd799439011"
},
{
"first_name": "Bob",
"last_name": "Lee",
"email": "bob.lee@example.com",
"title": "Head of Product",
"organization_name": "CloudCo",
"account_id": "507f1f77bcf86cd799439011"
}
],
"owner_id": "507f1f77bcf86cd799439013"
}
}
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:6db95cc0bca89268140a7b3a674922af9ffe88ffa2419ac0e558c288227532d7"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-contacts-bulk-create"
}
},
"/apis/v1/apollo/contacts/bulk_update": {
"post": {
"description": "Bulk update contacts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_contacts_bulk_update",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"contacts": {
"type": "string",
"description": "Updated contacts"
},
"contacts[].id": {
"type": "string",
"description": "Contact ID"
},
"contacts[].first_name": {
"type": "string",
"description": "First name"
},
"contacts[].last_name": {
"type": "string",
"description": "Last name"
},
"contacts[].email": {
"type": "string",
"description": "Email"
},
"contacts[].title": {
"type": "string",
"description": "Title"
},
"contacts[].organization_name": {
"type": "string",
"description": "Organization name"
},
"contacts[].owner_id": {
"type": "string",
"description": "Owner ID"
},
"contacts[].account_id": {
"type": "string",
"description": "Account ID"
},
"contacts[].present_raw_address": {
"type": "string",
"description": "Raw address"
},
"contacts[].linkedin_url": {
"type": "string",
"description": "LinkedIn URL"
},
"contacts[].updated_at": {
"type": "string",
"description": "Updated timestamp"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Bulk Update Contacts",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "94f381c5855a"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/contacts/bulk_update",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_contacts_bulk_update",
"method": "ANY",
"path": "/apis/v1/apollo/contacts/bulk_update"
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"contact_ids": {
"type": "array",
"description": "Array of contact IDs to update with the same values. Use this for applying the same updates to multiple contacts.",
"items": {
"type": "string"
},
"example": [
"66e34b81740c50074e3d1bd4",
"66e370fbf5f5c003f0e1d0cf"
]
},
"contact_attributes": {
"type": "array",
"description": "Array of contact objects with individual updates. Use this for applying different updates to each contact.",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The contact ID to update",
"example": "66e34b81740c50074e3d1bd4"
},
"first_name": {
"type": "string",
"description": "The contact's first name",
"example": "John"
},
"last_name": {
"type": "string",
"description": "The contact's last name",
"example": "Doe"
},
"email": {
"type": "string",
"description": "The contact's email address",
"example": "john.doe@example.com"
},
"title": {
"type": "string",
"description": "The contact's job title",
"example": "Senior Manager"
},
"organization_name": {
"type": "string",
"description": "The contact's organization name",
"example": "Example Corp"
},
"owner_id": {
"type": "string",
"description": "The Apollo user ID to assign as owner",
"example": "66302798d03b9601c7934ebf"
},
"account_id": {
"type": "string",
"description": "The Apollo account ID to associate with the contact",
"example": "63f53afe4ceeca00016bdd2f"
},
"present_raw_address": {
"type": "string",
"description": "The contact's location",
"example": "San Francisco, CA"
},
"linkedin_url": {
"type": "string",
"description": "The contact's LinkedIn profile URL",
"example": "https://www.linkedin.com/in/john-doe-3f9a7c21"
},
"typed_custom_fields": {
"type": "object",
"description": "Custom field values as key-value pairs",
"additionalProperties": {
"type": "string"
},
"example": {
"60c39ed82bd02f01154c470a": "2025-08-07"
}
}
},
"required": [
"id"
]
}
},
"owner_id": {
"type": "string",
"description": "When using contact_ids, apply this owner to all contacts",
"example": "66302798d03b9601c7934ebf"
},
"email": {
"type": "string",
"description": "When using contact_ids, apply this email to all contacts",
"example": "updated@example.com"
},
"organization_name": {
"type": "string",
"description": "When using contact_ids, apply this organization name to all contacts",
"example": "Updated Corp"
},
"title": {
"type": "string",
"description": "When using contact_ids, apply this title to all contacts",
"example": "Updated Title"
},
"first_name": {
"type": "string",
"description": "When using contact_ids, apply this first name to all contacts",
"example": "Updated"
},
"last_name": {
"type": "string",
"description": "When using contact_ids, apply this last name to all contacts",
"example": "Name"
},
"account_id": {
"type": "string",
"description": "When using contact_ids, apply this account ID to all contacts",
"example": "63f53afe4ceeca00016bdd2f"
},
"present_raw_address": {
"type": "string",
"description": "When using contact_ids, apply this address to all contacts",
"example": "New York, NY"
},
"linkedin_url": {
"type": "string",
"description": "When using contact_ids, apply this LinkedIn URL to all contacts",
"example": "https://www.linkedin.com/in/updated"
},
"typed_custom_fields": {
"type": "object",
"description": "When using contact_ids, apply these custom fields to all contacts",
"additionalProperties": {
"type": "string"
},
"example": {
"60c39ed82bd02f01154c470a": "2025-08-07"
}
},
"async": {
"type": "boolean",
"description": "Force asynchronous processing. Automatically enabled for >100 contacts.",
"example": false
},
"visible_entity_ids": {
"type": "array",
"description": "Specific contact IDs to return in the response (for performance)",
"items": {
"type": "string"
},
"example": [
"66e34b81740c50074e3d1bd4"
]
}
},
"anyOf": [
{
"required": [
"contact_ids"
]
},
{
"required": [
"contact_attributes"
]
}
]
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:7e5e49de66f415fd4b46f63967d1df7ada1864416b815f70e6ce941324bc6b06"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-contacts-bulk-update"
}
},
"/apis/v1/apollo/contacts/search": {
"post": {
"description": "Search for contacts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_contacts_search",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"contacts": {
"type": "array",
"items": {
"type": "object",
"description": "Contact",
"additionalProperties": true
},
"description": "Response array"
},
"breadcrumbs": {
"type": "array",
"items": {
"type": "object",
"description": "Breadcrumb",
"additionalProperties": true
},
"description": "Response array"
},
"partial_results_only": {
"type": "boolean",
"description": "Response field"
},
"has_join": {
"type": "boolean",
"description": "Response field"
},
"disable_eu_prospecting": {
"type": "boolean",
"description": "Response field"
},
"partial_results_limit": {
"type": "integer",
"description": "Response field"
},
"pagination": {
"type": "object",
"description": "Pagination metadata",
"additionalProperties": true
},
"num_fetch_result": {
"type": [
"object",
"null"
],
"description": "Fetch-result metadata",
"additionalProperties": true
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Search for Contacts",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "44ba30e71231"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/contacts/search",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_contacts_search",
"method": "ANY",
"path": "/apis/v1/apollo/contacts/search"
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"q_keywords": {
"type": "string",
"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`"
},
"contact_stage_ids": {
"type": "array",
"items": {
"type": "string"
},
"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`"
},
"contact_label_ids": {
"type": "array",
"items": {
"type": "string"
},
"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']`"
},
"sort_by_field": {
"type": "string",
"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."
},
"sort_ascending": {
"type": "boolean",
"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`"
},
"per_page": {
"type": "integer",
"format": "int32",
"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`"
},
"page": {
"type": "integer",
"format": "int32",
"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`"
}
}
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:f0949578236317d865eed847df369e73df3bec4f013e0a62254b4c1535d13e0a"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-contacts-search"
}
},
"/apis/v1/apollo/contacts/update_owners": {
"post": {
"description": "Update contact owner for multiple contacts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_contacts_update_owners",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"contacts": {
"type": "string",
"description": "Updated contacts"
},
"contacts[].id": {
"type": "string",
"description": "Contact ID"
},
"contacts[].owner_id": {
"type": "string",
"description": "Owner ID"
},
"contacts[].crm_owner_id": {
"type": "string",
"description": "CRM owner ID"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Update Contact Owner for Multiple Contacts",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "0426b96b52da"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/contacts/update_owners",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_contacts_update_owners",
"method": "ANY",
"path": "/apis/v1/apollo/contacts/update_owners"
},
"parameters": [
{
"name": "contact_ids[]",
"in": "query",
"required": true,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Contact IDs"
},
{
"name": "owner_id",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "New owner ID"
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:e9f921d031285d6202c523deaf09685e6d2c8a02f38ad5c1111ecfcdb7c16ecd"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-contacts-update-owners"
}
},
"/apis/v1/apollo/contacts/update_stages": {
"post": {
"description": "Update contact stage for multiple contacts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_contacts_update_stages",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"contacts": {
"type": "string",
"description": "Updated contacts"
},
"contacts[].id": {
"type": "string",
"description": "Contact ID"
},
"contacts[].first_name": {
"type": "string",
"description": "First name"
},
"contacts[].last_name": {
"type": "string",
"description": "Last name"
},
"contacts[].contact_stage_id": {
"type": "string",
"description": "Contact stage ID"
},
"contacts[].owner_id": {
"type": "string",
"description": "Owner ID"
},
"contacts[].email": {
"type": "string",
"description": "Email"
},
"contacts[].organization_name": {
"type": "string",
"description": "Organization name"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Update Contact Stage for Multiple Contacts",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "e0da0245de25"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/contacts/update_stages",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_contacts_update_stages",
"method": "ANY",
"path": "/apis/v1/apollo/contacts/update_stages"
},
"parameters": [
{
"name": "contact_ids[]",
"in": "query",
"required": true,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Contact IDs"
},
{
"name": "contact_stage_id",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "New contact stage ID"
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:3aa0c49e3b57c9b058730769dd9206767af6828f536a1293b0ace908a4c26a6c"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-contacts-update-stages"
}
},
"/apis/v1/apollo/contacts/{contact_id}": {
"get": {
"description": "View a contact by ID. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_contacts_contact_id",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"contact": {
"type": "object",
"description": "Contact object"
},
"contact.id": {
"type": "string",
"description": "Contact ID"
},
"contact.first_name": {
"type": "string",
"description": "First name"
},
"contact.last_name": {
"type": "string",
"description": "Last name"
},
"contact.organization_name": {
"type": "string",
"description": "Organization name"
},
"contact.title": {
"type": "string",
"description": "Title"
},
"contact.email": {
"type": "string",
"description": "Email"
},
"contact.phone_numbers": {
"type": "string",
"description": "Phone numbers"
},
"contact.phone_numbers[].raw_number": {
"type": "string",
"description": "Raw number"
},
"contact.phone_numbers[].sanitized_number": {
"type": "string",
"description": "Sanitized number"
},
"contact.owner_id": {
"type": "string",
"description": "Owner ID"
},
"contact.account_id": {
"type": "string",
"description": "Account ID"
},
"contact.present_raw_address": {
"type": "string",
"description": "Raw address"
},
"contact.linkedin_url": {
"type": "string",
"description": "LinkedIn URL"
},
"contact.updated_at": {
"type": "string",
"description": "Updated timestamp"
}
}
}
}
}
},
"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",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "bdbc0c09ed7e"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/contacts/{contact_id}",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_contacts_contact_id",
"method": "ANY",
"path": "/apis/v1/apollo/contacts/{contact_id}"
},
"parameters": [
{
"name": "contact_id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "Contact ID"
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:cafc79beae687d287801fffd66c369b5c3734b4e87ae1edc007d04c233911814"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-contacts-contact-id"
},
"patch": {
"description": "View a contact by ID. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "patch_apollo_contacts_contact_id",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"contact": {
"type": "object",
"description": "Updated contact"
},
"contact.id": {
"type": "string",
"description": "Contact ID"
},
"contact.first_name": {
"type": "string",
"description": "First name"
},
"contact.last_name": {
"type": "string",
"description": "Last name"
},
"contact.email": {
"type": "string",
"description": "Email"
},
"contact.title": {
"type": "string",
"description": "Title"
},
"contact.organization_name": {
"type": "string",
"description": "Organization name"
},
"contact.owner_id": {
"type": "string",
"description": "Owner ID"
},
"contact.account_id": {
"type": "string",
"description": "Account ID"
},
"contact.present_raw_address": {
"type": "string",
"description": "Raw address"
}
}
}
}
}
},
"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",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "bdbc0c09ed7e"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/contacts/{contact_id}",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_contacts_contact_id",
"method": "ANY",
"path": "/apis/v1/apollo/contacts/{contact_id}"
},
"parameters": [
{
"name": "contact_id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "Contact ID"
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"first_name": {
"type": "string",
"description": "Update the contact's first name. Example: `Tim`"
},
"last_name": {
"type": "string",
"description": "Update the contact's last name. Example: `Zheng`"
},
"organization_name": {
"type": "string",
"description": "Update the employer (company) name. Example: `apollo`"
},
"title": {
"type": "string",
"description": "Update the job title. Example: `senior research analyst`"
},
"account_id": {
"type": "string",
"description": "Update the account ID. Example: `63f53afe4ceeca00016bdd2f`"
},
"email": {
"type": "string",
"description": "Update the contact email. Example: `example@email.com`"
},
"website_url": {
"type": "string",
"description": "Update the employer website URL. Example: `https://www.apollo.io/`"
},
"label_names": {
"type": "array",
"description": "Replace lists this contact belongs to. (Passing new values will overwrite existing lists.)",
"items": {
"type": "string"
}
},
"contact_stage_id": {
"type": "string",
"description": "Update the contact stage ID. Example: `6095a710bd01d100a506d4af`"
},
"present_raw_address": {
"type": "string",
"description": "Update location (city/state/country). Example: `Atlanta, United States`"
},
"direct_phone": {
"type": "string",
"description": "Primary phone."
},
"corporate_phone": {
"type": "string",
"description": "Work/office phone."
},
"mobile_phone": {
"type": "string",
"description": "Mobile phone."
},
"home_phone": {
"type": "string",
"description": "Home phone."
},
"other_phone": {
"type": "string",
"description": "Alternate phone."
},
"typed_custom_fields": {
"type": "object",
"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\"}`",
"additionalProperties": {
"type": "string"
},
"example": {
"60c39ed82bd02f01154c470a": "2025-08-07"
}
}
}
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:af9a5661bc0af5f5a5bf37e030b661f98a1d48a01a5506ee56ba354272e5ab8f"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/patch_apollo-contacts-contact-id"
}
},
"/apis/v1/apollo/email_accounts": {
"get": {
"description": "Get a list of email accounts. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_email_accounts",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"email_accounts": {
"type": "array",
"items": {
"type": "string"
},
"description": "Email accounts (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Get a List of Email Accounts",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "b3dee57d06be"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/email_accounts",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_email_accounts",
"method": "ANY",
"path": "/apis/v1/apollo/email_accounts"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:469561e98eb7969b4c20abc036c4856a38898ba2b23a779ecec5ee4241e7650e"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-email-accounts"
}
},
"/apis/v1/apollo/emailer_campaigns/remove_or_stop_contact_ids": {
"post": {
"description": "Update contact status in a sequence. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_emailer_campaigns_remove_or_stop_contact_ids",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"success": {
"type": "boolean",
"description": "Whether the update succeeded (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Update Contact Status in a Sequence",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "6c0be94ded0d"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/emailer_campaigns/remove_or_stop_contact_ids",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_emailer_campaigns_remove_or_stop_contact_ids",
"method": "ANY",
"path": "/apis/v1/apollo/emailer_campaigns/remove_or_stop_contact_ids"
},
"parameters": [
{
"name": "contact_ids[]",
"in": "query",
"required": true,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Contact IDs."
},
{
"name": "emailer_campaign_ids[]",
"in": "query",
"required": true,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Sequence IDs."
},
{
"name": "mode",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "One of: mark_as_finished, remove, stop."
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:20a3de1cca78a177acf6ca961db49d2b2e1f232b43dc020e82021ae12f72afdd"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-remove-or-stop-contact-ids"
}
},
"/apis/v1/apollo/emailer_campaigns/search": {
"post": {
"description": "Search for sequences (emailer campaigns) in your Apollo account. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_emailer_campaigns_search",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"emailer_campaigns": {
"type": "array",
"items": {
"type": "string"
},
"description": "Sequence records (when returned)."
},
"pagination": {
"type": "object",
"description": "Pagination metadata (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Search for Sequences",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "ea9942cfeddf"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/emailer_campaigns/search",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_emailer_campaigns_search",
"method": "ANY",
"path": "/apis/v1/apollo/emailer_campaigns/search"
},
"parameters": [
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Page number."
},
{
"name": "per_page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Results per page."
},
{
"name": "q_name",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Keywords to match sequence names."
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:d63cb1faae10a7de1ece34d1438668c85e1a473353310a0b8bdf48f2fcd7e5ee"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-search"
}
},
"/apis/v1/apollo/emailer_campaigns/{sequence_id}/abort": {
"post": {
"description": "Deactivate a sequence. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_emailer_campaigns_sequence_id_abort",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"emailer_campaign": {
"type": "object",
"description": "Sequence object (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Deactivate a Sequence",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "a8c903c4af9f"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/emailer_campaigns/{sequence_id}/abort",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_emailer_campaigns_sequence_id_abort",
"method": "ANY",
"path": "/apis/v1/apollo/emailer_campaigns/{sequence_id}/abort"
},
"parameters": [
{
"name": "sequence_id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "Sequence ID."
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:cc8ac3b8dd33e2200fb7a7f8636765d9dfa40d36d68c2eee5fe0f8a0978bec69"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-sequence-id-abort"
}
},
"/apis/v1/apollo/emailer_campaigns/{sequence_id}/add_contact_ids": {
"post": {
"description": "Add contacts to a sequence. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_emailer_campaigns_add_contact_ids",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"success": {
"type": "boolean",
"description": "Whether the add succeeded (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Add Contacts to a Sequence",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "e80bfe3cd1aa"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/emailer_campaigns/{sequence_id}/add_contact_ids",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_emailer_campaigns_add_contact_ids",
"method": "ANY",
"path": "/apis/v1/apollo/emailer_campaigns/{sequence_id}/add_contact_ids"
},
"parameters": [
{
"name": "sequence_id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "Sequence (emailer campaign) ID."
},
{
"name": "contact_ids[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Contact IDs to add. Provide either contact_ids[] or label_names[] (or both)."
},
{
"name": "emailer_campaign_id",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Sequence ID (same as sequence_id)."
},
{
"name": "label_names[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Label names for contacts to add. Provide either label_names[] or contact_ids[] (or both)."
},
{
"name": "send_email_from_email_account_id",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Email account ID (or IDs) to send from."
},
{
"name": "send_email_from_email_address",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Optional from-address alias."
},
{
"name": "sequence_active_in_other_campaigns",
"in": "query",
"required": false,
"schema": {
"type": "boolean"
},
"description": "Allow contacts active in other sequences."
},
{
"name": "sequence_finished_in_other_campaigns",
"in": "query",
"required": false,
"schema": {
"type": "boolean"
},
"description": "Allow contacts finished in other sequences."
},
{
"name": "sequence_job_change",
"in": "query",
"required": false,
"schema": {
"type": "boolean"
},
"description": "Allow contacts with job change."
},
{
"name": "sequence_no_email",
"in": "query",
"required": false,
"schema": {
"type": "boolean"
},
"description": "Allow contacts without email."
},
{
"name": "sequence_unverified_email",
"in": "query",
"required": false,
"schema": {
"type": "boolean"
},
"description": "Allow contacts with unverified email."
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:378788aae1190adc12379d13624c91cde312b4bf816d349850128e222b2d20d2"
},
"x-aisa-identity": {
"schema_version": 1,
"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"
}
],
"sha256": "sha256:baa386af467f49a315a1a8b2cd4aad7e66819e0d87e80b085a4d9e7e509f9f09"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-sequence-id-add-contact-ids"
}
},
"/apis/v1/apollo/emailer_campaigns/{sequence_id}/approve": {
"post": {
"description": "Activate a sequence. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_emailer_campaigns_sequence_id_approve",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"emailer_campaign": {
"type": "object",
"description": "Sequence object (when returned)."
},
"emailer_steps": {
"type": "array",
"items": {
"type": "string"
},
"description": "Sequence steps (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Activate a Sequence",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "8539cc0b9640"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/emailer_campaigns/{sequence_id}/approve",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_emailer_campaigns_sequence_id_approve",
"method": "ANY",
"path": "/apis/v1/apollo/emailer_campaigns/{sequence_id}/approve"
},
"parameters": [
{
"name": "sequence_id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "Sequence ID."
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:17990a9d32d4c8022e561bd01e09d8118e5a6afa0834309add3f41477f6834d2"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-sequence-id-approve"
}
},
"/apis/v1/apollo/emailer_campaigns/{sequence_id}/archive": {
"post": {
"description": "Archive a sequence (marks it inactive and finishes contacts). Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_emailer_campaigns_sequence_id_archive",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"emailer_campaign": {
"type": "object",
"description": "Archived sequence object (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Archive a Sequence",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "f7fb9165ac2b"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/emailer_campaigns/{sequence_id}/archive",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_emailer_campaigns_sequence_id_archive",
"method": "ANY",
"path": "/apis/v1/apollo/emailer_campaigns/{sequence_id}/archive"
},
"parameters": [
{
"name": "sequence_id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "Sequence ID."
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:94e1663e0669adaa3bded728593875c4f78a6cedb98427852645c0a4262a0d09"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-emailer-campaigns-sequence-id-archive"
}
},
"/apis/v1/apollo/emailer_messages/search": {
"get": {
"description": "Search for outreach emails. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_emailer_messages_search",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"emailer_messages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Outreach emails (when returned)."
},
"pagination": {
"type": "object",
"description": "Pagination metadata (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Search for Outreach Emails",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "ca78f0166a41"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/emailer_messages/search",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_emailer_messages_search",
"method": "ANY",
"path": "/apis/v1/apollo/emailer_messages/search"
},
"parameters": [
{
"name": "email_account_id_and_aliases",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Filter by email account and aliases."
},
{
"name": "emailer_campaign_ids[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Only include these sequence IDs."
},
{
"name": "emailer_message_reply_classes[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Filter by reply classes."
},
{
"name": "emailer_message_stats[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Filter by message stats (e.g., open, click)."
},
{
"name": "not_emailer_campaign_ids[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Exclude these sequence IDs."
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Page number."
},
{
"name": "per_page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Results per page."
},
{
"name": "user_ids[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Filter by user IDs."
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:196f05db7e420b16f773463af71c8550de29f4218ac836f55bbf48db98603aac"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-emailer-messages-search"
}
},
"/apis/v1/apollo/emailer_messages/{id}/activities": {
"get": {
"description": "Check email stats for a specific outreach email. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_emailer_messages_id_activities",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"emailer_message": {
"type": "object",
"description": "Email object (when returned)."
},
"activities": {
"type": "array",
"items": {
"type": "string"
},
"description": "Activity events (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Check Email Stats",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "2ac7981241ee"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/emailer_messages/{id}/activities",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_emailer_messages_id_activities",
"method": "ANY",
"path": "/apis/v1/apollo/emailer_messages/{id}/activities"
},
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "Emailer message ID."
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:8ea33aecc718e3981106b0b615b8a7006415d6b1119d8cbceecb5f33677268af"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-emailer-messages-id-activities"
}
},
"/apis/v1/apollo/fields": {
"get": {
"description": "Get a list of fields. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_fields",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Field definitions (when returned)."
}
}
}
}
}
},
"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",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "c54be117335c"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/fields",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_fields",
"method": "ANY",
"path": "/apis/v1/apollo/fields"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:6fdc4268c35253f368ecec0d72600008a9c7db4d8e8b68ea177fb69f39080242"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-fields"
},
"post": {
"description": "Get a list of fields. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_fields",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"typed_custom_fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Created field(s) (when returned)."
}
}
}
}
}
},
"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",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "c54be117335c"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/fields",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_fields",
"method": "ANY",
"path": "/apis/v1/apollo/fields"
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "Name of the custom field you want to create. Example: `Test Name`"
},
"modality": {
"type": "string",
"description": "The modality of the custom field you want to create. Example: `contact`",
"enum": [
"contact",
"account",
"opportunity"
]
},
"type": {
"type": "string",
"description": "What kind of custom field you want to create. Example: `textarea`",
"enum": [
"string",
"textarea",
"number",
"date",
"datetime",
"boolean"
]
},
"meta": {
"type": "object",
"properties": {
"max_length": {
"type": "number"
}
}
}
}
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:3f54e177b12e8bd94d3679845152cecf81a8680027c03ea1014dad1fa85395a0"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-fields"
}
},
"/apis/v1/apollo/labels": {
"get": {
"description": "Get a list of all lists (labels). Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_labels",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"[]": {
"type": "array",
"items": {
"type": "string"
},
"description": "List objects (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Get a List of All Lists",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "20baefe1a96b"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/labels",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_labels",
"method": "ANY",
"path": "/apis/v1/apollo/labels"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:8486d4434b6bbc5e4728ff013d13a8894b38f756f016fcb252a080a215c8b522"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-labels"
}
},
"/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\nUsage-based billing; Default request estimate: $0.01975 USD (not a fixed price). Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_mixed_companies_search",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"breadcrumbs": {
"type": "array",
"items": {
"type": "string"
},
"description": "Response array"
},
"partial_results_only": {
"type": "boolean",
"description": "Response field"
},
"has_join": {
"type": "boolean",
"description": "Response field"
},
"disable_eu_prospecting": {
"type": "boolean",
"description": "Response field"
},
"partial_results_limit": {
"type": "integer",
"description": "Response field"
},
"pagination": {
"type": "object",
"description": "Response object"
},
"accounts": {
"type": "array",
"items": {
"type": "string"
},
"description": "Response array"
},
"organizations": {
"type": "array",
"items": {
"type": "string"
},
"description": "Response array"
},
"model_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Response array"
},
"num_fetch_result": {
"type": "string",
"description": "Response field"
},
"derived_params": {
"type": "string",
"description": "Response field"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Organization Search",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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": {
"kind": "plan_units",
"formula": {
"fixed_units": 1
},
"inputs": []
},
"unit": "provider_credit",
"unit_rate_usd": 0.0
},
"x-aisa-query-policy": {
"ignore_undeclared": false,
"request_wins": true
},
"x-aisa-revision": {
"customer_pricing_ref": "dd7f50354676",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "85473a16cd94"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/mixed_companies/search",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_mixed_companies_search",
"method": "ANY",
"path": "/apis/v1/apollo/mixed_companies/search"
},
"parameters": [
{
"name": "currently_using_any_of_technology_uids[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Find organizations based on the technologies they currently use. Apollo supports filtering by 1,500+ technologies. Apollo calculates technologies data from multiple sources. This data is updated regularly. Check out the full list of supported technologies by downloading this CSV file . Use underscores (_) to replace spaces and periods for the technologies listed in the CSV file. Examples: salesforce; google_analytics; wordpress_org"
},
{
"name": "latest_funding_amount_range[max]",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "The maximium amount the company received with its most recent funding round. Use this parameter in combination with latest_funding_amount_range[min] to set a monetary range for the company's most recent funding round. Do not enter currency symbols, commas, or decimal points in the figure. Examples: 5000000; 15000000"
},
{
"name": "latest_funding_amount_range[min]",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "The minimum amount the company received with its most recent funding round. Use this parameter in combination with latest_funding_amount_range[max] to set a monetary range for the company's most recent funding round. Do not enter currency symbols, commas, or decimal points in the figure. Examples: 5000000; 15000000"
},
{
"name": "latest_funding_date_range[max]",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "The latest date when the company received its most recent funding round. Use this parameter in combination with latest_funding_date_range[min] to set a date range for when the company received its most recent funding round. Example: 2025-09-25"
},
{
"name": "latest_funding_date_range[min]",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "The earliest date when the company received its most recent funding round. Use this parameter in combination with latest_funding_date_range[max] to set a date range for when the company received its most recent funding round. Example: 2025-07-25"
},
{
"name": "organization_ids[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The Apollo IDs for the companies you want to include in your search results. Each company in the Apollo database is assigned a unique ID. To find IDs, identify the values for organization_id when you call this endpoint. Example: 5e66b6381e05b4008c8331b8"
},
{
"name": "organization_job_locations[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The locations of the jobs being actively recruited by the company. Examples: atlanta; japan"
},
{
"name": "organization_job_posted_at_range[max]",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "The latest date when jobs were posted by the company. Use this parameter in combination with organization_job_posted_at_range[min] to set a date range for when jobs posted. Example: 2025-09-25"
},
{
"name": "organization_job_posted_at_range[min]",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "The earliest date when jobs were posted by the company. Use this parameter in combination with organization_job_posted_at_range[max] to set a date range for when jobs posted. Example: 2025-07-25"
},
{
"name": "organization_locations[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The location of the company headquarters. You can search across cities, US states, and countries. If a company has several office locations, results are still based on the headquarters location. For example, if you search chicago but a company's HQ location is in boston, any Boston-based companies will not appearch in your search results, even if they match other parameters.. To exclude companies based on location, use the organization_not_locations parameter. Examples: texas; tokyo; spain"
},
{
"name": "organization_not_locations[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Exclude companies from search results based on the location of the company headquarters. You can use cities, US states, and countries as locations to exclude. This parameter is useful for ensuring you do not prospect in an undesirable territory. For example, if you use ireland as a value, no Ireland-based companies will appear in your search results. Examples: minnesota; ireland; seoul"
},
{
"name": "organization_num_employees_ranges[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The number range of employees working for the company. This enables you to find companies based on headcount. You can add multiple ranges to expand your search results. Each range you add needs to be a string, with the upper and lower numbers of the range separated only by a comma. Examples: 1,10; 250,500; 10000,20000"
},
{
"name": "organization_num_jobs_range[max]",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "The maximum number of job postings active at the company. Use this parameter in combination with organization_num_jobs_range[min] to set a job postings range. Examples: 50; 500"
},
{
"name": "organization_num_jobs_range[min]",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "The minimum number of job postings active at the company. Use this parameter in combination with organization_num_jobs_range[max] to set a job postings range. Examples: 50; 500"
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"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 for navigable and improve the performance of the endpoint. Example: 4"
},
{
"name": "per_page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"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"
},
{
"name": "q_organization_domains_list[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The domain name for the person's employer. This can be the current employer or a previous employer. Do not include www., the @ symbol, or similar. This parameter accepts up to 1,000 domains in a single request. Examples: apollo.io; microsoft.com"
},
{
"name": "q_organization_job_titles[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The job titles that are listed in active job postings at the company. Examples: sales manager; research analyst"
},
{
"name": "q_organization_keyword_tags[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Filter search results based on keywords associated with companies. For example, you can enter mining as a value to return only companies that have an association with the mining industry. Examples: mining; sales strategy; consulting"
},
{
"name": "q_organization_name",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Filter search results to include a specific company name. If the value you enter for this parameter does not match with a company's name, the company will not appear in search results, even if it matches other parameters. Partial matches are accepted. For example, if you filter by the value marketing, a company called NY Marketing Unlimited would still be eligible as a search result, but NY Market Analysis would not be eligible. Example: apollo or mining"
},
{
"name": "revenue_range[max]",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Search for organizations based on their revenue. Use this parameter to set the upper range of organization revenue. Use the revenue_range[min] parameter to set the lower range of revenue. Do not enter currency symbols, commas, or decimal points in the figure. Example: 50000000"
},
{
"name": "revenue_range[min]",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Search for organizations based on their revenue. Use this parameter to set the lower range of organization revenue. Use the revenue_range[max] parameter to set the upper range of revenue. Do not enter currency symbols, commas, or decimal points in the figure. Example: 300000"
},
{
"name": "total_funding_range[max]",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "The maximum amount the company received during all of its funding rounds combined. Use this parameter in combination with total_funding_range[min] to set a monetary range for all of the company's funding rounds. Do not enter currency symbols, commas, or decimal points in the figure. Examples: 50000000; 350000000"
},
{
"name": "total_funding_range[min]",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "The minimum amount the company received during all of its funding rounds combined. Use this parameter in combination with total_funding_range[max] to set a monetary range for all of the company's funding rounds. Do not enter currency symbols, commas, or decimal points in the figure. Examples: 50000000; 350000000"
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:1f45818067049a6b7dc82cdd0ee0b61bc76df6942634a91aa84a15432ab995ae"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-mixed-companies-search"
}
},
"/apis/v1/apollo/mixed_people/api_search": {
"post": {
"description": "Use the People API Search endpoint to find net new people in the Apollo database. Several filters are available to help narrow your search. This endpoint is optimized for API usage and does not consume credits. This endpoint is primarily designed for prospecting net new people. This endpoint does not return email addresses or phone numbers. Use the People Enrichment or Bulk People Enrichment endpoints to enrich data. This endpoint requires a master API key. Refer to Create API Keys to learn how to create a master API key. To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible. This limitation does not restrict your access to Apollo's database; you just need to access the data in batches.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_mixed_people_api_search",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"total_entries": {
"type": "integer",
"description": "Response field"
},
"people": {
"type": "array",
"items": {
"type": "string"
},
"description": "Response array"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "People API Search",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "1ecb8de294fc"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/mixed_people/api_search",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_mixed_people_api_search",
"method": "ANY",
"path": "/apis/v1/apollo/mixed_people/api_search"
},
"parameters": [
{
"name": "contact_email_status[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The email statuses for the people you want to find. You can add multiple statuses to expand your search. The statuses you can search include: verified unverified likely to engage unavailable"
},
{
"name": "currently_not_using_any_of_technology_uids[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Exclude people from your search based on any of the technologies their current employer uses. Apollo supports filtering by 1,500+ technologies. Apollo calculates technologies data from multiple sources. This data is updated regularly. Check out the full list of supported technologies by downloading this CSV file . Use underscores (_) to replace spaces and periods for the technologies listed in the CSV file. Examples: salesforce; google_analytics; wordpress_org"
},
{
"name": "currently_using_all_of_technology_uids[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Find people based on all of the technologies their current employer uses. Apollo supports filtering by 1,500+ technologies. Apollo calculates technologies data from multiple sources. This data is updated regularly. Check out the full list of supported technologies by downloading this CSV file . Use underscores (_) to replace spaces and periods for the technologies listed in the CSV file. Examples: salesforce; google_analytics; wordpress_org"
},
{
"name": "currently_using_any_of_technology_uids[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Find people based on any of the technologies their current employer uses. Apollo supports filtering by 1,500+ technologies. Apollo calculates technologies data from multiple sources. This data is updated regularly. Check out the full list of supported technologies by downloading this CSV file . Use underscores (_) to replace spaces and periods for the technologies listed in the CSV file. Examples: salesforce; google_analytics; wordpress_org"
},
{
"name": "include_similar_titles",
"in": "query",
"required": false,
"schema": {
"type": "boolean"
},
"description": "This parameter determines whether people with job titles similar to the titles you define in the person_titles[] parameter are returned in the response. Set this parameter to false when using person_titles[] to return only strict matches for job titles."
},
{
"name": "organization_ids[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The Apollo IDs for the companies (employers) you want to include in your search results. 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"
},
{
"name": "organization_job_locations[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The locations of the jobs being actively recruited by the person's employer. Examples: atlanta; japan"
},
{
"name": "organization_job_posted_at_range[max]",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "The latest date when jobs were posted by the person's current employer. Use this parameter in combination with organization_job_posted_at_range[min] to set a date range for when jobs posted. Example: 2025-09-25"
},
{
"name": "organization_job_posted_at_range[min]",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "The earliest date when jobs were posted by the person's current employer. Use this parameter in combination with organization_job_posted_at_range[max] to set a date range for when jobs posted. Example: 2025-07-25"
},
{
"name": "organization_locations[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The location of the company headquarters for a person's current employer. You can search across cities, US states, and countries. If a company has several office locations, results are still based on the headquarters location. For example, if you search chicago but a company's HQ location is in boston, people that work for the Boston-based company will not appear in your results, even if they match other parameters. To find people based on their personal location, use the person_locations parameter. Examples: texas; tokyo; spain"
},
{
"name": "organization_num_employees_ranges[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The number range of employees working for the person's current company. This enables you to find people based on the headcount of their employer. You can add multiple ranges to expand your search results. Each range you add needs to be a string, with the upper and lower numbers of the range separated only by a comma. Examples: 1,10; 250,500; 10000,20000"
},
{
"name": "organization_num_jobs_range[max]",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "The maximum number of job postings active at the person's current employer. Use this parameter in combination with organization_num_jobs_range[min] to set a job postings range. Examples: 50; 500"
},
{
"name": "organization_num_jobs_range[min]",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "The minimum number of job postings active at the person's current employer. Use this parameter in combination with organization_num_jobs_range[max] to set a job postings range. Examples: 50; 500"
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"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 for navigable and improve the performance of the endpoint. Example: 4"
},
{
"name": "per_page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"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"
},
{
"name": "person_locations[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The location where people live. You can search across cities, US states, and countries. To find people based on the headquarters locations of their current employer, use the organization_locations parameter. Examples: california; ireland; chicago"
},
{
"name": "person_seniorities[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The job seniority that people hold within their current employer. This enables you to find people that currently hold positions at certain reporting levels, such as Director level or senior IC level. For a person to be included in search results, they only need to match 1 of the seniorities you add. Adding more seniorities expands your search results. Searches only return results based on their current job title, so searching for Director-level employees only returns people that currently hold a Director-level title. If someone was previously a Director, but is currently a VP, they would not be included in your search results. Use this parameter in combination with the person_titles[] parameter to find people based on specific job functions and seniority levels. The following options can be used for this parameter: owner founder c_suite partner vp head director manager senior entry intern"
},
{
"name": "person_titles[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Job titles held by the people you want to find. For a person to be included in search results, they only need to match 1 of the job titles you add. Adding more job titles expands your search results. Results also include job titles with the same terms, even if they are not exact matches. For example, searching for marketing manager might return people with the job title content marketing manager. Use this parameter in combination with the person_seniorities[] parameter to find people based on specific job functions and seniority levels. Examples: sales development representative; marketing manager; research analyst"
},
{
"name": "q_keywords",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "A string of words over which we want to filter the results."
},
{
"name": "q_organization_domains_list[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The domain name for the person's employer. This can be the current employer or a previous employer. Do not include www., the @ symbol, or similar. This parameter accepts up to 1,000 domains in a single request. Examples: apollo.io; microsoft.com"
},
{
"name": "q_organization_job_titles[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The job titles that are listed in active job postings at the person's current employer. Examples: sales manager; research analyst"
},
{
"name": "revenue_range[max]",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "The maximum revenue the person's current employer generates. Use this parameter in combination with revenue_range[min] to set a revenue range. Do not enter currency symbols, commas, or decimal points in the figure. Examples: 500000; 1500000"
},
{
"name": "revenue_range[min]",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "The minimum revenue the person's current employer generates. Use this parameter in combination with revenue_range[max] to set a revenue range. Do not enter currency symbols, commas, or decimal points in the figure. Examples: 500000; 1500000"
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:08ddce7098c773abc6b4b27451fdcb73ad2ef835516913c5256323218e8aa1e8"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-mixed-people-api-search"
}
},
"/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\nUsage-based billing; Default request estimate: $0.01975 USD (not a fixed price). Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_news_articles_search",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"pagination": {
"type": "object",
"description": "Response object"
},
"news_articles": {
"type": "array",
"items": {
"type": "string"
},
"description": "Response array"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "News Articles Search",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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": {
"kind": "plan_units",
"formula": {
"fixed_units": 1
},
"inputs": []
},
"unit": "provider_credit",
"unit_rate_usd": 0.0
},
"x-aisa-query-policy": {
"ignore_undeclared": false,
"request_wins": true
},
"x-aisa-revision": {
"customer_pricing_ref": "dd7f50354676",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "257b8e819ad7"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/news_articles/search",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_news_articles_search",
"method": "ANY",
"path": "/apis/v1/apollo/news_articles/search"
},
"parameters": [
{
"name": "categories[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Filter your search to include only certain categories or sub-categories of news. Use the News search filter for companies within Apollo to uncover all possible categories and sub-categories. Examples: hires; investment; contract"
},
{
"name": "organization_ids[]",
"in": "query",
"required": true,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The Apollo IDs for the companies you want to include in your search results. 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"
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"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 for navigable and improve the performance of the endpoint. Example: 4"
},
{
"name": "per_page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"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"
},
{
"name": "published_at[max]",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Set the upper bound of the date range you want to search. Use this parameter in combination with the published_at[min] parameter. This date should fall after the published_at[min] date. The date should be formatted as YYYY-MM-DD. Example: 2025-05-15"
},
{
"name": "published_at[min]",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Set the lower bound of the date range you want to search. Use this parameter in combination with the published_at[max] parameter. This date should fall before the published_at[max] date. The date should be formatted as YYYY-MM-DD. Example: 2025-02-15"
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:690317cf0435061d76d0543a41ec7b8deac6b156fa7555cd95c420dee2770afa"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-news-articles-search"
}
},
"/apis/v1/apollo/notes": {
"get": {
"description": "Get a list of notes. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_notes",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"notes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Notes (when returned)."
},
"pagination": {
"type": "object",
"description": "Pagination metadata (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Get a List of Notes",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "e65c63c8eb8f"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/notes",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_notes",
"method": "ANY",
"path": "/apis/v1/apollo/notes"
},
"parameters": [
{
"name": "account_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"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\"."
},
{
"name": "calendar_event_id",
"in": "query",
"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\"."
},
{
"name": "contact_id",
"in": "query",
"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\"."
},
{
"name": "contact_ids",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"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\"."
},
{
"name": "conversation_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"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\"."
},
{
"name": "conversation_ids",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"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\"."
},
{
"name": "opportunity_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"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\"."
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"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\"."
},
{
"name": "per_page",
"in": "query",
"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\"."
},
{
"name": "start_date",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"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\"."
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:73d236ae796a8952f34d241eec1ce6b8cefb8d62b2f32786b2da7b0ec65738f5"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-notes"
}
},
"/apis/v1/apollo/opportunities": {
"post": {
"description": "Create a deal (opportunity). Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_opportunities",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"opportunity": {
"type": "object",
"description": "Created opportunity",
"additionalProperties": true
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Create Deal",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "f1307a28b15a"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/opportunities",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_opportunities",
"method": "ANY",
"path": "/apis/v1/apollo/opportunities"
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Name the deal you are creating. This should be a human-readable name.
Example: `Massive Q3 Deal`"
},
"owner_id": {
"type": "string",
"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`"
},
"account_id": {
"type": "string",
"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`"
},
"amount": {
"type": "string",
"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)"
},
"opportunity_stage_id": {
"type": "string",
"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`"
},
"closed_date": {
"type": "string",
"format": "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`"
},
"typed_custom_fields": {
"type": "object",
"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\"}`",
"additionalProperties": {
"type": "string"
},
"example": {
"60c39ed82bd02f01154c470a": "2025-08-07"
}
}
}
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:9660b5489f920f328232720d6a9d192f195dd5e91e2f0276622905b4014a5b83"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-opportunities"
}
},
"/apis/v1/apollo/opportunities/search": {
"get": {
"description": "List all deals (opportunities). Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_opportunities_search",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"opportunities": {
"type": "string",
"description": "Opportunities list"
},
"opportunities[].id": {
"type": "string",
"description": "Opportunity ID"
},
"opportunities[].owner_id": {
"type": "string",
"description": "Owner ID"
},
"opportunities[].account_id": {
"type": "string",
"description": "Account ID"
},
"opportunities[].amount": {
"type": "number",
"description": "Amount"
},
"opportunities[].name": {
"type": "string",
"description": "Name"
},
"opportunities[].opportunity_stage_id": {
"type": "string",
"description": "Stage ID"
},
"opportunities[].is_closed": {
"type": "boolean",
"description": "Is closed"
},
"opportunities[].is_won": {
"type": "boolean",
"description": "Is won"
},
"opportunities[].created_at": {
"type": "string",
"description": "Created timestamp"
},
"pagination": {
"type": "object",
"description": "Pagination object"
},
"pagination.page": {
"type": "integer",
"description": "Page number"
},
"pagination.per_page": {
"type": "integer",
"description": "Items per page"
},
"pagination.total_entries": {
"type": "integer",
"description": "Total entries"
},
"pagination.total_pages": {
"type": "integer",
"description": "Total pages"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "List All Deals",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "546b2f93deac"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/opportunities/search",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_opportunities_search",
"method": "ANY",
"path": "/apis/v1/apollo/opportunities/search"
},
"parameters": [
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Page number"
},
{
"name": "per_page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Items per page"
},
{
"name": "sort_by_field",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Sort field"
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:5729bb495a1e76ad490d4d5ccc0b75255537d9500f75675aeeb7289910c18b02"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-opportunities-search"
}
},
"/apis/v1/apollo/opportunities/{opportunity_id}": {
"get": {
"description": "View a deal (opportunity) by ID. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_opportunities_opportunity_id",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"opportunity": {
"type": "object",
"description": "Opportunity object"
},
"opportunity.id": {
"type": "string",
"description": "Opportunity ID"
},
"opportunity.owner_id": {
"type": "string",
"description": "Owner ID"
},
"opportunity.account_id": {
"type": "string",
"description": "Account ID"
},
"opportunity.amount": {
"type": "number",
"description": "Amount"
},
"opportunity.name": {
"type": "string",
"description": "Name"
},
"opportunity.opportunity_stage_id": {
"type": "string",
"description": "Stage ID"
},
"opportunity.is_closed": {
"type": "boolean",
"description": "Is closed"
},
"opportunity.is_won": {
"type": "boolean",
"description": "Is won"
},
"opportunity.created_at": {
"type": "string",
"description": "Created timestamp"
}
}
}
}
}
},
"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",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "6b7c5496f6f4"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/opportunities/{opportunity_id}",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_opportunities_opportunity_id",
"method": "ANY",
"path": "/apis/v1/apollo/opportunities/{opportunity_id}"
},
"parameters": [
{
"name": "opportunity_id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "Opportunity ID"
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:97549b29b88b7b563c41b8968d653958327d4168689404a79361f99bce152dd5"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-opportunities-opportunity-id"
},
"patch": {
"description": "View a deal (opportunity) by ID. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "patch_apollo_opportunities_opportunity_id",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"opportunity": {
"type": "object",
"description": "Updated opportunity",
"additionalProperties": true
}
}
}
}
}
},
"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",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "6b7c5496f6f4"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/opportunities/{opportunity_id}",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_opportunities_opportunity_id",
"method": "ANY",
"path": "/apis/v1/apollo/opportunities/{opportunity_id}"
},
"parameters": [
{
"name": "opportunity_id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "Opportunity ID"
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"owner_id": {
"type": "string",
"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`"
},
"name": {
"type": "string",
"description": "Update the name of the deal. This should be a human-readable name.
Example: `Massive Q3 Deal`"
},
"amount": {
"type": "string",
"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)"
},
"opportunity_stage_id": {
"type": "string",
"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`"
},
"closed_date": {
"type": "string",
"format": "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`"
},
"typed_custom_fields": {
"type": "object",
"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\"}`",
"additionalProperties": {
"type": "string"
},
"example": {
"60c39ed82bd02f01154c470a": "2025-08-07"
}
}
}
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:057cec5799be2f45d3130f7f5883b4d3b5e92a3ed693d1e65911bc2590c70315"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/patch_apollo-opportunities-opportunity-id"
}
},
"/apis/v1/apollo/opportunity_stages": {
"get": {
"description": "List deal stages (opportunity stages). Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_opportunity_stages",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"opportunity_stages": {
"type": "string",
"description": "Opportunity stages list"
},
"opportunity_stages[].id": {
"type": "string",
"description": "Stage ID"
},
"opportunity_stages[].team_id": {
"type": "string",
"description": "Team ID"
},
"opportunity_stages[].name": {
"type": "string",
"description": "Name"
},
"opportunity_stages[].display_order": {
"type": "integer",
"description": "Display order"
},
"opportunity_stages[].forecast_category_cd": {
"type": "string",
"description": "Forecast category code"
},
"opportunity_stages[].is_won": {
"type": "boolean",
"description": "Is won"
},
"opportunity_stages[].is_closed": {
"type": "boolean",
"description": "Is closed"
},
"opportunity_stages[].probability": {
"type": "number",
"description": "Probability"
},
"opportunity_stages[].description": {
"type": "string",
"description": "Description"
},
"opportunity_stages[].opportunity_pipeline_id": {
"type": "string",
"description": "Opportunity pipeline ID"
},
"opportunity_stages[].type": {
"type": "string",
"description": "Type"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "List Deal Stages",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "12970000620b"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/opportunity_stages",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_opportunity_stages",
"method": "ANY",
"path": "/apis/v1/apollo/opportunity_stages"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:9eec6c1baffdfc121cc9b273a46fc5453a666de4eaad09172c01f628738ce5db"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-opportunity-stages"
}
},
"/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\nUsage-based billing; Default request estimate: $0.1975 USD (not a fixed price). Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_organizations_bulk_enrich",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Response field"
},
"error_code": {
"type": "string",
"description": "Response field"
},
"error_message": {
"type": "string",
"description": "Response field"
},
"total_requested_domains": {
"type": "integer",
"description": "Response field"
},
"unique_domains": {
"type": "integer",
"description": "Response field"
},
"unique_enriched_records": {
"type": "integer",
"description": "Response field"
},
"missing_records": {
"type": "integer",
"description": "Response field"
},
"organizations": {
"type": "array",
"items": {
"type": "string"
},
"description": "Response array"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Bulk Organization Enrichment",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "dd7f50354676",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "2750fcc5c11e"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/organizations/bulk_enrich",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_organizations_bulk_enrich",
"method": "ANY",
"path": "/apis/v1/apollo/organizations/bulk_enrich"
},
"parameters": [
{
"name": "domains[]",
"in": "query",
"required": true,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "The domain of each company that you want to enrich. Do not include www., the @ symbol, or similar. Example: apollo.io and microsoft.com"
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:34cd913109840173288457860b98874e42a20695acdb78696d39e79571a11a97"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-organizations-bulk-enrich"
}
},
"/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\nUsage-based billing; Default request estimate: $0.01975 USD (not a fixed price). Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_organizations_enrich",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"organization": {
"type": "object",
"description": "Response object"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Organization Enrichment",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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": {
"kind": "plan_units",
"formula": {
"fixed_units": 1
},
"inputs": []
},
"unit": "provider_credit",
"unit_rate_usd": 0.0
},
"x-aisa-query-policy": {
"ignore_undeclared": false,
"request_wins": true
},
"x-aisa-revision": {
"customer_pricing_ref": "dd7f50354676",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "5fb0090dbb38"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/organizations/enrich",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_organizations_enrich",
"method": "ANY",
"path": "/apis/v1/apollo/organizations/enrich"
},
"parameters": [
{
"name": "domain",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "The domain of the company that you want to enrich. Do not include www., the @ symbol, or similar. Example: apollo.io or microsoft.com"
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:5cea0efc1bf053916f6f5a3d31677ad11c5b364aab24a45ac629edf2e801e2ec"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-organizations-enrich"
}
},
"/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\nUsage-based billing; Default request estimate: $0.01975 USD (not a fixed price). Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_organizations_id",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"organization": {
"type": "object",
"description": "Response object"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Get Complete Organization Info",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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": {
"kind": "plan_units",
"formula": {
"fixed_units": 1
},
"inputs": []
},
"unit": "provider_credit",
"unit_rate_usd": 0.0
},
"x-aisa-query-policy": {
"ignore_undeclared": false,
"request_wins": true
},
"x-aisa-revision": {
"customer_pricing_ref": "dd7f50354676",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "977a7bd8437c"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/organizations/{id}",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_organizations_id",
"method": "ANY",
"path": "/apis/v1/apollo/organizations/{id}"
},
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "The Apollo ID for the organization that you want to research. To find organization IDs, call the Organization Search endpoint and identify the organizaton_id value for the organization. Example: 5e66b6381e05b4008c8331b8"
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:5cea0efc1bf053916f6f5a3d31677ad11c5b364aab24a45ac629edf2e801e2ec"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-organizations-id"
}
},
"/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\nUsage-based billing; Default request estimate: $0.01975 USD (not a fixed price). Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_organizations_organization_id_job_postings",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"organization_job_postings": {
"type": "array",
"items": {
"type": "string"
},
"description": "Response array"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Organization Job Postings",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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": {
"kind": "plan_units",
"formula": {
"fixed_units": 1
},
"inputs": []
},
"unit": "provider_credit",
"unit_rate_usd": 0.0
},
"x-aisa-query-policy": {
"ignore_undeclared": false,
"request_wins": true
},
"x-aisa-revision": {
"customer_pricing_ref": "dd7f50354676",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "0c80c8c2dfa4"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/organizations/{organization_id}/job_postings",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_organizations_organization_id_job_postings",
"method": "ANY",
"path": "/apis/v1/apollo/organizations/{organization_id}/job_postings"
},
"parameters": [
{
"name": "organization_id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "The organization ID of the company for which you want to find job postings. 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"
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"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 for navigable and improve the performance of the endpoint. Example: 4"
},
{
"name": "per_page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"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"
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:1e98904de06a156205e936b43186b6f50fdfbdbd4fa6087e536caf45a5223652"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-organizations-organization-id-job-postings"
}
},
"/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\nUsage-based billing; Default request estimate: $1.7775 USD (not a fixed price). Declared unit rate: $0 USD per provider_credit. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_people_bulk_match",
"parameters": [
{
"examples": {
"default": {
"value": false
}
},
"in": "query",
"name": "reveal_phone_number",
"required": false,
"schema": {
"default": false,
"type": "boolean"
},
"description": "Set to true if you want to enrich the data of all matched people with all available phone numbers, including mobile phone numbers. This potentially consumes credits as part of your Apollo pricing plan . The default value is false. If this parameter is set to true, you must enter a webhook URL for the webhook_url parameter. Apollo will asynchronously verify phone numbers for you, then send a JSON response that includes only details about the phone numbers to the webhook URL you provide. It can take several minutes for the phone numbers to be delivered."
},
{
"examples": {
"default": {
"value": false
}
},
"in": "query",
"name": "run_waterfall_email",
"required": false,
"schema": {
"default": false,
"type": "boolean"
},
"description": "Set to true to enable email waterfall enrichment"
},
{
"examples": {
"default": {
"value": false
}
},
"in": "query",
"name": "run_waterfall_phone",
"required": false,
"schema": {
"default": false,
"type": "boolean"
},
"description": "Set to true to enable phone waterfall enrichment"
},
{
"in": "query",
"name": "webhook_url",
"required": false,
"schema": {
"format": "https_url",
"maxLength": 2048,
"minLength": 1,
"type": "string"
},
"description": "If you set the reveal_phone_number parameter to true, this parameter becomes mandatory. Otherwise, do not use this parameter. Enter the webhook URL that specifies where Apollo should send a JSON response that includes the phone number you requested. Apollo suggests testing this flow to ensure you receive the separate response with the phone number. If phone numbers are not revealed delivered to the webhook URL, try applying UTF-8 encoding to the webhook URL. Example: https://webhook.site/cc4cf44e-e047-4774-8dac-473d28474e40; https%3A%2F%2Fwebhook.site%2Fcc4cf44e-e047-4774-8dac-473d28474e40"
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"status": {
"type": "string",
"description": "Response field"
},
"error_code": {
"type": "string",
"description": "Response field"
},
"error_message": {
"type": "string",
"description": "Response field"
},
"total_requested_enrichments": {
"type": "integer",
"description": "Response field"
},
"unique_enriched_records": {
"type": "integer",
"description": "Response field"
},
"missing_records": {
"type": "integer",
"description": "Response field"
},
"credits_consumed": {
"type": "integer",
"description": "Response field"
},
"matches": {
"type": "array",
"items": {
"type": "string"
},
"description": "Response array"
},
"waterfall": {
"type": "object",
"description": "Response object"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Bulk People Enrichment",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"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-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-revision": {
"customer_pricing_ref": "d10d440e9796",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "99241d7c699e"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/people/bulk_match",
"x-aisa-validation": "mixed",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_people_bulk_match",
"method": "ANY",
"path": "/apis/v1/apollo/people/bulk_match"
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"details": {
"type": "array",
"items": {
"type": "object",
"description": "One person to enrich. Give whatever identifiers you have — the more, the likelier the match.",
"properties": {
"first_name": {
"type": "string",
"description": "First name, used with last_name. Example: tim"
},
"last_name": {
"type": "string",
"description": "Last name, used with first_name. Example: zheng"
},
"name": {
"type": "string",
"description": "Full name, e.g. \"tim zheng\"; replaces first_name + last_name."
},
"email": {
"type": "string",
"description": "Email address of the person."
},
"hashed_email": {
"type": "string",
"description": "MD5 or SHA-256 hash of the email address."
},
"organization_name": {
"type": "string",
"description": "Name of the person's employer. Example: apollo"
},
"domain": {
"type": "string",
"description": "Domain of the person's employer, without www. Example: apollo.io"
},
"id": {
"type": "string",
"description": "Apollo person id, e.g. from a people search."
},
"linkedin_url": {
"type": "string",
"description": "LinkedIn profile URL of the person."
}
}
},
"description": "Provide info for each person you want to enrich as an object within this array. Add up to 10 people."
},
"reveal_personal_emails": {
"type": "boolean",
"description": "Set to true if you want to enrich all matched people with personal emails. This potentially consumes credits as part of your Apollo pricing plan . The default value is false. If a person resides in a GDPR -compliant region, Apollo will not reveal their personal email."
}
},
"required": [
"details"
]
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:9dd58fde99c92aef856ad0f47b70d50086b0c7eff9baa8f3148006399f9b2a71"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-people-bulk-match"
}
},
"/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\nPublished reference price: $0.01975 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_people_match",
"parameters": [
{
"examples": {
"default": {
"value": false
}
},
"in": "query",
"name": "reveal_phone_number",
"required": false,
"schema": {
"default": false,
"type": "boolean"
},
"description": "Set to true if you want to enrich the person's data with all available phone numbers, including mobile phone numbers. This potentially consumes credits as part of your Apollo pricing plan . The default value is false. If this parameter is set to true, you must enter a webhook URL for the webhook_url parameter. Apollo will asynchronously verify phone numbers for you, then send a JSON response that includes only details about the person's phone numbers to the webhook URL you provide. It can take several minutes for the phone numbers to be delivered."
},
{
"examples": {
"default": {
"value": false
}
},
"in": "query",
"name": "run_waterfall_email",
"required": false,
"schema": {
"default": false,
"type": "boolean"
},
"description": "Set to true to enable email waterfall enrichment"
},
{
"examples": {
"default": {
"value": false
}
},
"in": "query",
"name": "run_waterfall_phone",
"required": false,
"schema": {
"default": false,
"type": "boolean"
},
"description": "Set to true to enable phone waterfall enrichment"
},
{
"in": "query",
"name": "webhook_url",
"required": false,
"schema": {
"format": "https_url",
"maxLength": 2048,
"minLength": 1,
"type": "string"
},
"description": "If you set the reveal_phone_number parameter to true, this parameter becomes mandatory. Otherwise, do not use this parameter. Enter the webhook URL that specifies where Apollo should send a JSON response that includes the phone number you requested. Apollo suggests testing this flow to ensure you receive the separate response with the phone number. If phone numbers are not revealed delivered to the webhook URL, try applying UTF-8 encoding to the webhook URL. Example: https://webhook.site/cc4cf44e-e047-4774-8dac-473d28474e40; https%3A%2F%2Fwebhook.site%2Fcc4cf44e-e047-4774-8dac-473d28474e40"
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"person": {
"type": "object",
"description": "Response object"
},
"waterfall": {
"type": "object",
"description": "Response object"
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "People Enrichment",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"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-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-revision": {
"customer_pricing_ref": "d7af3fddf48b",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "8b83f4a4d426"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/people/match",
"x-aisa-validation": "mixed",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_people_match",
"method": "ANY",
"path": "/apis/v1/apollo/people/match"
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"description": "Identify one person. Give at least one identifier; the more you supply, the likelier the match.",
"minProperties": 1,
"properties": {
"first_name": {
"type": "string",
"description": "The first name of the person. This is typically used in combination with the last_name parameter. Example: tim"
},
"last_name": {
"type": "string",
"description": "The last name of the person. This is typically used in combination with the first_name parameter. Example: zheng"
},
"name": {
"type": "string",
"description": "The full name of the person. This will typically be a first name and last name separated by a space. If you use this parameter, you do not need to use the first_name and last_name parameters. Example: tim zheng"
},
"email": {
"type": "string",
"description": "The email address of the person. Example: example@email.com"
},
"hashed_email": {
"type": "string",
"description": "The hashed email of the person. The email should adhere to either the MD5 or SHA-256 hash format. Example: 8d935115b9ff4489f2d1f9249503cadf (MD5) or 97817c0c49994eb500ad0a5e7e2d8aed51977b26424d508f66e4e8887746a152 (SHA-256)"
},
"organization_name": {
"type": "string",
"description": "The name of the person's employer. This can be the current employer or a previous employer. Example: apollo"
},
"domain": {
"type": "string",
"description": "The domain name for the person's employer. This can be the current employer or a previous employer. Do not include www., the @ symbol, or similar. Example: apollo.io or microsoft.com"
},
"id": {
"type": "string",
"description": "The Apollo ID for the person. Each person in the Apollo database is assigned a unique ID. To find IDs, call the People API Search endpoint and identify the values for person_id. Example: 587cf802f65125cad923a266"
},
"linkedin_url": {
"type": "string",
"description": "The URL for the person's LinkedIn profile. Example: http://www.linkedin.com/in/tim-zheng-677ba010"
},
"reveal_personal_emails": {
"type": "boolean",
"description": "Set to true if you want to enrich the person's data with personal emails. This potentially consumes credits as part of your Apollo pricing plan . The default value is false. If a person resides in a GDPR -compliant region, Apollo will not reveal their personal email."
}
},
"anyOf": [
{
"required": [
"first_name"
],
"properties": {
"first_name": {
"type": "string",
"minLength": 1
}
}
},
{
"required": [
"last_name"
],
"properties": {
"last_name": {
"type": "string",
"minLength": 1
}
}
},
{
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
}
}
},
{
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"minLength": 1
}
}
},
{
"required": [
"hashed_email"
],
"properties": {
"hashed_email": {
"type": "string",
"minLength": 1
}
}
},
{
"required": [
"organization_name"
],
"properties": {
"organization_name": {
"type": "string",
"minLength": 1
}
}
},
{
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"minLength": 1
}
}
},
{
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1
}
}
},
{
"required": [
"linkedin_url"
],
"properties": {
"linkedin_url": {
"type": "string",
"minLength": 1
}
}
}
]
},
"example": {
"name": "tim zheng",
"domain": "apollo.io"
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:7fadde251ef476cd68e84646c8c1e05b0edda6294f57904448bc4f2a3f8c6c70"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-people-match"
}
},
"/apis/v1/apollo/phone_calls": {
"post": {
"description": "Create call records. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_phone_calls",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"phone_call": {
"type": "object",
"description": "Call record (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Create Call Records",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "b3e0eb13c5aa"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/phone_calls",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_phone_calls",
"method": "ANY",
"path": "/apis/v1/apollo/phone_calls"
},
"parameters": [
{
"name": "account_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Account ID."
},
{
"name": "contact_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Contact ID."
},
{
"name": "duration",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Duration in seconds."
},
{
"name": "end_time",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "ISO 8601 end time."
},
{
"name": "from_number",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Caller phone number."
},
{
"name": "logged",
"in": "query",
"required": false,
"schema": {
"type": "boolean"
},
"description": "Whether to create an individual record."
},
{
"name": "phone_call_outcome_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Outcome ID."
},
{
"name": "phone_call_purpose_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Purpose ID."
},
{
"name": "start_time",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "ISO 8601 start time."
},
{
"name": "status",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Call status."
},
{
"name": "to_number",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Dialed phone number."
},
{
"name": "user_id[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Caller user IDs."
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:20b81e0c919f2ce8023dbb7aecf36febd6a5764facb4414906af4808b5a14464"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-phone-calls"
}
},
"/apis/v1/apollo/phone_calls/search": {
"get": {
"description": "Search calls. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_phone_calls_search",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"phone_calls": {
"type": "array",
"items": {
"type": "string"
},
"description": "Calls (when returned)."
},
"pagination": {
"type": "object",
"description": "Pagination metadata (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Search for Calls",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "912915ce0d0c"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/phone_calls/search",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_phone_calls_search",
"method": "ANY",
"path": "/apis/v1/apollo/phone_calls/search"
},
"parameters": [
{
"name": "contact_label_ids[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Contact label IDs."
},
{
"name": "date_range[max]",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Upper bound for call date range (YYYY-MM-DD)."
},
{
"name": "date_range[min]",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Lower bound for call date range (YYYY-MM-DD)."
},
{
"name": "duration[max]",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Upper bound for duration (seconds)."
},
{
"name": "duration[min]",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Lower bound for duration (seconds)."
},
{
"name": "inbound",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Inbound or outbound."
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Page number."
},
{
"name": "per_page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Results per page."
},
{
"name": "phone_call_outcome_ids[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Outcome IDs."
},
{
"name": "phone_call_purpose_ids[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Purpose IDs."
},
{
"name": "q_keywords",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Keyword filter."
},
{
"name": "user_ids[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "User IDs."
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:0edd26c318e511a416d697c33f70ba395547391e86b8eafacef0180e2d07b999"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-phone-calls-search"
}
},
"/apis/v1/apollo/phone_calls/{id}": {
"put": {
"description": "Update call records. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "put_apollo_phone_calls_id",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"phone_call": {
"type": "object",
"description": "Updated call record (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Update Call Records",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "c6143a5cb2a5"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/phone_calls/{id}",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "put_apollo_phone_calls_id",
"method": "ANY",
"path": "/apis/v1/apollo/phone_calls/{id}"
},
"parameters": [
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"description": "Call record ID."
},
{
"name": "account_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Account ID."
},
{
"name": "contact_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Contact ID."
},
{
"name": "duration",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Duration in seconds."
},
{
"name": "end_time",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "ISO 8601 end time."
},
{
"name": "from_number",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Caller phone number."
},
{
"name": "logged",
"in": "query",
"required": false,
"schema": {
"type": "boolean"
},
"description": "Whether to create an individual record."
},
{
"name": "phone_call_outcome_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Outcome ID."
},
{
"name": "phone_call_purpose_id",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Purpose ID."
},
{
"name": "start_time",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "ISO 8601 start time."
},
{
"name": "status",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Call status."
},
{
"name": "to_number",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Dialed phone number."
},
{
"name": "user_id[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Caller user IDs."
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:a65b8a23d363087b2289b42491b7ae4dd54ea33f25dd9edd9037a4a558cd906e"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/put_apollo-phone-calls-id"
}
},
"/apis/v1/apollo/reports/sync_report": {
"post": {
"description": "Query analytics report. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_reports_sync_report",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"report": {
"type": "object",
"description": "Report result (shape depends on request)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Query Analytics Report",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "7d41c50d34d4"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/reports/sync_report",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_reports_sync_report",
"method": "ANY",
"path": "/apis/v1/apollo/reports/sync_report"
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"metrics",
"group_by",
"sorts",
"filters",
"group_by_totals_selected",
"pivot_group_by_totals_selected",
"date_ranges"
],
"properties": {
"metrics": {
"type": "array",
"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": {
"type": "object",
"required": [
"value",
"smart_datetime_reference",
"smart_user_id_reference"
],
"properties": {
"value": {
"type": "string",
"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."
},
"smart_datetime_reference": {
"type": "string",
"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"
},
"smart_user_id_reference": {
"type": "string",
"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"
},
"display_name": {
"type": "string",
"description": "Optional label override for this metric's column in the response."
}
}
}
},
"group_by": {
"type": "array",
"maxItems": 1,
"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": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The dimension name.
Example: smart_user_id"
},
"limit": {
"type": "integer",
"description": "Maximum number of dimension values to return."
}
}
}
},
"pivot_group_by": {
"type": "array",
"maxItems": 1,
"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": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The dimension name to pivot on.
Example: emailer_campaign_id"
},
"limit": {
"type": "integer",
"description": "Maximum number of pivot column values to return."
}
}
}
},
"sorts": {
"type": "array",
"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": {
"type": "object",
"required": [
"asc"
],
"properties": {
"asc": {
"type": "boolean",
"description": "Sort ascending (true) or descending (false)."
},
"metric": {
"type": "object",
"description": "Sort by a metric column. Provide the same structure as a metric entry in the metrics array.",
"properties": {
"value": {
"type": "string"
},
"smart_datetime_reference": {
"type": "string"
},
"smart_user_id_reference": {
"type": "string"
}
}
}
}
}
},
"filters": {
"type": "object",
"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": {
"smart_user_id": {
"type": "array",
"description": "Filter to specific team member IDs. Use \"current\" for the authenticated user.
Example: [\"current\"]",
"items": {
"type": "string"
}
},
"smart_subteam_id": {
"type": "array",
"description": "Filter to specific sub-team IDs.",
"items": {
"type": "string"
}
},
"emailer_campaign_ids": {
"type": "array",
"description": "Filter to specific sequence IDs.",
"items": {
"type": "string"
}
},
"contact_stage_ids": {
"type": "array",
"description": "Filter to specific contact stage IDs.",
"items": {
"type": "string"
}
},
"account_stage_ids": {
"type": "array",
"description": "Filter to specific account stage IDs.",
"items": {
"type": "string"
}
},
"opportunity_stage_ids": {
"type": "array",
"description": "Filter to specific opportunity stage IDs.",
"items": {
"type": "string"
}
},
"email_account_ids": {
"type": "array",
"description": "Filter to specific sender mailbox IDs.",
"items": {
"type": "string"
}
},
"smart_datetime_range": {
"type": "object",
"description": "Required when date_ranges[].modality is custom_range. Specifies the exact date window as ISO 8601 date strings.",
"required": [
"min",
"max"
],
"properties": {
"min": {
"type": "string",
"description": "Start date (inclusive). Format: YYYY-MM-DD.
Example: 2024-01-01"
},
"max": {
"type": "string",
"description": "End date (inclusive). Format: YYYY-MM-DD.
Example: 2024-03-31"
}
}
}
},
"additionalProperties": true
},
"group_by_totals_selected": {
"type": "boolean",
"description": "When true, the response includes an aggregated totals row in addition to the per-dimension-value rows."
},
"pivot_group_by_totals_selected": {
"type": "boolean",
"description": "When true, the pivot response includes an aggregated totals column in addition to the per-pivot-value columns."
},
"date_ranges": {
"type": "array",
"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": {
"type": "object",
"required": [
"modality"
],
"properties": {
"modality": {
"type": "string",
"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)."
}
}
},
"maxItems": 1
},
"skip_group_by_values": {
"type": "array",
"maxItems": 500,
"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"
}
},
"min_ratio_denominator": {
"type": "integer",
"default": 0,
"description": "Minimum denominator threshold for ratio metrics. Rows where the denominator falls below this value are excluded from ratio calculations."
}
}
},
"examples": {
"Flat totals — email performance": {
"value": {
"metrics": [
{
"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",
"smart_datetime_reference": "activity_datetime",
"smart_user_id_reference": "user_id"
}
],
"group_by": [],
"pivot_group_by": [],
"sorts": [],
"filters": {},
"group_by_totals_selected": false,
"pivot_group_by_totals_selected": false,
"date_ranges": [
{
"modality": "last_30_days"
}
]
}
},
"Grouped — email activity by user": {
"value": {
"metrics": [
{
"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",
"smart_datetime_reference": "activity_datetime",
"smart_user_id_reference": "user_id"
}
],
"group_by": [
{
"name": "smart_user_id"
}
],
"pivot_group_by": [],
"sorts": [
{
"metric": {
"value": "num_emails_sent",
"smart_datetime_reference": "activity_datetime",
"smart_user_id_reference": "user_id"
},
"asc": false
}
],
"filters": {},
"group_by_totals_selected": true,
"pivot_group_by_totals_selected": false,
"date_ranges": [
{
"modality": "current_month"
}
]
}
},
"Grouped — email volume by month": {
"value": {
"metrics": [
{
"value": "num_emails_sent",
"smart_datetime_reference": "activity_datetime",
"smart_user_id_reference": "user_id"
}
],
"group_by": [
{
"name": "smart_datetime_month"
}
],
"pivot_group_by": [],
"sorts": [],
"filters": {},
"group_by_totals_selected": false,
"pivot_group_by_totals_selected": false,
"date_ranges": [
{
"modality": "last_12_months"
}
]
}
},
"Pivot — emails sent by user x contact stage": {
"value": {
"metrics": [
{
"value": "num_emails_sent",
"smart_datetime_reference": "activity_datetime",
"smart_user_id_reference": "user_id"
}
],
"group_by": [
{
"name": "smart_user_id"
}
],
"pivot_group_by": [
{
"name": "contact_stage_id"
}
],
"sorts": [],
"filters": {},
"group_by_totals_selected": true,
"pivot_group_by_totals_selected": true,
"date_ranges": [
{
"modality": "last_30_days"
}
]
}
},
"Sorted — top 5 reps by reply rate": {
"value": {
"metrics": [
{
"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",
"smart_datetime_reference": "activity_datetime",
"smart_user_id_reference": "user_id"
}
],
"group_by": [
{
"name": "smart_user_id",
"limit": 5
}
],
"pivot_group_by": [],
"sorts": [
{
"metric": {
"value": "percent_emails_replied",
"smart_datetime_reference": "activity_datetime",
"smart_user_id_reference": "user_id"
},
"asc": false
}
],
"filters": {},
"group_by_totals_selected": false,
"pivot_group_by_totals_selected": false,
"date_ranges": [
{
"modality": "current_quarter"
}
]
}
},
"Custom date range — call activity for Q1": {
"value": {
"metrics": [
{
"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",
"smart_datetime_reference": "activity_datetime",
"smart_user_id_reference": "user_id"
}
],
"group_by": [
{
"name": "smart_user_id"
}
],
"pivot_group_by": [],
"sorts": [],
"filters": {
"smart_datetime_range": {
"min": "2024-01-01",
"max": "2024-03-31"
}
},
"group_by_totals_selected": true,
"pivot_group_by_totals_selected": false,
"date_ranges": [
{
"modality": "custom_range"
}
]
}
}
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:ae97effd45080a298065849aa857fbaf8a76f86a4b6351abf6a27424b8308caf"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-reports-sync-report"
}
},
"/apis/v1/apollo/tasks": {
"post": {
"description": "Create a task. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_tasks",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"task": {
"type": "object",
"description": "Created task (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Create a Task",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "b6cbc7704368"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/tasks",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_tasks",
"method": "ANY",
"path": "/apis/v1/apollo/tasks"
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"user_id",
"contact_id",
"type",
"status",
"due_at"
],
"properties": {
"user_id": {
"type": "string",
"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`"
},
"contact_id": {
"type": "string",
"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": {
"type": "string",
"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. - `call`: Call the contact.
- `outreach_manual_email`: Email the contact.
- `linkedin_step_connect`: Send a LinkedIn invitation to connect with the contact.
- `linkedin_step_message`: Send a direct message to the contact's LinkedIn profile.
- `linkedin_step_view_profile`: View the contact's LinkedIn profile.
- `linkedin_step_interact_post`: Interact with the contact's recent LinkedIn posts.
- `action_item`: Take generic action for the contact. If you use this task type, Apollo recommends using the `note` parameter too.
"
},
"priority": {
"type": "string",
"description": "Assign a priority to the task you are creating: ",
"default": "medium"
},
"status": {
"type": "string",
"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`"
},
"due_at": {
"type": "string",
"format": "date-time",
"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`"
},
"title": {
"type": "string",
"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`"
},
"note": {
"type": "string",
"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.`"
}
}
},
"examples": {
"Create a call task": {
"value": {
"user_id": "66302798d03b9601c7934ebf",
"contact_id": "66e34b81740c50074e3d1bd4",
"type": "call",
"priority": "high",
"status": "scheduled",
"due_at": "2025-02-15T10:00:00Z",
"title": "Follow-up call",
"note": "Discuss product demo results and next steps."
}
}
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:1c7f8afc5a0294a06f10a4a723834141f5080dc1a9f95ab39aa27e1fd0e540a7"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-tasks"
}
},
"/apis/v1/apollo/tasks/bulk_create": {
"post": {
"description": "Bulk create tasks. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_tasks_bulk_create",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "string"
},
"description": "Created tasks (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Bulk Create Tasks",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "067dc0b7ba35"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/tasks/bulk_create",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_tasks_bulk_create",
"method": "ANY",
"path": "/apis/v1/apollo/tasks/bulk_create"
},
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"user_id",
"contact_ids",
"type",
"status",
"due_at"
],
"properties": {
"user_id": {
"type": "string",
"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`"
},
"contact_ids": {
"type": "array",
"items": {
"type": "string"
},
"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`"
},
"type": {
"type": "string",
"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. - `call`: Call the contacts.
- `outreach_manual_email`: Email the contacts.
- `linkedin_step_connect`: Send a LinkedIn invitation to connect with the contacts.
- `linkedin_step_message`: Send a direct message to the contacts' LinkedIn profiles.
- `linkedin_step_view_profile`: View the contacts' LinkedIn profiles.
- `linkedin_step_interact_post`: Interact with the contacts' recent LinkedIn posts.
- `action_item`: Take generic action for the contacts. If you use this task type, Apollo recommends using the `note` parameter too.
"
},
"priority": {
"type": "string",
"description": "Assign a priority to the task you are creating: ",
"default": "medium"
},
"status": {
"type": "string",
"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`"
},
"due_at": {
"type": "string",
"format": "date-time",
"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`"
},
"note": {
"type": "string",
"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.`"
}
}
},
"examples": {
"Create call tasks for multiple contacts": {
"value": {
"user_id": "66302798d03b9601c7934ebf",
"contact_ids": [
"66e34b81740c50074e3d1bd4",
"66e34b81740c50074e3d1bd5",
"66e34b81740c50074e3d1bd6"
],
"type": "call",
"priority": "high",
"status": "scheduled",
"due_at": "2025-02-15T10:00:00Z",
"note": "Follow up on demo request."
}
}
}
}
}
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:c3870ec62b396db3e3e8d411319708092a7e633eefb94d826ee24e5553916ece"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-tasks-bulk-create"
}
},
"/apis/v1/apollo/tasks/search": {
"post": {
"description": "Search tasks. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_tasks_search",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"tasks": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tasks (when returned)."
},
"pagination": {
"type": "object",
"description": "Pagination metadata (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Search for Tasks",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "353382a4d1bb"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/tasks/search",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_tasks_search",
"method": "ANY",
"path": "/apis/v1/apollo/tasks/search"
},
"parameters": [
{
"name": "open_factor_names[]",
"in": "query",
"required": false,
"schema": {
"type": "array",
"items": {
"type": "string"
}
},
"description": "Optional open factors."
},
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Page number."
},
{
"name": "per_page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Results per page."
},
{
"name": "sort_by_field",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Sort field."
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:5d93524b30f8a9f38278015fa9c462080eff7e674b91b9103a0f41425ad8f06c"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-tasks-search"
}
},
"/apis/v1/apollo/typed_custom_fields": {
"get": {
"description": "Get a list of all custom fields. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_typed_custom_fields",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"typed_custom_fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Custom field definitions (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Get a List of All Custom Fields",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "231fb84a1493"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/typed_custom_fields",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_typed_custom_fields",
"method": "ANY",
"path": "/apis/v1/apollo/typed_custom_fields"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:8ee4f8924bdf96bee8e7d02165ccd27caad15ec66b7d923806337655d2be5400"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-typed-custom-fields"
}
},
"/apis/v1/apollo/usage_stats/api_usage_stats": {
"post": {
"description": "View API usage stats and rate limits. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "post_apollo_usage_stats_api_usage_stats",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"api_usage_stats": {
"type": "object",
"description": "Usage stats and rate limits (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "View API Usage Stats and Rate Limits",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "a942568990c3"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/usage_stats/api_usage_stats",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "post_apollo_usage_stats_api_usage_stats",
"method": "ANY",
"path": "/apis/v1/apollo/usage_stats/api_usage_stats"
},
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:12c87854a68b04a8d41d3e27462c546d9a38af322e71a38555003a6bbfdc6862"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/post_apollo-usage-stats-api-usage-stats"
}
},
"/apis/v1/apollo/users/search": {
"get": {
"description": "Get a list of users. Requires a master API key.\n\n\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n",
"operationId": "get_apollo_users_search",
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"users": {
"type": "array",
"items": {
"type": "string"
},
"description": "Users (when returned)."
},
"pagination": {
"type": "object",
"description": "Pagination metadata (when returned)."
}
}
}
}
}
},
"default": {
"content": {
"application/json": {
"schema": {}
}
},
"description": "Error response; upstream passthrough responses may use provider formats"
}
},
"summary": "Get a List of Users",
"tags": [
"default"
],
"x-aisa-capabilities": {
"idempotency": "Idempotency-Key",
"max_price": "X-AISA-Max-Price-USD",
"quote": {
"header": "X-AISA-Cost-Mode",
"value": "quote"
},
"mpp": false,
"mpp_methods": [],
"x402": false
},
"x-aisa-category": "14",
"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-revision": {
"customer_pricing_ref": "613706296d43",
"plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
"profile_ref": "101335a2c464"
},
"x-aisa-status": "enabled",
"x-aisa-upstream-path": "/api/v1/users/search",
"x-aisa-validation": "provider",
"x-aisa-catalog-id": "apollo",
"x-aisa-runtime-operation": {
"operation_id": "get_apollo_users_search",
"method": "ANY",
"path": "/apis/v1/apollo/users/search"
},
"parameters": [
{
"name": "page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Page number."
},
{
"name": "per_page",
"in": "query",
"required": false,
"schema": {
"type": "integer"
},
"description": "Results per page."
}
],
"x-aisa-source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"x-aisa-response-source": {
"kind": "upstream_success_contract",
"source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:1109ba3b118616b8d50255d36da73c5676ad069d3891faecb9fb76d58b466e4a",
"converter": "reviewed-official-apollo-contact-bulk-body-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:e9db315f9e3771248790c38e4f9c996ea5bfb543cd4fe6963d7f0da02af5ed2e",
"converter": "reviewed-official-apollo-query-arrays-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:d63ce58148d44d706d9a458715bfb9108a6f2c02e3fb7bc55fe4398988653d30",
"converter": "reviewed-official-apollo-object-bodies-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:b86f656b53376a9fef1ca7c5533222de5ce5268b32ceabad84f1c5f07abe5f1d",
"converter": "reviewed-official-apollo-bulk-update-request-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:2f7578cfe1dd0ef86909a1a046e837282dd1c538e0987583e561644ff3c6cc5f",
"converter": "reviewed-apollo-nonempty-identity-client-guard@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f0c3744930ca69d8c73ae184d916619e066029ba0ab10f41b3487254c5c0d752",
"converter": "reviewed-request-location-amendment@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113",
"prior_source": {
"kind": "manual",
"url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/apollo.json",
"fetched_at": "2026-09-29T21:25:55+08:00",
"content_hash": "sha256:f882615f916cd110e7016acd2c8890239fdd25e2ea8c6d7f92c31871ffb2e614",
"converter": "scripts/import_existing_contracts.py@1",
"path_space": "public",
"owner": "AIsa-team/docs",
"refresh_policy": "manual",
"review_period_days": 30,
"policy_revision": "sha256:0696df7340b69447edfd4345ca774bbfb4faa1de7c8f354ebabd16a67c18d113"
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"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."
},
"content_hash": "sha256:172657926cf5336ede0f8bca5f63044fa460b90460e6c27a36e1762b26b09a46"
},
"x-aisa-docs-url": "https://aisa.one/docs/api-reference/apollo/get_apollo-users-search"
}
}
}
}