> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ovac.councilbox.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ovac.councilbox.com/_mcp/server.

# Request agenda information

POST https://api.ovac.pre.councilbox.com/graphql/agenda
Content-Type: application/json

# Request agenda information (`query`)

Esta operación permite consultar el detalle técnico y el estado de consolidación de un paso específico a partir de su identificador único. Su principal función es auditar las interacciones en tiempo real, recuperando el tipo de punto, el enunciado legal y la colección completa de respuestas o consentimientos emitidos (`votings`) por los intervinientes de la sesió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 |
| --- | --- | --- | --- |
| id | Identificador único del punto del paso de la cita/gestión que se desea consultar. | SI | Int |

### Campos de respuesta (Payload)

La consulta devuelve una estructura detallada bajo el resolvedor raíz `addAgendaPoint:`

| Parámetro | Descripción | Tipo |
| --- | --- | --- |
| agenda | Objeto contenedor con las propiedades del paso consultado. | Object |
| agenda.id | Identificador interno único del paso de la cita/gestión. | Integer |
| agenda.subjectType | Código numérico taxonómico que representa la tipología del punto.  <br>`9` -> Consentimiento explícito | Integer |
| agenda.agendaSubject | Título literal, enunciado o pregunta formulada a los participantes. | String |
| agenda.votings\[\] | Colección o array de registros con las interacciones recopiladas. | Array |
| agenda.votings\[\].id | Identificador único del registro de consentimiento individual. | Integer |
| agenda.votings\[\].vote | Valor numérico que representa estado de la respuesta, para los pasos de tipo 9 (consentimiento de aceptación/rechazo)  <br>`-1` -> Sin acción  <br>`0` -> Rechazado  <br>`1` -> Aceptado | Integer |

## Ejemplos de código y peticiones

### 1\. Consulta GraphQL

``` graphql
query Agenda (
    $id: Int!
){
    agenda(
        id: $id
    ) {
        id
        subjectType
        agendaSubject
        votings {
            id
            vote
        }
    }
}

 ```

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

``` json
{
    "id": 91051
}

 ```

### 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.eyJqOTY3ZS04MDY3LTRiMDUtYjQ0MS0zZmFhYWVlN2M3ZDUiLCJ1c2VyX2lkIjozNDc2LCJ0b2tlbl90eXBlIjoidXNlciIsImlhdCI6MTc4MTA3NjAyMH0.aXYLM7tX0xYjzi4m7gGNUlZ4Dj15cG-iIakmzGwhDTs' 
--data '{"query":"query Agenda (\r\n    $id: Int!\r\n\r\n){\r\n    agenda(\r\n        id: $id\r\n    ) {\r\n        id\r\n        subjectType\r\n        agendaSubject\r\n        votings {\r\n            id\r\n            vote\r\n        }\r\n    }\r\n}","variables":{"id":12345}}'

 ```

### 4\. Respuesta esperada (200 OK)

``` json
{
    "data": {
        "agenda": {
            "id": 91051,
            "subjectType": 9,
            "agendaSubject": "TEST API",
            "votings": [
                {
                    "id": 40290,
                    "vote": -1
                }
            ]
        }
    }
}

 ```

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


Reference: https://docs.ovac.councilbox.com/metodos-api/08-remote-council-actions/agenda

## OpenAPI Specification

```yaml
openapi: 3.1.0
info:
  title: ovac
  version: 1.0.0
paths:
  /graphql/agenda:
    post:
      operationId: agenda
      summary: Request agenda information
      description: >
        # Request agenda information (`query`)


        Esta operación permite consultar el detalle técnico y el estado de
        consolidación de un paso específico a partir de su identificador único.
        Su principal función es auditar las interacciones en tiempo real,
        recuperando el tipo de punto, el enunciado legal y la colección completa
        de respuestas o consentimientos emitidos (`votings`) por los
        intervinientes de la sesió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 |

        | --- | --- | --- | --- |

        | id | Identificador único del punto del paso de la cita/gestión que se
        desea consultar. | SI | Int |


        ### Campos de respuesta (Payload)


        La consulta devuelve una estructura detallada bajo el resolvedor raíz
        `addAgendaPoint:`


        | Parámetro | Descripción | Tipo |

        | --- | --- | --- |

        | agenda | Objeto contenedor con las propiedades del paso consultado. |
        Object |

        | agenda.id | Identificador interno único del paso de la cita/gestión. |
        Integer |

        | agenda.subjectType | Código numérico taxonómico que representa la
        tipología del punto.  <br>`9` -> Consentimiento explícito | Integer |

        | agenda.agendaSubject | Título literal, enunciado o pregunta formulada
        a los participantes. | String |

        | agenda.votings\[\] | Colección o array de registros con las
        interacciones recopiladas. | Array |

        | agenda.votings\[\].id | Identificador único del registro de
        consentimiento individual. | Integer |

        | agenda.votings\[\].vote | Valor numérico que representa estado de la
        respuesta, para los pasos de tipo 9 (consentimiento de
        aceptación/rechazo)  <br>`-1` -> Sin acción  <br>`0` -> Rechazado 
        <br>`1` -> Aceptado | Integer |


        ## Ejemplos de código y peticiones


        ### 1\. Consulta GraphQL


        ``` graphql

        query Agenda (
            $id: Int!
        ){
            agenda(
                id: $id
            ) {
                id
                subjectType
                agendaSubject
                votings {
                    id
                    vote
                }
            }
        }

         ```

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


        ``` json

        {
            "id": 91051
        }

         ```

        ### 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.eyJqOTY3ZS04MDY3LTRiMDUtYjQ0MS0zZmFhYWVlN2M3ZDUiLCJ1c2VyX2lkIjozNDc2LCJ0b2tlbl90eXBlIjoidXNlciIsImlhdCI6MTc4MTA3NjAyMH0.aXYLM7tX0xYjzi4m7gGNUlZ4Dj15cG-iIakmzGwhDTs' 

        --data '{"query":"query Agenda (\r\n    $id: Int!\r\n\r\n){\r\n   
        agenda(\r\n        id: $id\r\n    ) {\r\n        id\r\n       
        subjectType\r\n        agendaSubject\r\n        votings {\r\n           
        id\r\n            vote\r\n        }\r\n   
        }\r\n}","variables":{"id":12345}}'

         ```

        ### 4\. Respuesta esperada (200 OK)


        ``` json

        {
            "data": {
                "agenda": {
                    "id": 91051,
                    "subjectType": 9,
                    "agendaSubject": "TEST API",
                    "votings": [
                        {
                            "id": 40290,
                            "vote": -1
                        }
                    ]
                }
            }
        }

         ```

        > **Nota OpenAPI/Fern:** esta operación GraphQL se documenta como
        `/graphql/agenda` para que Fern pueda mostrarla como operación
        independiente. La ruta técnica real de ejecución es `POST /graphql`.
      tags:
        - subpackage_08RemoteCouncilActions
      parameters:
        - name: x-jwt-token
          in: header
          description: JWT token obtained from Login.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: >-
            Successful response. GraphQL business errors may be returned inside
            the JSON `errors` field while transport status remains HTTP 200.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/08 - Remote Council
                  Actions_agenda_Response_200
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: GraphQL operation
                variables:
                  $ref: >-
                    #/components/schemas/GraphqlAgendaPostRequestBodyContentApplicationJsonSchemaVariables
                  description: GraphQL variables
              required:
                - query
servers:
  - url: https://api.ovac.pre.councilbox.com
    description: Pre-production
  - url: https://api.ovac.councilbox.com
    description: Production
components:
  schemas:
    GraphqlAgendaPostRequestBodyContentApplicationJsonSchemaVariables:
      type: object
      properties: {}
      description: GraphQL variables
      title: GraphqlAgendaPostRequestBodyContentApplicationJsonSchemaVariables
    08 - Remote Council Actions_agenda_Response_200:
      type: object
      properties: {}
      title: 08 - Remote Council Actions_agenda_Response_200
  securitySchemes:
    JwtToken:
      type: apiKey
      in: header
      name: x-jwt-token
      description: JWT token obtained from Login.

```

## Examples



**Request**

```json
{
  "query": "query Agenda (\r\n    $id: Int!\r\n\r\n){\r\n    agenda(\r\n        id: $id\r\n    ) {\r\n        id\r\n        subjectType\r\n        agendaSubject\r\n        votings {\r\n            id\r\n            vote\r\n        }\r\n    }\r\n}",
  "variables": {
    "id": 12345
  }
}
```

**Response**

```json
{
  "data": {
    "agenda": {
      "id": 91051,
      "subjectType": 9,
      "agendaSubject": "TEST API",
      "votings": [
        {
          "id": 40290,
          "vote": -1
        }
      ]
    }
  }
}
```

**SDK Code**

```python Request agenda information
import requests

url = "https://api.ovac.pre.councilbox.com/graphql/agenda"

payload = {
    "query": "query Agenda (
    $id: Int!

){
    agenda(
        id: $id
    ) {
        id
        subjectType
        agendaSubject
        votings {
            id
            vote
        }
    }
}",
    "variables": { "id": 12345 }
}
headers = {
    "x-jwt-token": "<apiKey>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript Request agenda information
const url = 'https://api.ovac.pre.councilbox.com/graphql/agenda';
const options = {
  method: 'POST',
  headers: {'x-jwt-token': '<apiKey>', 'Content-Type': 'application/json'},
  body: '{"query":"query Agenda (\r\n    $id: Int!\r\n\r\n){\r\n    agenda(\r\n        id: $id\r\n    ) {\r\n        id\r\n        subjectType\r\n        agendaSubject\r\n        votings {\r\n            id\r\n            vote\r\n        }\r\n    }\r\n}","variables":{"id":12345}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Request agenda information
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ovac.pre.councilbox.com/graphql/agenda"

	payload := strings.NewReader("{\n  \"query\": \"query Agenda (\\r\\n    $id: Int!\\r\\n\\r\\n){\\r\\n    agenda(\\r\\n        id: $id\\r\\n    ) {\\r\\n        id\\r\\n        subjectType\\r\\n        agendaSubject\\r\\n        votings {\\r\\n            id\\r\\n            vote\\r\\n        }\\r\\n    }\\r\\n}\",\n  \"variables\": {\n    \"id\": 12345\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-jwt-token", "<apiKey>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Request agenda information
require 'uri'
require 'net/http'

url = URI("https://api.ovac.pre.councilbox.com/graphql/agenda")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-jwt-token"] = '<apiKey>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"query\": \"query Agenda (\\r\\n    $id: Int!\\r\\n\\r\\n){\\r\\n    agenda(\\r\\n        id: $id\\r\\n    ) {\\r\\n        id\\r\\n        subjectType\\r\\n        agendaSubject\\r\\n        votings {\\r\\n            id\\r\\n            vote\\r\\n        }\\r\\n    }\\r\\n}\",\n  \"variables\": {\n    \"id\": 12345\n  }\n}"

response = http.request(request)
puts response.read_body
```

```java Request agenda information
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.ovac.pre.councilbox.com/graphql/agenda")
  .header("x-jwt-token", "<apiKey>")
  .header("Content-Type", "application/json")
  .body("{\n  \"query\": \"query Agenda (\\r\\n    $id: Int!\\r\\n\\r\\n){\\r\\n    agenda(\\r\\n        id: $id\\r\\n    ) {\\r\\n        id\\r\\n        subjectType\\r\\n        agendaSubject\\r\\n        votings {\\r\\n            id\\r\\n            vote\\r\\n        }\\r\\n    }\\r\\n}\",\n  \"variables\": {\n    \"id\": 12345\n  }\n}")
  .asString();
```

```php Request agenda information
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.ovac.pre.councilbox.com/graphql/agenda', [
  'body' => '{
  "query": "query Agenda (\\r\\n    $id: Int!\\r\\n\\r\\n){\\r\\n    agenda(\\r\\n        id: $id\\r\\n    ) {\\r\\n        id\\r\\n        subjectType\\r\\n        agendaSubject\\r\\n        votings {\\r\\n            id\\r\\n            vote\\r\\n        }\\r\\n    }\\r\\n}",
  "variables": {
    "id": 12345
  }
}',
  'headers' => [
    'Content-Type' => 'application/json',
    'x-jwt-token' => '<apiKey>',
  ],
]);

echo $response->getBody();
```

```csharp Request agenda information
using RestSharp;

var client = new RestClient("https://api.ovac.pre.councilbox.com/graphql/agenda");
var request = new RestRequest(Method.POST);
request.AddHeader("x-jwt-token", "<apiKey>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"query\": \"query Agenda (\\r\\n    $id: Int!\\r\\n\\r\\n){\\r\\n    agenda(\\r\\n        id: $id\\r\\n    ) {\\r\\n        id\\r\\n        subjectType\\r\\n        agendaSubject\\r\\n        votings {\\r\\n            id\\r\\n            vote\\r\\n        }\\r\\n    }\\r\\n}\",\n  \"variables\": {\n    \"id\": 12345\n  }\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift Request agenda information
import Foundation

let headers = [
  "x-jwt-token": "<apiKey>",
  "Content-Type": "application/json"
]
let parameters = [
  "query": "query Agenda (
    $id: Int!

){
    agenda(
        id: $id
    ) {
        id
        subjectType
        agendaSubject
        votings {
            id
            vote
        }
    }
}",
  "variables": ["id": 12345]
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.ovac.pre.councilbox.com/graphql/agenda")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```