dataz.md
Log in Get started

Discord API reference

List shared private channels

Crawlable reference for GET /guilds/{guild_id}/private_channels/shared/{user_id} through a dataz.md tenant gateway.

Purpose

GET/guilds/{guild_id}/private_channels/shared/{user_id}

List private text channels that both the bot and a specific user can access.

Returns channels that are not visible to @everyone but are accessible to both the bot and the specified user.

  • guild_id: Discord guild ID
  • user_id: Discord user ID to check shared access with
Category: Guilds Auth: Authorization bearer or X-API-Key Scope: read-only

Authentication

Send a tenant API key as Authorization: Bearer <key> or X-API-Key: <key>. Keep keys server-side and use the account slug for the connected Discord account.

Read the gateway authentication tutorial.

Parameters

NameInRequiredType / constraints
guild_id path required integer
user_id path required integer

Request example

Replace the tenant, account, and resource placeholders before running this read-only request.

curl --fail-with-body \
  -H "Authorization: Bearer ${DATAZ_API_KEY}" \
  "https://dataz.md/gateway/v1/{tenant_slug}/accounts/{account_slug}/guilds/{guild_id}/private_channels/shared/{user_id}"

Response schema

Documented responses
200Response model: List[Channel]List[Channel]

Response example

Representative JSON shape. The live response can include additional documented fields.

[
  {
    "id": "123456789012345678",
    "name": "example-channel",
    "type": 0,
    "guild_id": "123456789012345678"
  }
]

Errors

Common responses
401Missing or invalid tenant API key.authentication
403The tenant, account, or connected provider cannot access the requested resource.authorization
404The route or requested provider resource was not found.not found
422A path or query parameter is invalid.validation
429Rate limited; wait for the Retry-After interval before retrying.rate limit

Limits and pagination

  • This endpoint does not expose cursor pagination in its current public contract.
  • Provider or demo limits can return HTTP 429. Wait for the Retry-After interval before retrying.

Related tutorials

Read-only notes

This reference page documents a public GET endpoint. Setup/token, AI, dev, internal, and mutating routes are excluded from static reference generation.