Enrich a person

{
  "operationId": "people_enrich",
  "method": "post",
  "path": "/people/enrich",
  "summary": "Enrich a person",
  "description": "Enrich a person with normalized fields (email, mobile, job title, company, LinkedIn URL, location, …). REQUIRES a `identifiers` object containing ONLY `email` and/or `linkedin_url` — these are the unique handles we use to resolve the person upstream. `first_name`, `last_name`, `domain`, `company`, etc. are NOT accepted here and will return a VALIDATION_ERROR. If you only have a name + company, call `/people/email-finder` first to obtain an email, then pass that email here. Optional `fields[]` narrows the waterfall to only fetch the fields you care about. agntdata runs a field-aware waterfall: it stops once all requested fields are filled or your `max_cost_cents` budget is exhausted.",
  "parameters": [],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/PeopleEnrichRequest"
        },
        "example": {
          "identifiers": {
            "linkedin_url": "https://linkedin.com/in/patrickcollison"
          },
          "fields": [
            "email",
            "job_title",
            "company_name",
            "company_domain"
          ]
        }
      }
    }
  },
  "responses": [
    {
      "statusCode": "200",
      "description": "Person enrichment result.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "required": [
              "success",
              "data"
            ],
            "properties": {
              "success": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "data": {
                "$ref": "#/components/schemas/PeopleEnrichResponse"
              },
              "meta": {
                "$ref": "#/components/schemas/AgntMeta"
              }
            }
          }
        }
      }
    },
    {
      "statusCode": "400",
      "description": "Validation error."
    },
    {
      "statusCode": "401",
      "description": "Unauthorized."
    },
    {
      "statusCode": "402",
      "description": "Insufficient credits."
    }
  ]
}