ByDomuDevelopers
Crear clave

Detalle de tarea

GEThttps://api.bydomu.com/v1/tasks/{id}

La tarea con su responsable, quién la creó, y el negocio y el contacto asociados.

Permiso
tasks:read
Claves
Solo secreta (desde un servidor)

Encabezados

X-API-Keystringobligatorio
Tu clave secreta.

Parámetros de ruta

idstringobligatorio
ID de la tarea

Respuestas

200La tarea
401UNAUTHORIZED · Clave faltante, inválida, desactivada o vencida.
403FORBIDDEN · La clave no puede usar esta operación: falta el scope, es una secreta en el navegador, el nivel de la cuenta no la permite, está suspendida o se alcanzó un tope del plan.
404NOT_FOUND · El recurso no existe en la organización.
429RATE_LIMITED · Límite de peticiones excedido: el de la clave (`RATE_LIMITED`), el de escrituras de la organización (`TENANT_RATE_LIMITED`) o bloqueo temporal de la IP por claves inválidas.
500INTERNAL_ERROR · Error interno del servidor.
cURL
curl "https://api.bydomu.com/v1/tasks/clx1tsk001" \
  -H "X-API-Key: $BYDOMU_API_KEY"
JavaScript
const res = await fetch("https://api.bydomu.com/v1/tasks/clx1tsk001", {
  headers: { "X-API-Key": process.env.BYDOMU_API_KEY },
});
const data = await res.json();
Python
import os, requests

r = requests.get(
    "https://api.bydomu.com/v1/tasks/clx1tsk001",
    headers={"X-API-Key": os.environ["BYDOMU_API_KEY"]}
)
data = r.json()
Respuesta · 200 · ejemplo
{
  "data": {
    "id": "clx1tsk001",
    "title": "Llamar a María para confirmar la visita",
    "description": "Confirmar el jueves a las 10.",
    "type": "CALL",
    "status": "PENDING",
    "priority": "LOW",
    "dueDate": "2026-10-01T15:00:00.000Z",
    "completedAt": "2026-10-01T14:40:00.000Z",
    "archivedAt": "2026-10-15T00:00:00.000Z",
    "attachments": [],
    "dealId": "clx1deal001",
    "contactId": "clx1con001",
    "assigneeId": "clx1usr001",
    "createdById": "clx1usr002",
    "createdAt": "2026-09-25T10:00:00.000Z",
    "updatedAt": "2026-09-25T10:00:00.000Z",
    "assignee": {
      "id": "clx1usr001",
      "firstName": "Carlos",
      "lastName": "Rodríguez",
      "avatarUrl": "https://cdn.bydomu.com/avatars/carlos.jpg"
    },
    "createdBy": {
      "id": "clx1usr001",
      "firstName": "Carlos",
      "lastName": "Rodríguez"
    },
    "deal": {
      "id": "clx1deal001",
      "title": "Venta Apto Chapinero",
      "contact": {
        "id": "clx1con001",
        "firstName": "María",
        "lastName": "González"
      }
    },
    "contact": {
      "id": "clx1con001",
      "firstName": "María",
      "lastName": "González"
    }
  }
  …

La clave va en la variable BYDOMU_API_KEY. Los datos del ejemplo no son de ninguna inmobiliaria.