Add step to appointment

# Add step to appointment (`mutation`) Esta operación permite añadir dinámicamente un nuevo paso durante la ejecución de la cita/gestión, por ejemplo, un consentimiento explícito. De forma automática, en vivo, se añadirá un nuevo paso en la plataforma como complemento a la cita/gestió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 | | --- | --- | --- | --- | | agenda | Objeto contenedor principal con las propiedades técnicas del punto a insertar. | SI | Object | | agenda.**councilId** | Identificador numérico único de la cita existente a la cual se asociará el punto. | SI | Integer | | agenda.**subjectType** | Código numérico que define el comportamiento del punto en la interfaz: <br>`9` -> Consentimiento explícito . | SI | | | agenda.**agendaSubject** | Enunciado, título literal o descripción pública de la votación o consentimiento legal. | NO | String | ### Campos de respuesta (Payload) La mutación devuelve un objeto estructurado bajo el campo raíz `addAgendaPoint:` | Parámetro | Descripción | Tipo | | --- | --- | --- | | addAgendaPoint | Objeto con el resultado del punto del orden del día registrado. | Object | | addAgendaPoint.id | Identificador único generado para el nuevo punto del orden del día insertado | Integer | ## Ejemplos de código y peticiones ### 1\. Consulta GraphQL ``` graphql mutation AddAgendaPoint ( $agenda: AgendaInput ){ addAgendaPoint( agenda: $agenda ) { id } } ``` ### 2\. Variables de la Petición (JSON Payload) ``` json { "agenda": { "councilId": 65167, "subjectType": 9, "agendaSubject": "TEST API" } } ``` ### 3\. Ejemplo de comando cURL ``` bash curl --location 'https://api.ovac.pre.councilbox.com/graphql' \ --header 'Content-Type: application/json' \ --header 'x-jwt-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJiNmQxOTY3ZS04MDY3LTRiMDUtYjQ0MS0zZmFhYWVlN2M3ZDUiLCJ1c2VyX2lkIjozND76LCJ0b2tlbl90eXBlIjoidXNlciIsImlhdCI6MTc4MTA3NjAyMH0.aXYLM7tX0xYjzi4m7gGNUlZ4Dj15cG-iIakmzGwhDTs' \ --data '{"query":"mutation AddAgendaPoint ($agenda: AgendaInput){ addAgendaPoint(agenda: $agenda) { id } }","variables":{"agenda":{"councilId":65167,"subjectType":9,"agendaSubject":"TEST API"}}}' ``` ### 4\. Respuesta Esperada (200 OK) ``` json { "data": { "addAgendaPoint": { "id": 91051 } } } ``` > **Nota OpenAPI/Fern:** esta operación GraphQL se documenta como `/graphql/addagendapoint` para que Fern pueda mostrarla como operación independiente. La ruta técnica real de ejecución es `POST /graphql`.