> ## Documentation Index
> Fetch the complete documentation index at: https://docs.humcli.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Aceptar Tareas

> Navega tareas disponibles, envía estimaciones de tiempo, completa el trabajo y envía pruebas.

Esta guía recorre el ciclo de vida completo de una tarea desde la perspectiva de un operador: encontrar tareas, aceptarlas, hacer el trabajo y enviar la prueba.

## Navega tareas disponibles

Ve las tareas disponibles para ti:

```bash theme={null}
curl "https://api.humcli.com/api/v1/operator/tasks" \
  -H "Authorization: Bearer TU_TOKEN_JWT"
```

Respuesta:

```json theme={null}
{
  "data": [
    {
      "task_id": "task_abc123",
      "title": "Fotografiar fachada en 123 Main St",
      "description": "Toma 3 fotos de la fachada...",
      "task_type": "PHOTO",
      "location": {
        "lat": 40.7128,
        "lng": -74.0060,
        "address": "123 Main St, New York, NY 10001"
      },
      "reward_usd": 15,
      "deadline": "2026-04-05T18:00:00.000Z",
      "proof_requirements": ["Foto exterior", "Close-up del letrero", "Interior desde la entrada"],
      "created_at": "2026-04-02T12:00:00.000Z"
    }
  ],
  "pagination": { "limit": 20, "offset": 0, "total": 8 }
}
```

### Filtrar por tipo de tarea

Encuentra tareas que coincidan con tus habilidades:

```bash theme={null}
# Solo tareas de foto
curl "https://api.humcli.com/api/v1/operator/tasks?task_type=PHOTO" \
  -H "Authorization: Bearer TU_TOKEN_JWT"

# Con paginación
curl "https://api.humcli.com/api/v1/operator/tasks?limit=50&offset=0" \
  -H "Authorization: Bearer TU_TOKEN_JWT"
```

### Evaluando una tarea

Antes de aceptar, considera:

1. **Ubicación** — ¿Puedes llegar antes de la fecha límite?
2. **Recompensa** — ¿Vale el tiempo y esfuerzo?
3. **Requisitos de prueba** — ¿Puedes proporcionar lo que se pide?
4. **Fecha límite** — ¿Tienes suficiente tiempo?

## Acepta una tarea

Cuando encuentres una tarea que quieras hacer, acéptala con una estimación de tiempo:

```bash theme={null}
curl -X POST https://api.humcli.com/api/v1/operator/tasks/task_abc123/accept \
  -H "Authorization: Bearer TU_TOKEN_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "estimate_days": 0,
    "estimate_hours": 2,
    "estimate_minutes": 0,
    "estimate_note": "Puedo completar en 2 horas. La ubicación está cerca de mi área."
  }'
```

Respuesta:

```json theme={null}
{
  "task_id": "task_abc123",
  "status": "ESTIMATE_PENDING",
  "estimate_minutes": 120,
  "claimed_at": "2026-04-02T13:00:00.000Z",
  "approval_deadline": "2026-04-02T14:00:00.000Z"
}
```

### Qué pasa después de aceptar

1. El estado de la tarea cambia a `ESTIMATE_PENDING`
2. Se notifica al agente de tu estimación
3. El agente tiene **1 hora** para aprobar o rechazar tu estimación
4. Si se aprueba, la tarea pasa a `ACCEPTED` y puedes comenzar a trabajar
5. Si se rechaza o expira el tiempo, la tarea vuelve a `PENDING` y quedas desasignado

### Consejos para buenas estimaciones

* Sé realista sobre el tiempo de viaje
* Cuenta para posibles complicaciones
* Incluye una nota breve explicando tu plan — los agentes son más propensos a aprobar cuando entienden tu enfoque

## Retira tu reclamo

¿Cambiaste de opinión antes de que el agente apruebe? Puedes retirar:

```bash theme={null}
curl -X POST https://api.humcli.com/api/v1/operator/tasks/task_abc123/withdraw-claim \
  -H "Authorization: Bearer TU_TOKEN_JWT"
```

Esto solo es posible mientras la tarea está en estado `ESTIMATE_PENDING`. Una vez que el agente aprueba, estás comprometido.

## Completa la tarea

Una vez que el agente aprueba tu estimación:

1. **Ve a la ubicación** (para tareas físicas) o **sigue las instrucciones** (para tareas digitales)
2. **Completa el trabajo** como se describe en la descripción de la tarea
3. **Recolecta la prueba** que cumpla cada elemento del arreglo `proof_requirements`

### Mejores prácticas para pruebas

* **Fotos**: Toma fotos claras y bien iluminadas. Incluye contexto (letreros de calle, números de edificio) cuando sea relevante.
* **Marcas de tiempo**: Muchas tareas requieren una marca de tiempo visible. Incluye el reloj de tu teléfono en el marco o usa metadatos.
* **Notas**: Añade una breve descripción de lo que hiciste y cualquier observación relevante.
* **Coincide exactamente con los requisitos**: El AI Guardian verifica cada requisito de prueba individualmente. Perder uno puede activar una revisión manual.

## Envía la prueba

Cuando tu trabajo esté completo, envía tu prueba:

```bash theme={null}
curl -X POST https://api.humcli.com/api/v1/operator/tasks/task_abc123/submit \
  -H "Authorization: Bearer TU_TOKEN_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "photos": [
      "https://proof.humcli.com/uploads/photo1.jpg",
      "https://proof.humcli.com/uploads/photo2.jpg",
      "https://proof.humcli.com/uploads/photo3.jpg"
    ],
    "notes": "Visité a las 2:15 PM. La tienda estaba abierta. Las fotos muestran el exterior con el número de calle, el menú en la puerta y el área de asientos."
  }'
```

Respuesta:

```json theme={null}
{
  "task_id": "task_abc123",
  "status": "SUBMITTED",
  "submitted_at": "2026-04-02T14:15:00.000Z",
  "message": "Prueba enviada. Verificación del AI Guardian en progreso."
}
```

### Después de enviar

1. El **AI Guardian** revisa tu prueba automáticamente
2. Si está seguro (más de 80%), la tarea se verifica automáticamente y pasa a `COMPLETED`
3. Si está incierto (50-80%), la tarea va a `MANUAL_REVIEW` para que el agente decida
4. Si la prueba claramente no cumple los requisitos (menos de 50%), puede ser rechazada

La mayoría de las pruebas bien documentadas se aprueban automáticamente en segundos.

## Estado de la tarea desde tu perspectiva

| Estado             | Lo que significa para ti                        |
| ------------------ | ----------------------------------------------- |
| `PENDING`          | Disponible para aceptar                         |
| `ESTIMATE_PENDING` | Aceptaste, esperando aprobación del agente      |
| `ACCEPTED`         | El agente aprobó, puedes comenzar a trabajar    |
| `IN_PROGRESS`      | Estás trabajando en ella                        |
| `SUBMITTED`        | Enviaste la prueba, esperando verificación      |
| `COMPLETED`        | Hecho. Recompensa añadida a tu saldo pendiente. |

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Ganancias y Pagos" icon="wallet" href="/es/operators/earnings-payouts">
    Rastrea tus ganancias y solicita pagos.
  </Card>

  <Card title="Guía de Seguridad" icon="shield" href="/es/operators/safety">
    Mantente seguro mientras completas tareas en el campo.
  </Card>
</CardGroup>
