Delete a Connected Account

Delete a Connected Account by ID

Deleting a connected account triggers a connected_account.deleted event and removes the connected account and all data associated with the connected account from Seam, including devices, events, access codes, and so on. For every deleted resource, Seam sends a corresponding deleted event, but the resource is not deleted from the provider.

For example, if you delete a connected account with a device that has an access code, Seam sends a connected_account.deleted event, a device.deleted event, and an access_code.deleted event, but Seam does not remove the access code from the device.

/connected_accounts/delete

post

Deletes a specified connected account.

Deleting a connected account triggers a connected_account.deleted event and removes the connected account and all data associated with the connected account from Seam, including devices, events, access codes, and so on. For every deleted resource, Seam sends a corresponding deleted event, but the resource is not deleted from the provider.

For example, if you delete a connected account with a device that has an access code, Seam sends a connected_account.deleted event, a device.deleted event, and an access_code.deleted event, but Seam does not remove the access code from the device.

Authorizations

api_keypat_with_workspaceconsole_session_with_workspaceclient_session_with_customer

Body

connected_account_idstring · uuidRequired

ID of the connected account that you want to delete.

syncbooleanOptionalDefault: false

Responses

200

OK

application/json

400

Bad Request

401

Unauthorized

post

HTTPcURLJavaScriptPython

POST /connected_accounts/delete HTTP/1.1
Host: connect.getseam.com
Authorization: Bearer API Key
Content-Type: application/json
Accept: */*
Content-Length: 76

{
  "connected_account_id": "123e4567-e89b-12d3-a456-426614174000",
  "sync": false
}

{
  "ok": true
}

Code Example

Python

seam.connected_accounts.delete("f891acfd-d228-4bb2-8399-c0f7e24e6b16")

cURL (bash)

curl -X 'POST' \
  'https://connect.getseam.com/connected_accounts/delete' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer ${API_KEY}' \
  -H 'Content-Type: application/json' \
  -d '{
  "connected_account_id": "f891acfd-d228-4bb2-8399-c0f7e24e6b16"
}'

# {
#   "ok": true
# }

JavaScript

await seam.connectedAccounts.delete({
  connected_account_id: "f891acfd-d228-4bb2-8399-c0f7e24e6b16"
})

PHP

$seam->connected_accounts->delete("f891acfd-d228-4bb2-8399-c0f7e24e6b16");

Java

seam.connectedAccounts().delete(ConnectedAccountsDeleteRequest.builder()
                .connectedAccountId("f891acfd-d228-4bb2-8399-c0f7e24e6b16")
                .build());

Parameters

connected_account_id	type: string	ID of the Connected Account

Response

This section shows the JSON response returned by the API. Since each language encapsulates this response inside objects specific to that language and/or implementation, the actual type in your language might differ from what’s written here.

JSON format

JSON

{
  "ok": true
}