{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"You can delete contacts in bulk by submitting an array of contact `id`s.\n\nThe endpoint creates an async job that processes the deletes in the background. Use the returned job ID with `GET /contacts/bulk/{id}` to check the job status.\n\n{% admonition type=\"warning\" name=\"Permanent deletion\" %}\n  A contact that doesn't exist, or can't be deleted, fails that item and the job's `state` ends as `completed_with_errors` (visible via `GET /contacts/bulk/{id}`) without failing the rest of the batch.\n{% /admonition %}\n\n{% admonition type=\"info\" name=\"Limits\" %}\n  - Maximum of 1,000 contacts per request.\n  - You can append tasks to an existing job by including `job.id` in the request body.\n{% /admonition %}\n\nRequires the `read_write_users` or `write_users_companies` OAuth scope.\n","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"body":{"$ref":"#/definitions/bulk_delete_contacts_request","examples":[{"contacts":[{"id":"abc123"},{"id":"def456"}]}]}},"required":[],"additionalProperties":false,"definitions":{"intercom_version":{"description":"Intercom API version.</br>If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.","type":"string","enum":["1.0","1.1","1.2","1.3","1.4","2.0","2.1","2.2","2.3","2.4","2.5","2.6","2.7","2.8","2.9","2.10","2.11","2.12","2.13","2.14","2.15","2.16","2.17"],"examples":["2.17"]},"bulk_delete_contacts_request":{"title":"Bulk Delete Contacts Request","type":"object","description":"Request body for permanently bulk deleting contacts.","required":["contacts"],"properties":{"contacts":{"type":"array","description":"An array of contacts to delete, each identified by `id`. Maximum 1,000 contacts per request.","maxItems":1000,"items":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"The unique identifier for the contact.","examples":["abc123"]}}}},"job":{"type":"object","description":"Optional. Include to append tasks to an existing job.","properties":{"id":{"type":"string","description":"The ID of an existing bulk job to append to.","examples":["job_v2_1"]}}}}}}},"name":"Bulk delete contacts","id":"intercom.bulkdeletecontacts","example":{},"maxRequests":1,"summary":false}}