> ## Documentation Index > Fetch the complete documentation index at: https://docs.tented.ai/llms.txt > Use this file to discover all available pages before exploring further. # Update a contact > Update a single contact by ID — the single-record equivalent of one `POST /v1/contacts/update` item, without the batch envelope. Only the fields present in the body are changed; nullable fields accept `null` to clear the stored value; unknown fields are rejected. A body with no updatable fields returns `400` (`No fields to update`). Changing `email` or `phone` to a value already used by another contact returns `409` with the conflicting contact in `details.existing_contact`, and clearing both identifiers is rejected — a contact must always keep at least one valid email or phone. Returns the full updated contact, including `custom_fields`. ## OpenAPI ````yaml /api-reference/openapi.json patch /v1/contacts/{contactId} openapi: 3.1.0 info: title: Tented API version: 1.0.0 description: >- The Tented public API: generate, publish, and manage AI-built web pages (tents), and run the email platform — contacts, reusable emails, one-time blasts, and triggered flows. ## Authentication Authenticate every request with a workspace API key: `Authorization: Bearer `. Keys are created in **Workspace Settings → API Keys** and are scoped to a single workspace. ## Asynchronous work Tent generation, bulk creation, and email AI generation return `202 Accepted` immediately. Poll the corresponding status endpoint (`GET /v1/tents/{tentId}`, `GET /v1/bulk-jobs/{bulkJobId}`, `GET /v1/emails/{emailId}/generations/{generationId}`) — no more than every 10 seconds. ## Pagination Email listings use cursor pagination (`cursor`/`next_cursor`). Blast, flow, and member listings use page pagination (`page`/`limit` with a `pagination` object in the response). ## Conventions Request and response fields are snake_case, with two exceptions: analytics query parameters (`tentIdOrAlias`, `daysBack`) and segment rule trees (camelCase keys such as `listId` and `timeWindow`). contact: name: Tented Support email: support@tented.ai servers: - url: https://api.tented.ai description: Production security: - bearerAuth: [] tags: - name: Tents description: >- Create, edit, publish, and manage AI-generated pages, including asset uploads and bulk creation. - name: Analytics description: Traffic analytics for single tents and the whole workspace. - name: Contacts description: >- Batch create, update, and delete contacts. Up to 25 items per request with per-item results. - name: Emails description: >- Reusable email content: AI generation, direct HTML edits, plain-text control, and approval. - name: Email Blasts description: >- One-time sends to an audience: compose, schedule, track engagement, export recipients. - name: Triggered Flows description: >- Multi-step automations that enroll contacts on triggers and move them through a step graph. - name: Contact Imports - name: Contact Fields - name: Contact Lists - name: Email Templates - name: Tent Templates description: >- Reusable, AI-editable tent layouts. Create from HTML or an existing tent, iterate with AI, approve, and clone. Approved tent templates seed new tents. paths: /v1/contacts/{contactId}: patch: tags: - Contacts summary: Update a contact description: >- Update a single contact by ID — the single-record equivalent of one `POST /v1/contacts/update` item, without the batch envelope. Only the fields present in the body are changed; nullable fields accept `null` to clear the stored value; unknown fields are rejected. A body with no updatable fields returns `400` (`No fields to update`). Changing `email` or `phone` to a value already used by another contact returns `409` with the conflicting contact in `details.existing_contact`, and clearing both identifiers is rejected — a contact must always keep at least one valid email or phone. Returns the full updated contact, including `custom_fields`. operationId: update-contact parameters: - name: contactId in: path required: true schema: type: string format: uuid description: Contact ID. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ContactPatch' responses: '200': description: The updated contact, including `custom_fields`. content: application/json: schema: $ref: '#/components/schemas/ContactWithCustomFields' '400': description: >- Bad request — `contactId` is not a valid UUID, the body is invalid, no updatable fields were supplied (`No fields to update`), or the update would leave the contact with neither a valid email nor phone. Validation failures include `details.issues` with per-field messages. content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Unauthorized — missing, malformed, revoked, or expired API key. content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: >- Not found — the resource does not exist in the workspace tied to your API key. content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: >- Conflict — the new `email` or `phone` already belongs to another contact. `details.existing_contact` identifies the conflicting contact (`contact_id`, `display_name`, `email`, `phone`). content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: ContactPatch: type: object properties: email: type: - string - 'null' description: >- Email address. Pass `null` to clear (only allowed if a valid phone remains). phone: type: - string - 'null' description: >- Phone number. Pass `null` to clear (only allowed if a valid email remains). display_name: type: - string - 'null' maxLength: 255 description: Display name. Pass `null` to clear. first_name: type: - string - 'null' maxLength: 255 description: First name. Pass `null` to clear. last_name: type: - string - 'null' maxLength: 255 description: Last name. Pass `null` to clear. email_domain: type: - string - 'null' description: Usually auto-derived from `email`. maxLength: 255 company: type: - string - 'null' maxLength: 255 description: Company. Pass `null` to clear. job_title: type: - string - 'null' maxLength: 255 description: Job title. Pass `null` to clear. address: type: - string - 'null' maxLength: 500 description: Street address. Pass `null` to clear. address2: type: - string - 'null' maxLength: 255 description: Address line 2. Pass `null` to clear. city: type: - string - 'null' maxLength: 255 description: City. Pass `null` to clear. state: type: - string - 'null' maxLength: 255 description: State or region. Pass `null` to clear. country: type: - string - 'null' maxLength: 255 description: Country. Pass `null` to clear. zip_code: type: - string - 'null' maxLength: 50 description: Postal code. Pass `null` to clear. original_source: type: - string - 'null' maxLength: 255 description: Original source. Pass `null` to clear. original_source_detail: type: - string - 'null' maxLength: 255 description: Original source detail. Pass `null` to clear. lead_status: type: - string - 'null' maxLength: 100 description: Lead status. Pass `null` to clear. lifecycle_stage: type: - string - 'null' maxLength: 100 description: Lifecycle stage. Pass `null` to clear. tented_score: type: - number - 'null' description: Contact score. Pass `null` to clear. unsubscribed: type: boolean description: Global unsubscribe flag. marketing_email_subscribed: type: - boolean - 'null' description: Email marketing subscription state. marketing_sms_subscribed: type: - boolean - 'null' description: SMS marketing subscription state. marketing_sms_invalid: type: boolean description: Mark the phone number invalid. custom_fields: type: object additionalProperties: type: - string - number - boolean - 'null' description: >- Editable custom fields keyed by API name. Pass `null` to clear a value. description: >- Fields to change on a contact. Only supplied fields are modified; unknown fields are rejected. A contact must always keep at least one of email or phone. ContactWithCustomFields: allOf: - $ref: '#/components/schemas/Contact' - type: object properties: custom_fields: type: object additionalProperties: type: - string - 'null' description: >- Custom field values keyed by field API name. Values are returned as stored strings (or `null`) regardless of the field's declared value type. description: A contact record including its custom field values. Error: type: object properties: error: type: string description: Human-readable error message. error_code: type: string description: >- Stable machine-readable error code (present on email, blast, flow, and related endpoints, e.g. `campaign_not_ready`, `generation_in_progress`). message: type: string description: Additional human-readable context (present on some tent endpoints). code: type: string description: >- Machine-readable code used by tent creation errors (e.g. `INVALID_PROMPT_INTENT`). details: type: object additionalProperties: true description: >- Additional error context. Validation errors include `issues`: an array of `{ path, message }` objects. limit: type: integer description: Plan limit that was hit (present on `429` publish-limit errors). current: type: integer description: >- Current usage against the limit (present on `429` publish-limit errors). required: - error description: >- Error response. All errors include `error`; the other fields vary by endpoint group. Contact: type: object properties: contact_id: type: string format: uuid description: Contact ID. display_name: type: - string - 'null' description: Display name. first_name: type: - string - 'null' description: First name. last_name: type: - string - 'null' description: Last name. email: type: - string - 'null' description: Email address. phone: type: - string - 'null' description: Phone number. email_domain: type: - string - 'null' description: Domain derived from the email address. company: type: - string - 'null' description: Company. job_title: type: - string - 'null' description: Job title. address: type: - string - 'null' description: Street address. address2: type: - string - 'null' description: Address line 2. city: type: - string - 'null' description: City. state: type: - string - 'null' description: State or region. country: type: - string - 'null' description: Country. zip_code: type: - string - 'null' description: Postal code. original_source: type: - string - 'null' description: How the contact was first created, e.g. `Public API`. original_source_detail: type: - string - 'null' description: Additional source detail. lead_status: type: - string - 'null' description: Lead status. lifecycle_stage: type: - string - 'null' description: Lifecycle stage. tented_score: type: - number - 'null' description: Contact score. unsubscribed: type: boolean description: Global unsubscribe flag. marketing_email_subscribed: type: - boolean - 'null' description: Email marketing subscription state. marketing_sms_subscribed: type: - boolean - 'null' description: SMS marketing subscription state. marketing_email_invalid: type: boolean description: Whether the email address is known to be invalid. marketing_sms_invalid: type: boolean description: Whether the phone number is known to be invalid. last_activity_at: type: - string - 'null' format: date-time description: Most recent tracked activity. created_at: type: string format: date-time description: Creation time. updated_at: type: string format: date-time description: Last update. description: A contact record. Fields that were never set are omitted. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Workspace API key, e.g. `Authorization: Bearer tented_...`. Create keys in Workspace Settings → API Keys. ````