Skip to main content
GET

​
Path parameters

Authorizations

​
Authorization
string
header
required

API key sent as a Bearer token: "Bearer prefix.secret"

Path Parameters

​
id
string
required

Connector ID

Example:

"HydraDoc1234"

Response

OK

​
auth_type
string

Authentication method for the provider connection (e.g. api_token, oauth).

Example:

"api_token"

​
collection
string

Default collection partition for synced objects. Canonical name; mirrors the deprecated sub_tenant_id alias.

Example:

"team_docs"

​
connector_id
string

Connector this resource belongs to.

Example:

"conn_abc123"

​
credential_ref
string

Internal reference to the stored credential record.

Example:

"cred_1a2b3c"

​
database
string

Database/Collection are the canonical v2 names for the deprecated tenant_id/sub_tenant_id wire fields. They mirror the same values so a v2 client sees the canonical names on responses while a legacy client keeps reading tenant_id/sub_tenant_id. Not persisted (dynamodbav:"-"): the store builds items from tenant_id/sub_tenant_id and mirrors these on load. They are populated at every construction point (toConnector, connectorFromItem) rather than via MarshalJSON so Temporal's JSON data converter round-trips Connector activity inputs without spuriously populating them.

Example:

"acme_corp"

​
deployment_id
string

Internal deployment context for this connector.

Example:

"deploy_1234"

​
last_attempted_sync_at
string

RFC3339 timestamp of the most recent sync attempt (successful or not).

Example:

"2026-07-02T17:00:00Z"

​
last_error
string

Error message from the most recent failed sync, empty string when no error.

Example:

""

​
last_successful_sync_at
string

RFC3339 timestamp of the last successful sync completion.

Example:

"2026-07-02T17:00:00Z"

​
name
string

Human-readable label for this connector.

Example:

"general"

​
next_sync_at
string

RFC3339 timestamp when the next scheduled sync will run.

Example:

"2026-07-02T18:00:00Z"

​
org_id
string

Organization that owns this resource.

Example:

"org_1a2b3c"

​
plan
string

Subscription plan this connector runs under.

Example:

"pro"

​
provider
string

External provider being synced (e.g. slack, github, linear, notion, gmail).

Example:

"slack"

​
provider_account_scope
string

Identifier for the external account (e.g. Slack workspace ID, GitHub org name). Must be distinct across connectors for the same provider.

Example:

"T12345ACME"

​
status
string

Lifecycle status of the connector (e.g. active, paused, error).

Example:

"completed"

​
sub_tenant_id
string
deprecated

Default collection partition for synced objects. Deprecated — use collection.

Example:

"sub_tenant_4567"

​
sync_engine
string

SyncEngine is "classic" (default, empty treated as classic) or "moveit". See the SyncEngine* constants; the scheduler branches on it.

​
sync_interval_seconds
integer

How frequently the scheduler triggers incremental syncs, in seconds.

Example:

3600

​
sync_status
string

Current sync operation state (e.g. idle, running).

Example:

"idle"

​
tenant_id
string
deprecated

Database that receives synced data. Deprecated — use database.

Example:

"tenant_1234"

​
user_id
string

User that created or owns this resource.

Example:

"user_alex"