GCX-GCD practice question 8 of 15

Which type of request is sent to update all the participants’ state to disconnected

Full set: 75 questions
Answer options
A: GET
B: PUT
C: PATCH Correct answer
D: POST
Correct Answer:
C. PATCH
Explanation

In the Genesys Cloud CX Platform API, the PATCH method is used to perform a partial update on a resource. To update the state of all participants in a conversation to 'disconnected', a PATCH request is sent to the conversation's resource endpoint (e.g., /api/v2/conversations/{conversationId}). The request body specifies the state change, for example, {"state": "disconnected"}. This action modifies the conversation's state, which consequently attempts to disconnect all associated participants, aligning with the standard use of PATCH for partial resource modification.

Why Incorrect

A. GET: This method is used exclusively for retrieving data from a specified resource and does not modify its state.
B. PUT: This method is used to replace an entire resource with the new data provided, not for a partial update like changing a state.
D. POST: This method is primarily used to create a new resource or to trigger actions that don't fit other HTTP methods, not for updating an existing resource's state.

References

1. Genesys Cloud CX Developer Center, Conversations API: The official documentation for the PATCH /api/v2/conversations/{conversationId} endpoint explicitly states its function is to "Update a conversation." The request body parameter state can be set to disconnected to "Attempt to disconnect all participants."

Source: Genesys Cloud CX Developer Center, API Explorer > Conversations > PATCH /api/v2/conversations/{conversationId}.

Question breakdown

Tests
Use the Conversations API to modify conversation state
Difficulty
Medium

Key idea: Sending PATCH /api/v2/conversations/{conversationId} with state set to disconnected attempts to disconnect all participants.

How to reach the answer

  1. The task is changing one property, the state, on an existing conversation, which is a partial update.
  2. Partial updates in the Genesys Cloud Platform API use PATCH.
  3. The conversation-level PATCH body accepts state 'disconnected', which applies to all participants.
  4. GET only reads data, PUT replaces a whole resource, and POST creates resources or triggers actions.

Each option

  • AIncorrect. GET retrieves conversation data and never changes state.
  • BIncorrect. PUT means full replacement and is not how the conversation-wide disconnect is exposed.
  • CCorrect. PATCH on the conversation resource with state disconnected updates every participant to disconnected.
  • DIncorrect. POST creates resources or starts actions such as new calls; it is not used to set conversation state.

Common trap: PUT looks right because it is an update verb, but Genesys uses PATCH for partial changes such as setting state.

In practice: Integrations and cleanup scripts use this PATCH to end stuck or orphaned conversations programmatically.

Remember: To disconnect everyone on a conversation, PATCH the conversation with state disconnected.

Drafted with AI assistance and checked against the answer key.

Keep practicing

Take the free GCX-GCD practice test

Ten exam-style questions with answers and explanations, plus the exam facts and study guides.

Start the free practice test

More questions

Other GCX-GCD practice questions

Scroll to Top