Journey Docs
Partner API ExplorerAccess

Set a user’s reach

Required scopepartner:access:write
PUT
/v1/partner/users/{workosUserId}/scope

Full replacement. Send disposition: "org" for organization-wide reach, or disposition: "scoped" with a level of brand or venue plus the external ids to allow. Reach can only narrow what the caller themselves can reach, and nobody may widen their own.

Authorization

headerAuthorizationBearer <token>

WorkOS access token (JWT) for a user who is a member of the partner organization. The organization the request is scoped to is taken from the token, not from a header or query parameter.

Only a JWT is accepted in this header. A Journey jny_ API key sent as a bearer token is rejected with 401 Invalid or expired token; send it in X-API-Key instead.

WorkOS organization API keys are not accepted yet.

Path Parameters

workosUserId*string

WorkOS user id of the member of your organization.

Query Parameters

organizationId*string

Request Body

application/json
  1. body
disposition*string
Value in"org""scoped"
externalIds?array<>
Items1 <= items
level?string
Value in"brand""venue"

Response Body

The user’s reach after the change.

curl -X PUT 'https://api-prd.cf.journey.com/v1/partner/users/string/scope?organizationId=string' \  -H 'Content-Type: application/json' \  -d '{  "disposition": "org"}'
Empty