# Upwork

> Upwork. 19 herramientas, con sus parámetros y ejemplos de llamada.

Source: https://piqline.com/es/docs/api/reference/upwork

Herramientas del agente de Upwork: ofertas públicas leídas, puntuadas y respondidas a partir de la base de conocimiento del workspace. No se envía nada a Upwork.

Cada llamada es una petición `POST` con la clave en `Authorization: Bearer`. El cuerpo JSON es la entrada de la herramienta, y la respuesta tiene la forma `{ "tool": "nom", "output": … }`. Los ejemplos solo incluyen los parámetros obligatorios. Las descripciones de los parámetros son las que leen los agentes.

### `searchUpworkJobs`

Lee una página de resultados públicos (unas diez ofertas) y puntúa cada oferta frente a la base de conocimiento. Las ofertas se añaden al pipeline del workspace.

`POST https://piqline.com/api/v1/tools/searchUpworkJobs`

Tipo: Lectura en directo. Scopes: `explore`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `q` | `string` | Sí | Keywords as a client would write them in a job post, e.g. 'next.js developer' |
| `jobType` | `any \| hourly \| fixed` | No |  |
| `hourlyMin` | `integer` | No | Hourly rate floor in USD |
| `hourlyMax` | `integer` | No |  |
| `fixedMin` | `integer` | No | Fixed-price budget floor in USD |
| `fixedMax` | `integer` | No |  |
| `experience` | `array<entry \| intermediate \| expert>` | No |  |
| `proposals` | `array<0-4 \| 5-9 \| 10-14 \| 15-19 \| 20-49>` | No | Keep only jobs with this many proposals so far (less competition) |
| `clientHires` | `array<0 \| 1-9 \| 10+>` | No |  |
| `page` | `integer` | No |  |
| `score` | `boolean` | No | Score each job against the knowledge base (judge capped at 12 per call) |
| `persist` | `boolean` | No | Add the jobs to the workspace pipeline (upwork_pipeline) |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/searchUpworkJobs \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"levée de fonds"}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/searchUpworkJobs", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "q": "levée de fonds"
  }),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/searchUpworkJobs",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "q": "levée de fonds",
    },
)
output = response.json()["output"]
```

### `getUpworkJob`

Lee una oferta: descripción, habilidades, presupuesto, actividad, cliente. Añade una instantánea fechada al pipeline.

`POST https://piqline.com/api/v1/tools/getUpworkJob`

Tipo: Lectura en directo. Scopes: `explore`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `url` | `string` | Sí |  |
| `score` | `boolean` | No |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/getUpworkJob \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://exemple.fr/article"}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/getUpworkJob", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "url": "https://exemple.fr/article"
  }),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/getUpworkJob",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "url": "https://exemple.fr/article",
    },
)
output = response.json()["output"]
```

### `scoreUpworkJobs`

Vuelve a puntuar las ofertas del pipeline tras un cambio en la base de conocimiento. No se lee ninguna página.

`POST https://piqline.com/api/v1/tools/scoreUpworkJobs`

Tipo: Escritura. Scopes: `write`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `jobIds` | `array<string>` | Sí |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/scoreUpworkJobs \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jobIds":["texte"]}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/scoreUpworkJobs", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "jobIds": [
      "texte"
    ]
  }),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/scoreUpworkJobs",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "jobIds": [
            "texte",
        ],
    },
)
output = response.json()["output"]
```

### `getUpworkRadar`

Radar de mercado: volumen por día, cuartiles de tarifa y presupuesto, habilidades, competencia, países de los clientes.

`POST https://piqline.com/api/v1/tools/getUpworkRadar`

Tipo: Lectura en directo. Scopes: `explore`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `search` | `object` | No |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/getUpworkRadar \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/getUpworkRadar", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/getUpworkRadar",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={},
)
output = response.json()["output"]
```

### `listUpworkLeads`

Pipeline de Upwork: recuento por estado, mejores ofertas primero, resultado de cada una.

`POST https://piqline.com/api/v1/tools/listUpworkLeads`

Tipo: Lectura. Scopes: `read`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `status` | `array<new \| shortlisted \| drafted \| submitted \| viewed \| replied \| interview \| won \| …>` | No |  |
| `minScore` | `integer` | No |  |
| `limit` | `integer` | No |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/listUpworkLeads \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/listUpworkLeads", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/listUpworkLeads",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={},
)
output = response.json()["output"]
```

### `updateUpworkLead`

Cambia el estado de una oferta del pipeline (enviada, respuesta, entrevista, ganada, perdida, ignorada) y guarda una nota.

`POST https://piqline.com/api/v1/tools/updateUpworkLead`

Tipo: Escritura. Scopes: `write`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `jobId` | `string` | Sí |  |
| `status` | `new \| shortlisted \| drafted \| submitted \| viewed \| replied \| interview \| won \| …` | Sí |  |
| `note` | `string` | No |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/updateUpworkLead \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jobId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70","status":"new"}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/updateUpworkLead", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "jobId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
    "status": "new"
  }),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/updateUpworkLead",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "jobId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
        "status": "new",
    },
)
output = response.json()["output"]
```

### `getUpworkKnowledge`

Base de conocimiento de Upwork del workspace: servicios, herramientas, proyectos que evitar, tarifas mínimas, casos de estudio, tono, firma.

`POST https://piqline.com/api/v1/tools/getUpworkKnowledge`

Tipo: Lectura. Scopes: `read`.

Esta herramienta no tiene parámetros: envía un cuerpo vacío, `{}`.

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/getUpworkKnowledge \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/getUpworkKnowledge", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/getUpworkKnowledge",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={},
)
output = response.json()["output"]
```

### `updateUpworkKnowledge`

Actualiza la base de conocimiento. Las listas que envías sustituyen a las listas almacenadas.

`POST https://piqline.com/api/v1/tools/updateUpworkKnowledge`

Tipo: Escritura. Scopes: `write`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `name` | `string` | No |  |
| `headline` | `string` | No |  |
| `services` | `array<string>` | No |  |
| `tools` | `array<string>` | No |  |
| `avoid` | `array<string>` | No | Kinds of projects to never bid on, as short phrases or keywords |
| `languages` | `array<string>` | No |  |
| `hourlyMin` | `number` | No | Lowest acceptable hourly rate, USD |
| `fixedMin` | `number` | No | Lowest acceptable fixed budget, USD |
| `freelancerCountry` | `string` | No |  |
| `caseStudies` | `array<object>` | No |  |
| `examples` | `array<object>` | No |  |
| `tone` | `string` | No |  |
| `signature` | `string` | No |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/updateUpworkKnowledge \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/updateUpworkKnowledge", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/updateUpworkKnowledge",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={},
)
output = response.json()["output"]
```

### `listUpworkTemplates`

Plantillas de propuesta guardadas, con sus campos y sus reglas de preguntas.

`POST https://piqline.com/api/v1/tools/listUpworkTemplates`

Tipo: Lectura. Scopes: `read`.

Esta herramienta no tiene parámetros: envía un cuerpo vacío, `{}`.

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/listUpworkTemplates \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/listUpworkTemplates", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/listUpworkTemplates",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={},
)
output = response.json()["output"]
```

### `upsertUpworkTemplate`

Crea o actualiza una plantilla de propuesta.

`POST https://piqline.com/api/v1/tools/upsertUpworkTemplate`

Tipo: Escritura. Scopes: `write`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `id` | `string` | Sí | Stable slug; reuse it to update |
| `name` | `string` | Sí |  |
| `body` | `string` | Sí | Literal text kept word for word. { {instruction} } = filled per job by the writer. { {var:job.title} } etc. = filled by code. |
| `questionRules` | `array<object>` | No |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/upsertUpworkTemplate \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70","name":"texte","body":"texte"}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/upsertUpworkTemplate", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "id": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
    "name": "texte",
    "body": "texte"
  }),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/upsertUpworkTemplate",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "id": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
        "name": "texte",
        "body": "texte",
    },
)
output = response.json()["output"]
```

### `draftUpworkProposal`

Redacta una propuesta para una oferta a partir de una plantilla. El texto lo pegas tú mismo en Upwork.

`POST https://piqline.com/api/v1/tools/draftUpworkProposal`

Tipo: Escritura. Scopes: `write`, `explore`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `url` | `string` | No | Upwork job URL |
| `jobId` | `string` | No | Job id already in the pipeline, e.g. ~022113077029286601014 |
| `templateId` | `string` | No | Template id or name; default = first saved template, else the built-in one |
| `screeningQuestions` | `array<string>` | No | Screening questions copied verbatim from the job |
| `extraInstructions` | `string` | No |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/draftUpworkProposal \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/draftUpworkProposal", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/draftUpworkProposal",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={},
)
output = response.json()["output"]
```

### `listUpworkCampaigns`

Campañas guardadas: búsqueda, puntuación mínima, estado, última actualización, estado de las fuentes.

`POST https://piqline.com/api/v1/tools/listUpworkCampaigns`

Tipo: Lectura. Scopes: `read`.

Esta herramienta no tiene parámetros: envía un cuerpo vacío, `{}`.

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/listUpworkCampaigns \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/listUpworkCampaigns", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/listUpworkCampaigns",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={},
)
output = response.json()["output"]
```

### `saveUpworkCampaign`

Crea o actualiza una campaña: nombre, búsqueda, puntuación mínima, plantilla.

`POST https://piqline.com/api/v1/tools/saveUpworkCampaign`

Tipo: Escritura. Scopes: `write`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `id` | `string` | No | Stable slug; reuse it to update an existing campaign |
| `name` | `string` | Sí |  |
| `search` | `object` | Sí |  |
| `minScore` | `integer` | No |  |
| `templateId` | `string` | No |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/saveUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"texte","search":{"q":"levée de fonds"}}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/saveUpworkCampaign", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "name": "texte",
    "search": {
      "q": "levée de fonds"
    }
  }),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/saveUpworkCampaign",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "name": "texte",
        "search": {
            "q": "levée de fonds",
        },
    },
)
output = response.json()["output"]
```

### `simulateUpworkCampaign`

Simula una campaña con ofertas reales antes de seguirla. No se guarda nada.

`POST https://piqline.com/api/v1/tools/simulateUpworkCampaign`

Tipo: Lectura en directo. Scopes: `explore`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `campaignId` | `string` | No |  |
| `campaign` | `object` | No |  |
| `pages` | `integer` | No |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/simulateUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/simulateUpworkCampaign", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/simulateUpworkCampaign",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={},
)
output = response.json()["output"]
```

### `followUpworkCampaign`

Pide al Motor que siga una campaña guardada, a su ritmo de recogida.

`POST https://piqline.com/api/v1/tools/followUpworkCampaign`

Tipo: Acción. Scopes: `act`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `campaignId` | `string` | Sí |  |
| `name` | `string` | No | Nom de la campagne, pour la carte de confirmation. |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/followUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaignId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70"}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/followUpworkCampaign", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "campaignId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70"
  }),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/followUpworkCampaign",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "campaignId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
    },
)
output = response.json()["output"]
```

### `pauseUpworkCampaign`

Hace que el Motor deje de seguir una campaña. Las ofertas ya vistas permanecen en el pipeline.

`POST https://piqline.com/api/v1/tools/pauseUpworkCampaign`

Tipo: Acción. Scopes: `act`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `campaignId` | `string` | Sí |  |
| `name` | `string` | No | Nom de la campagne, pour la carte de confirmation. |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/pauseUpworkCampaign \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaignId":"5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70"}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/pauseUpworkCampaign", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "campaignId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70"
  }),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/pauseUpworkCampaign",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={
        "campaignId": "5a0e9c1f-2b7d-4e63-8f14-d3c8a6b92e70",
    },
)
output = response.json()["output"]
```

### `refreshUpworkCampaigns`

Actualiza las campañas seguidas: fusiona las ofertas recogidas por el Motor, vuelve a leer la primera página en directo y puntúa las ofertas nuevas.

`POST https://piqline.com/api/v1/tools/refreshUpworkCampaigns`

Tipo: Escritura. Scopes: `write`, `explore`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `campaignId` | `string` | No |  |
| `live` | `boolean` | No |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/refreshUpworkCampaigns \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/refreshUpworkCampaigns", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/refreshUpworkCampaigns",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={},
)
output = response.json()["output"]
```

### `checkUpworkOutcomes`

Vuelve a leer las páginas de las candidaturas en curso para fechar su resultado: cerrada, entrevistas iniciadas, sin respuesta.

`POST https://piqline.com/api/v1/tools/checkUpworkOutcomes`

Tipo: Escritura. Scopes: `write`, `explore`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `jobIds` | `array<string>` | No |  |
| `limit` | `integer` | No |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/checkUpworkOutcomes \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/checkUpworkOutcomes", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/checkUpworkOutcomes",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={},
)
output = response.json()["output"]
```

### `syncUpworkReplies`

Lee los correos de notificación de Upwork en las bandejas conectadas del creador de la clave y hace avanzar el estado de las ofertas del pipeline.

`POST https://piqline.com/api/v1/tools/syncUpworkReplies`

Tipo: Escritura. Scopes: `write`.

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `accountId` | `string` | No |  |
| `limit` | `integer` | No |  |

```bash tab="curl"
curl -s https://piqline.com/api/v1/tools/syncUpworkReplies \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```
```javascript tab="JavaScript"
const response = await fetch("https://piqline.com/api/v1/tools/syncUpworkReplies", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.PIQLINE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({}),
});
const { output } = await response.json();
```
```python tab="Python"
import os
import requests

response = requests.post(
    "https://piqline.com/api/v1/tools/syncUpworkReplies",
    headers={"Authorization": "Bearer " + os.environ["PIQLINE_API_KEY"]},
    json={},
)
output = response.json()["output"]
```
