> ## Documentation Index > Fetch the complete documentation index at: https://docs.anycrm.anyreach.ai/llms.txt > Use this file to discover all available pages before exploring further. # Update a Contact Partial update — only fields present in the body are changed (`exclude_unset`), so omitting a field leaves it untouched, but explicitly passing `null` clears it. Field semantics are the same as [Create](/api-reference/contacts/create-contact), plus `department`, which isn't accepted on create — this endpoint and a [CSV import](/api-reference/contacts/import-start) are the two ways to set it. `account_id`, if provided, is validated to belong to the caller's organization the same way as on create. This endpoint does not accept `stage` — use [Respond](/api-reference/contacts/respond), [Disqualify](/api-reference/contacts/disqualify), or [Convert](/api-reference/contacts/convert) to move a contact through the funnel. Unlike the funnel-action endpoints, this one does **not** check that `contact_id` exists before patching. A PATCH matching no row (nonexistent id, or a different organization's contact under RLS) is still a "successful" PostgREST update of zero rows, so the response is `200 {}` rather than a `404`. ### Auth Requires a CRM manage [scope](/authentication#scopes) and an active organization on the token. Any `*:manage` scope qualifies — in practice `contacts:manage`, `deals:manage`, `companies:manage`, or `activities:manage`. ### Response The updated contact row (same shape as [Create](/api-reference/contacts/create-contact)'s response), or `{}` if `contact_id` didn't match a row — see note above. ### Errors | Status | Cause | | ------ | ------------------------------------------------------------------------ | | `400` | Empty body (no fields to update), or no active organization. | | `404` | `account_id` doesn't resolve to an account in the caller's organization. | ## OpenAPI ````yaml PATCH /contacts/{contact_id} openapi: 3.1.0 info: title: anycrm-api version: 0.0.1 servers: [] security: [] tags: - name: Customer Intelligence description: >- Company research and ICP-fit scoring — create a research run, track its progress, and read back scored companies as leads. - name: Outreach description: >- The cold-email management console — domains, mailboxes, and campaigns — as a thin control plane over the SalesForge stack. - name: AnyCard description: >- Authenticated CRUD for AnyCard, the org's digital business-card / lead-capture product. - name: AnyCard Events description: >- Event-attribution analytics for AnyCard — which captured leads converted, broken down by source, owner, and deal. - name: AnyCard Share Links description: >- Unauthenticated endpoints reached by anyone who scans a QR code or opens a shared AnyCard link. - name: AI description: >- A streaming (SSE) AI chat endpoint with account-commit actions it can take on the caller's behalf. - name: Analytics Assistant description: >- The natural-language analytics assistant — a guarded text-to-SQL loop (SSE) that answers ad-hoc questions over the org's CRM data as a least-privilege, read-only database role. - name: Account Readiness description: >- Account Readiness Profiles — AI-scored signals on whether an account is ready for outreach or expansion, computed via a Temporal workflow. - name: Integrations description: >- Pipedream Connect — issuing connect tokens and managing the org's connected third-party accounts. - name: Feedback description: >- User-submitted platform feedback (bug reports, feature requests) — global, not scoped to one organization. - name: Public Media description: >- Unauthenticated image reads for publicly-embeddable assets (card photos, inline email images) — allowlisted by key shape; everything else in the storage bucket stays private. - name: Service Health description: Service liveness. paths: /contacts/{contact_id}: patch: tags: - Contacts summary: Patch Contact operationId: patch_contact_route_contacts__contact_id__patch parameters: - name: contact_id in: path required: true schema: type: string description: The contact's id. title: Contact Id description: The contact's id. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ContactPatchBody' responses: '200': description: Successful Response content: application/json: schema: type: object additionalProperties: true title: Response Patch Contact Route Contacts Contact Id Patch '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: ContactPatchBody: properties: account_id: anyOf: - type: string - type: 'null' title: Account Id description: >- Link to a different account (must belong to the caller's organization), or null to unlink. first_name: anyOf: - type: string - type: 'null' title: First Name description: Given name. last_name: anyOf: - type: string - type: 'null' title: Last Name description: Family name. email: anyOf: - type: string - type: 'null' title: Email description: Contact's email address. title: anyOf: - type: string - type: 'null' title: Title description: Job title. department: anyOf: - type: string - type: 'null' title: Department description: >- Department/team name. Not accepted on creation — set it via PATCH or by mapping a column to it in a CSV import. phone: anyOf: - type: string - type: 'null' title: Phone description: Phone number. linkedin_url: anyOf: - type: string - type: 'null' title: Linkedin Url description: LinkedIn profile URL. company: anyOf: - type: string - type: 'null' title: Company description: Free-text company name for an unlinked contact. company_domain: anyOf: - type: string - type: 'null' title: Company Domain description: Company's email domain, used for search/enrichment. source: anyOf: - type: string - type: 'null' title: Source description: Origin tag for this record. notes: anyOf: - type: string - type: 'null' title: Notes description: Free-text notes. owner_id: anyOf: - type: string - type: 'null' title: Owner Id description: Logto user ID of the owning rep. type: object title: ContactPatchBody HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: HTTPBearer: type: http scheme: bearer ````