Assign Appointment to Operator

POST

/graphql/assigncounciltouser

# Assign Appointment to Operator (`assignCouncilToUser`) Este método permite asignar una cita (consejo) existente a un operador u agente específico dentro del sistema, utilizando el identificador único de la cita y el identificador del usuario. Al completarse la mutación, el operador seleccionado asumirá el control y la gestión de la sesión de atención. ### Autenticación > **Tipo:** API Key** Header:** `x-jwt-token` **Ubicación:** Header HTTP_ Ejemplo:_ `x-jwt-token: eyJhbGciOiJIUzI1NiIsInR5cCI6...` ## Referencia de la API ### Parámetros de Entrada (Variables) | Parámetro | Descripción | Requerido | Tipo | | --- | --- | --- | --- | | councilId | Identificador numérico único de la cita en la plataforma. | SI | Integer | | userId | Identificador numérico único del usuario (operador/agente) al que se le va a asignar la cita. | SI | | ### Campos de Respuesta (Payload) La mutación devuelve un objeto `assignCouncilToUser` con el resultado funcional de la operación: | Parámetro | Descripción | Tipo | | --- | --- | --- | | data | Objeto dato | Object | | data.assignCouncilToUser | Objeto del usuario | Object | | data.assignCouncilToUser.success | Valor booleano de verificación de asignación. | Boolean | | data.assignCouncilToUser.message | Error que devuelve, por defecto _null_ | String | ## Ejemplos de Código y Peticiones ### 1\. Mutación GraphQL ``` graphql mutation AssignCouncilToUser($councilId: Int!, $userId: Int!) { assignCouncilToUser(councilId: $councilId, userId: $userId) { success message } } ``` ### 2\. Variables de la Petición (JSON Payload) ``` json { "councilId": 64719, "userId": 3477 } ``` ### 3\. Ejemplo de comando cURL ``` bash curl --location "https://api.ovac.pre.councilbox.com/graphql" \ --header "Content-Type: application/json" \ --header "x-jwt-token: {{token}}" \ --data '{"query":"mutation AssignCouncilToUser($councilId: Int!, $userId: Int!){ assignCouncilToUser(councilId: $councilId, userId: $userId){ success message } }","variables":{"councilId":64719,"userId":3477}}' ``` ### 4\. Respuesta Esperada (200 OK) ``` json { "data": { "assignCouncilToUser": { "success": true, "message": null } } } ``` > **Nota OpenAPI/Fern:** esta operación GraphQL se documenta como `/graphql/assigncounciltouser` para que Fern pueda mostrarla como operación independiente. La ruta técnica real de ejecución es `POST /graphql`.

Assign Appointment to Operator

POST

/graphql/assigncounciltouser

Este método permite asignar una cita (consejo) existente a un operador u agente específico dentro del sistema, utilizando el identificador único de la cita y el identificador del usuario. Al completarse la mutación, el operador seleccionado asumirá el control y la gestión de la sesión de atención.

Autenticación

Tipo: API Key**
Header:** x-jwt-token
Ubicación: Header HTTP_
Ejemplo:_ x-jwt-token: eyJhbGciOiJIUzI1NiIsInR5cCI6...

Referencia de la API

Parámetros de Entrada (Variables)

Parámetro	Descripción	Requerido	Tipo
councilId	Identificador numérico único de la cita en la plataforma.	SI	Integer
userId	Identificador numérico único del usuario (operador/agente) al que se le va a asignar la cita.	SI

Campos de Respuesta (Payload)

La mutación devuelve un objeto assignCouncilToUser con el resultado funcional de la operación:

Parámetro	Descripción	Tipo
data	Objeto dato	Object
data.assignCouncilToUser	Objeto del usuario	Object
data.assignCouncilToUser.success	Valor booleano de verificación de asignación.	Boolean
data.assignCouncilToUser.message	Error que devuelve, por defecto null	String

Ejemplos de Código y Peticiones

1. Mutación GraphQL

1 mutation AssignCouncilToUser($councilId: Int!, $userId: Int!) {
2     assignCouncilToUser(councilId: $councilId, userId: $userId) {
3         success
4         message
5     }
6 }

2. Variables de la Petición (JSON Payload)

1 {
2     "councilId": 64719,
3     "userId": 3477
4 }

3. Ejemplo de comando cURL

$ curl --location "https://api.ovac.pre.councilbox.com/graphql" \
> --header "Content-Type: application/json" \
> --header "x-jwt-token: {{token}}" \
> --data '{"query":"mutation AssignCouncilToUser($councilId: Int!, $userId: Int!){ assignCouncilToUser(councilId: $councilId, userId: $userId){ success message } }","variables":{"councilId":64719,"userId":3477}}'

4. Respuesta Esperada (200 OK)

1 {
2     "data": {
3         "assignCouncilToUser": {
4             "success": true,
5             "message": null
6         }
7     }
8 }

Nota OpenAPI/Fern: esta operación GraphQL se documenta como /graphql/assigncounciltouser para que Fern pueda mostrarla como operación independiente. La ruta técnica real de ejecución es POST /graphql.

Authentication

x-jwt-tokenstring

JWT token obtained from Login.

Request

This endpoint expects an object.

querystringRequired

GraphQL operation

variablesobjectOptional

GraphQL variables

Response

Successful response. GraphQL business errors may be returned inside the JSON errors field while transport status remains HTTP 200.