Discusiones

REST API — Todos los endpoints requieren autenticación mediante Bearer token. Incluye Authorization: Bearer {token} en cada solicitud. Los tokens se gestionan en Configuración de GitScrum → API. Base URL: https://services.gitscrum.com — Todas las rutas de solicitud en esta documentación son relativas a esta URL base.

Las discusiones proporcionan canales de mensajería con hilos dentro de los proyectos para comunicación del equipo, toma de decisiones y compartición de conocimiento.

Listar todas las discusiones

Devuelve todas las discusiones de un proyecto.

GET /discussions/all?company_slug={slug}&project_slug={slug}

Parámetros de query

Listar canales

Devuelve los canales de discusión de un proyecto.

GET /discussions/channels?company_slug={slug}&project_slug={slug}

Ejemplo de solicitud

curl -X GET "https://services.gitscrum.com/discussions/channels?company_slug=acme&project_slug=web-app" \
  -H "Authorization: Bearer {token}"

Ejemplo de respuesta

{
  "data": [
    {
      "uuid": "e5f6a7b8-c9d0-1234-ef01-23456789abcd",
      "title": "Backend Architecture",
      "description": "Discuss API design and backend decisions",
      "messages_count": 47,
      "last_message": {
        "id": 892,
        "message": "Agreed. Let's go with the event-driven approach.",
        "user": {
          "username": "janedoe",
          "name": "Jane Doe"
        },
        "created_at": "2026-02-06T16:45:00Z"
      },
      "created_at": "2026-01-05T09:00:00Z"
    }
  ]
}

Obtener canal

Devuelve los detalles de un canal individual.

GET /discussions/channels/{uuid}?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Crear canal

Crea un nuevo canal de discusión.

POST /discussions/channels

Cuerpo de la solicitud

Ejemplo de solicitud

curl -X POST "https://services.gitscrum.com/discussions/channels" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Release Planning",
    "company_slug": "acme",
    "project_slug": "web-app",
    "description": "Coordinate release schedules and blockers"
  }'

Mensajes del canal

Devuelve los mensajes de un canal, con paginación basada en cursor.

GET /discussions/channels/{uuid}/messages?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Ejemplo de respuesta

{
  "data": [
    {
      "id": 893,
      "message": "Deployment to staging is complete.",
      "user": {
        "username": "johndoe",
        "name": "John Doe"
      },
      "created_at": "2026-02-07T10:00:00Z"
    }
  ]
}

Enviar mensaje

Envía un mensaje a un canal.

POST /discussions/channels/{uuid}/messages?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Cuerpo de la solicitud

Ejemplo de solicitud

curl -X POST "https://services.gitscrum.com/discussions/channels/e5f6a7b8-c9d0-1234-ef01-23456789abcd/messages?company_slug=acme&project_slug=web-app" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "QA sign-off received. Ready for production deploy."
  }'

Actualizar mensaje

Actualiza un mensaje existente.

PUT /discussions/messages/{id}?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Cuerpo de la solicitud

Eliminar mensaje

Elimina un mensaje.

DELETE /discussions/messages/{id}?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Actualizar canal

Actualiza un canal de discusión existente.

PUT /discussions/channels/{uuid}?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Cuerpo de la solicitud

Eliminar canal

Elimina un canal de discusión y todos sus mensajes.

DELETE /discussions/channels/{uuid}?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Buscar mensajes del canal

Busca mensajes dentro de un canal específico.

GET /discussions/channels/{uuid}/search?company_slug={slug}&project_slug={slug}&q={query}

Parámetros de ruta

Parámetros de query

Respuestas del hilo

Devuelve las respuestas de un mensaje específico.

GET /discussions/messages/{id}/replies?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Responder mensaje

Envía una respuesta a un mensaje específico, creando un hilo.

POST /discussions/messages/{id}/replies?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Cuerpo de la solicitud

Agregar reacción

Agrega una reacción a un mensaje.

POST /discussions/messages/{id}/reactions?company_slug={slug}&project_slug={slug}

Parámetros de ruta

Cuerpo de la solicitud

Marcar como leído

Marca todos los mensajes de un canal como leídos.

POST /discussions/channels/{uuid}/read?company_slug={slug}&project_slug={slug}

Referencia de campos

Canales

Mensajes