Skip to content
EntitlerDocs

PUT/v1/customers/{external_id}/track

Assign a customer to a track

Puts the customer on the track named by trackId; leaving it absent assigns the default track. A closed or missing track is refused. Needs tracks:assign.

curl -X PUT 'https://api.entitler.co/v1/customers/ada/track' \
  -H "Authorization: Bearer $ENTITLER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":{"environmentId":"environmentId","projectId":"projectId","teamId":"teamId"},"trackId":"trackId"}'

Credentials

Send any one of these:

  • Bearer token

Path parameters

NameTypeDescription
external_idrequiredstring

Request body

object

  • targetProductTarget
    • environmentIdstring
    • projectIdstring
    • teamIdstring
  • trackIdstring

Responses

200The AssignTrackResponse message.

AssignTrackResponse

  • assignmentCustomerTrack
    • customerIdstringrequired
    • externalIdstringrequired
    • moneyCustomerMoneyrequired

      One of CUSTOMER_MONEY_UNSPECIFIED, CUSTOMER_MONEY_REAL, CUSTOMER_MONEY_TEST.

    • previousTrackIdstring
    • revisionintegerrequired

      at least 0; at most 18446744073709552000

    • sourceAssignmentSourcerequired

      One of ASSIGNMENT_SOURCE_UNSPECIFIED, ASSIGNMENT_SOURCE_SERVER, ASSIGNMENT_SOURCE_DASHBOARD.

    • trackIdstring
  • changedbooleanrequired
  • endedTestHoldingsinteger (int64)required

    at least 0; at most 4294967295

ErrorA refusal, with the HTTP status of its gRPC code.

Error

  • errorobjectrequired
    • codestringrequired
    • parametersobjectrequired

      Each value: string

    • reasonstringor nullrequired