# Upwork

> Upwork. 19 ferramentas, com seus parâmetros e exemplos de chamada.

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

Ferramentas do agente Upwork: vagas públicas lidas, pontuadas e respondidas a partir da base de conhecimento do workspace. Nada é enviado ao Upwork.

Cada chamada é uma requisição `POST` com a chave em `Authorization: Bearer`. O corpo JSON é a entrada da ferramenta, e a resposta tem o formato `{ "tool": "nom", "output": … }`. Os exemplos trazem apenas os parâmetros obrigatórios. As descrições dos parâmetros são as que os agentes leem.

### `searchUpworkJobs`

Lê uma página de resultados públicos (cerca de dez vagas) e pontua cada vaga em relação à base de conhecimento. As vagas são adicionadas ao pipeline do workspace.

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

Tipo: Leitura ao vivo. Scopes: `explore`.

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `q` | `string` | Sim | Keywords as a client would write them in a job post, e.g. 'next.js developer' |
| `jobType` | `any \| hourly \| fixed` | Não |  |
| `hourlyMin` | `integer` | Não | Hourly rate floor in USD |
| `hourlyMax` | `integer` | Não |  |
| `fixedMin` | `integer` | Não | Fixed-price budget floor in USD |
| `fixedMax` | `integer` | Não |  |
| `experience` | `array<entry \| intermediate \| expert>` | Não |  |
| `proposals` | `array<0-4 \| 5-9 \| 10-14 \| 15-19 \| 20-49>` | Não | Keep only jobs with this many proposals so far (less competition) |
| `clientHires` | `array<0 \| 1-9 \| 10+>` | Não |  |
| `page` | `integer` | Não |  |
| `score` | `boolean` | Não | Score each job against the knowledge base (judge capped at 12 per call) |
| `persist` | `boolean` | Não | 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`

Lê uma vaga: descrição, habilidades, orçamento, atividade, cliente. Adiciona um instantâneo datado ao pipeline.

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

Tipo: Leitura ao vivo. Scopes: `explore`.

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `url` | `string` | Sim |  |
| `score` | `boolean` | Não |  |

```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`

Pontua de novo as vagas do pipeline após uma mudança na base de conhecimento. Nenhuma página é lida.

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

Tipo: Escrita. Scopes: `write`.

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `jobIds` | `array<string>` | Sim |  |

```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: volume por dia, quartis de valor por hora e de orçamento, habilidades, concorrência, países dos clientes.

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

Tipo: Leitura ao vivo. Scopes: `explore`.

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `search` | `object` | Não |  |

```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 do Upwork: contagem por status, melhores vagas primeiro, desfecho de cada uma.

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

Tipo: Leitura. Scopes: `read`.

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `status` | `array<new \| shortlisted \| drafted \| submitted \| viewed \| replied \| interview \| won \| …>` | Não |  |
| `minScore` | `integer` | Não |  |
| `limit` | `integer` | Não |  |

```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`

Altera o status de uma vaga do pipeline (enviada, resposta, entrevista, ganha, perdida, ignorada) e guarda uma nota.

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

Tipo: Escrita. Scopes: `write`.

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `jobId` | `string` | Sim |  |
| `status` | `new \| shortlisted \| drafted \| submitted \| viewed \| replied \| interview \| won \| …` | Sim |  |
| `note` | `string` | Não |  |

```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 conhecimento Upwork do workspace: serviços, ferramentas, projetos a evitar, valores mínimos, estudos de caso, tom, assinatura.

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

Tipo: Leitura. Scopes: `read`.

Esta ferramenta não recebe parâmetros: envie um corpo vazio, `{}`.

```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`

Atualiza a base de conhecimento. As listas que você envia substituem as listas armazenadas.

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

Tipo: Escrita. Scopes: `write`.

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `name` | `string` | Não |  |
| `headline` | `string` | Não |  |
| `services` | `array<string>` | Não |  |
| `tools` | `array<string>` | Não |  |
| `avoid` | `array<string>` | Não | Kinds of projects to never bid on, as short phrases or keywords |
| `languages` | `array<string>` | Não |  |
| `hourlyMin` | `number` | Não | Lowest acceptable hourly rate, USD |
| `fixedMin` | `number` | Não | Lowest acceptable fixed budget, USD |
| `freelancerCountry` | `string` | Não |  |
| `caseStudies` | `array<object>` | Não |  |
| `examples` | `array<object>` | Não |  |
| `tone` | `string` | Não |  |
| `signature` | `string` | Não |  |

```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`

Modelos de proposta salvos, com seus slots e suas regras de perguntas.

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

Tipo: Leitura. Scopes: `read`.

Esta ferramenta não recebe parâmetros: envie um corpo vazio, `{}`.

```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`

Cria ou atualiza um modelo de proposta.

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

Tipo: Escrita. Scopes: `write`.

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | `string` | Sim | Stable slug; reuse it to update |
| `name` | `string` | Sim |  |
| `body` | `string` | Sim | Literal text kept word for word. { {instruction} } = filled per job by the writer. { {var:job.title} } etc. = filled by code. |
| `questionRules` | `array<object>` | Não |  |

```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`

Redige uma proposta para uma vaga a partir de um modelo. Você mesmo cola o texto no Upwork.

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

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

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `url` | `string` | Não | Upwork job URL |
| `jobId` | `string` | Não | Job id already in the pipeline, e.g. ~022113077029286601014 |
| `templateId` | `string` | Não | Template id or name; default = first saved template, else the built-in one |
| `screeningQuestions` | `array<string>` | Não | Screening questions copied verbatim from the job |
| `extraInstructions` | `string` | Não |  |

```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`

Campanhas salvas: pesquisa, pontuação mínima, status, última atualização, saúde das fontes.

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

Tipo: Leitura. Scopes: `read`.

Esta ferramenta não recebe parâmetros: envie um corpo vazio, `{}`.

```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`

Cria ou atualiza uma campanha: nome, pesquisa, pontuação mínima, modelo.

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

Tipo: Escrita. Scopes: `write`.

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | `string` | Não | Stable slug; reuse it to update an existing campaign |
| `name` | `string` | Sim |  |
| `search` | `object` | Sim |  |
| `minScore` | `integer` | Não |  |
| `templateId` | `string` | Não |  |

```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 uma campanha em vagas reais antes de acompanhá-la. Nada é salvo.

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

Tipo: Leitura ao vivo. Scopes: `explore`.

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `campaignId` | `string` | Não |  |
| `campaign` | `object` | Não |  |
| `pages` | `integer` | Não |  |

```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`

Pede ao Motor que acompanhe uma campanha salva, no ritmo de coleta dela.

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

Tipo: Ação. Scopes: `act`.

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `campaignId` | `string` | Sim |  |
| `name` | `string` | Não | 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`

Faz o Motor parar de acompanhar uma campanha. As vagas já vistas permanecem no pipeline.

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

Tipo: Ação. Scopes: `act`.

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `campaignId` | `string` | Sim |  |
| `name` | `string` | Não | 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`

Atualiza as campanhas acompanhadas: mescla as vagas coletadas pelo Motor, lê de novo a primeira página ao vivo, pontua as novas vagas.

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

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

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `campaignId` | `string` | Não |  |
| `live` | `boolean` | Não |  |

```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`

Lê de novo as páginas das candidaturas em andamento para datar o desfecho: encerrada, entrevistas iniciadas, sem resposta.

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

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

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `jobIds` | `array<string>` | Não |  |
| `limit` | `integer` | Não |  |

```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`

Lê os e-mails de notificação do Upwork nas caixas de entrada conectadas do criador da chave e avança o status das vagas do pipeline.

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

Tipo: Escrita. Scopes: `write`.

| Parâmetro | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `accountId` | `string` | Não |  |
| `limit` | `integer` | Não |  |

```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"]
```
