Revoke an activation connect link

Revokes an activation Connect Link so that it can no longer be used. Read more on how to use Connect Links in our Activations in Powered by Fivetran How-to Guides.

Request schema

Path parameters

connect_link_id

integerrequired

ID of the connect link

Header parameters

Authorization

stringrequired

HTTP: basicAuth

HTTP AuthorizationScheme: basic

Http + 1.1

POST

https://app.getcensus.com/api/v2/activation_connect_links/{connect_link_id}/revoke

POST /api/v2/activation_connect_links/{connect_link_id}/revoke HTTP/1.1
Authorization: Bearer REPLACE_BEARER_TOKEN
Host: app.getcensus.com

Responses

200

Successfully revoked the activation connect link.

401

Invalid credentials for the requested resource.

404

Resource not found.

`200`

status

string

Outcome of the operation.

example:

success

data

object

integerrequired

The unique ID associated with the Connect Link.

example:

469

type

string

The type of activation connection to be managed by this link. A valid type is the service_name of a connector returned from the /activation_types endpoint, where the connector is marked as creatable_via_connect_link.

example:

hubspot

expiration

stringrequired

The date and time when the Connect Link will expire.

format:

date-time

example:

2023-07-22T23:42:47.239Z

expired

boolean

A boolean value indicating whether the Connect Link has expired or not. Expiration settings can be adjusted in the Organization Dashboard.

revoked

booleanrequired

A boolean value indicating whether the Connect Link has been revoked or not.

uri

string | nullrequired

The authorization url that you will provide to end-users that begins the Census-hosted flow to authorize an activation into your workspace. This is null once the Connect Link has expired or been revoked.

format:

uri

example:

https://app.getcensus.com/pbc?auth=expiring_auth_key

redirect_uri

string | null

The redirect URI, if any, associated with the Connect Link. The URL that you'd like the end-user to be redirected to after authorizing the activation. We do not forward the OAuth code or token to this url. The redirect URI can be configured globally under your organization settings in the Census UI or on dynamically via the API when creating a Connect Link.

format:

uri

group_id

string

The unique identifier of the group associated with this Connect Link.

example:

wandering_aimlessly

`401`

status

integer

HTTP status code.

enum:

"401"

`404`

status

integer

HTTP status code.

enum:

"404"

{
  "status": "success",
  "data": {
    "id": 469,
    "type": "hubspot",
    "expiration": "2023-07-22T23:42:47.239Z",
    "expired": false,
    "revoked": false,
    "uri": "https://app.getcensus.com/pbc?auth=expiring_auth_key",
    "redirect_uri": "http://example.com",
    "group_id": "wandering_aimlessly"
  }
}