# Upwork

> Upwork. 19 tool, con i loro parametri ed esempi di chiamata.

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

Tool dell'agente Upwork: offerte pubbliche lette, valutate e riscontrate a partire dalla knowledge base del workspace. Nulla viene inviato a Upwork.

Ogni chiamata è una richiesta `POST` con la chiave in `Authorization: Bearer`. Il corpo JSON è l'input del tool, e la risposta ha la forma `{ "tool": "nom", "output": … }`. Gli esempi contengono solo i parametri obbligatori. Le descrizioni dei parametri sono quelle che leggono gli agenti.

### `searchUpworkJobs`

Legge una pagina di risultati pubblici (una decina di offerte) e valuta ciascuna offerta rispetto alla knowledge base. Le offerte vengono aggiunte alla pipeline del workspace.

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

Tipo: Lettura in diretta. Scope: `explore`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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`

Legge un'offerta: descrizione, competenze, budget, attività, cliente. Aggiunge alla pipeline un'istantanea datata.

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

Tipo: Lettura in diretta. Scope: `explore`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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`

Rivaluta le offerte della pipeline dopo una modifica della knowledge base. Nessuna pagina viene letta.

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

Tipo: Scrittura. Scope: `write`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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 di mercato: volume al giorno, quartili di tariffa e di budget, competenze, concorrenza, paesi dei clienti.

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

Tipo: Lettura in diretta. Scope: `explore`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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 Upwork: conteggio per stato, prima le migliori offerte, esito di ciascuna.

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

Tipo: Lettura. Scope: `read`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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`

Modifica lo stato di un'offerta della pipeline (inviata, risposta, colloquio, vinta, persa, ignorata) e conserva una nota.

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

Tipo: Scrittura. Scope: `write`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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`

Knowledge base Upwork del workspace: servizi, strumenti, progetti da evitare, tariffe minime, casi di studio, tono, firma.

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

Tipo: Lettura. Scope: `read`.

Questo tool non ha parametri: invia un corpo vuoto, `{}`.

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

Aggiorna la knowledge base. Gli elenchi che invii sostituiscono quelli memorizzati.

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

Tipo: Scrittura. Scope: `write`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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`

Modelli di proposta salvati, con i loro slot e le loro regole per le domande.

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

Tipo: Lettura. Scope: `read`.

Questo tool non ha parametri: invia un corpo vuoto, `{}`.

```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 aggiorna un modello di proposta.

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

Tipo: Scrittura. Scope: `write`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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`

Redige una bozza di proposta per un'offerta a partire da un modello. Incolli tu stesso il testo su Upwork.

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

Tipo: Scrittura. Scope: `write`, `explore`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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`

Campagne salvate: ricerca, punteggio minimo, stato, ultimo aggiornamento, stato delle fonti.

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

Tipo: Lettura. Scope: `read`.

Questo tool non ha parametri: invia un corpo vuoto, `{}`.

```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 aggiorna una campagna: nome, ricerca, punteggio minimo, modello.

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

Tipo: Scrittura. Scope: `write`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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 campagna su offerte reali prima di seguirla. Nulla viene salvato.

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

Tipo: Lettura in diretta. Scope: `explore`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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`

Chiede al Motor di seguire una campagna salvata, al suo ritmo di raccolta.

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

Tipo: Azione. Scope: `act`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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`

Impedisce al Motor di seguire una campagna. Le offerte già viste restano nella pipeline.

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

Tipo: Azione. Scope: `act`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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`

Aggiorna le campagne seguite: unisce le offerte raccolte dal Motor, rilegge in diretta la prima pagina, valuta le nuove offerte.

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

Tipo: Scrittura. Scope: `write`, `explore`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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`

Rilegge le pagine delle candidature in corso per datare il loro esito: chiusa, colloqui avviati, nessuna risposta.

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

Tipo: Scrittura. Scope: `write`, `explore`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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`

Legge le e-mail di notifica di Upwork nelle caselle collegate del creatore della chiave e fa avanzare lo stato delle offerte della pipeline.

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

Tipo: Scrittura. Scope: `write`.

| Parametro | Tipo | Obbligatorio | Descrizione |
| --- | --- | --- | --- |
| `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"]
```
