# Upwork

> Upwork。19 个工具，附参数和调用示例。

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

Upwork 智能体的工具：读取公开职位，并依据工作区知识库对其评分和答复。不会向 Upwork 发送任何内容。

每次调用都是一个 `POST` 请求，密钥放在 `Authorization: Bearer` 中。JSON 请求体是工具的输入，响应形如 `{ "tool": "nom", "output": … }`。示例中只包含必填参数。参数说明与智能体读到的相同。

### `searchUpworkJobs`

读取一页公开结果（约十个职位），并对照知识库为每个职位评分。这些职位会加入工作区的管道。

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

类型：实时读取。Scope：`explore`。

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

读取一个职位：描述、技能、预算、活跃度、客户。向管道中添加一份带日期的快照。

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

类型：实时读取。Scope：`explore`。

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `url` | `string` | 是 |  |
| `score` | `boolean` | 否 |  |

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

知识库更改后，重新为管道中的职位评分。不读取任何页面。

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

类型：写入。Scope：`write`。

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `jobIds` | `array<string>` | 是 |  |

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

市场雷达：每日数量、费率和预算四分位数、技能、竞争情况、客户所在国家。

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

类型：实时读取。Scope：`explore`。

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `search` | `object` | 否 |  |

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

Upwork 管道：各状态的数量、最佳职位在前、每个职位的结果。

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

类型：读取。Scope：`read`。

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `status` | `array<new \| shortlisted \| drafted \| submitted \| viewed \| replied \| interview \| won \| …>` | 否 |  |
| `minScore` | `integer` | 否 |  |
| `limit` | `integer` | 否 |  |

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

更改管道中某个职位的状态（已发送、已回复、面试、赢得、丢失、已忽略），并保留一条备注。

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

类型：写入。Scope：`write`。

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `jobId` | `string` | 是 |  |
| `status` | `new \| shortlisted \| drafted \| submitted \| viewed \| replied \| interview \| won \| …` | 是 |  |
| `note` | `string` | 否 |  |

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

工作区的 Upwork 知识库：服务、工具、应避开的项目、最低费率、案例、语气、签名。

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

类型：读取。Scope：`read`。

该工具没有参数：发送空请求体 `{}`。

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

更新知识库。你发送的列表会替换已保存的列表。

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

类型：写入。Scope：`write`。

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `name` | `string` | 否 |  |
| `headline` | `string` | 否 |  |
| `services` | `array<string>` | 否 |  |
| `tools` | `array<string>` | 否 |  |
| `avoid` | `array<string>` | 否 | Kinds of projects to never bid on, as short phrases or keywords |
| `languages` | `array<string>` | 否 |  |
| `hourlyMin` | `number` | 否 | Lowest acceptable hourly rate, USD |
| `fixedMin` | `number` | 否 | Lowest acceptable fixed budget, USD |
| `freelancerCountry` | `string` | 否 |  |
| `caseStudies` | `array<object>` | 否 |  |
| `examples` | `array<object>` | 否 |  |
| `tone` | `string` | 否 |  |
| `signature` | `string` | 否 |  |

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

已保存的提案模板，包含其占位符和提问规则。

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

类型：读取。Scope：`read`。

该工具没有参数：发送空请求体 `{}`。

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

创建或更新提案模板。

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

类型：写入。Scope：`write`。

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `id` | `string` | 是 | Stable slug; reuse it to update |
| `name` | `string` | 是 |  |
| `body` | `string` | 是 | Literal text kept word for word. { {instruction} } = filled per job by the writer. { {var:job.title} } etc. = filled by code. |
| `questionRules` | `array<object>` | 否 |  |

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

依据模板为某个职位起草提案。文本需要你自己粘贴到 Upwork。

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

类型：写入。Scope：`write`, `explore`。

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `url` | `string` | 否 | Upwork job URL |
| `jobId` | `string` | 否 | Job id already in the pipeline, e.g. ~022113077029286601014 |
| `templateId` | `string` | 否 | Template id or name; default = first saved template, else the built-in one |
| `screeningQuestions` | `array<string>` | 否 | Screening questions copied verbatim from the job |
| `extraInstructions` | `string` | 否 |  |

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

已保存的活动：搜索、最低分数、状态、最近刷新、来源健康状况。

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

类型：读取。Scope：`read`。

该工具没有参数：发送空请求体 `{}`。

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

创建或更新活动：名称、搜索、最低分数、模板。

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

类型：写入。Scope：`write`。

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `id` | `string` | 否 | Stable slug; reuse it to update an existing campaign |
| `name` | `string` | 是 |  |
| `search` | `object` | 是 |  |
| `minScore` | `integer` | 否 |  |
| `templateId` | `string` | 否 |  |

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

在关注活动之前，用真实职位模拟它。不保存任何内容。

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

类型：实时读取。Scope：`explore`。

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `campaignId` | `string` | 否 |  |
| `campaign` | `object` | 否 |  |
| `pages` | `integer` | 否 |  |

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

请求 Motor 按其采集节奏关注一个已保存的活动。

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

类型：操作。Scope：`act`。

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `campaignId` | `string` | 是 |  |
| `name` | `string` | 否 | 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`

让 Motor 停止关注某个活动。已看到的职位保留在管道中。

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

类型：操作。Scope：`act`。

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `campaignId` | `string` | 是 |  |
| `name` | `string` | 否 | 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`

刷新被关注的活动：合并 Motor 采集的职位，重新实时读取第一页，并为新职位评分。

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

类型：写入。Scope：`write`, `explore`。

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `campaignId` | `string` | 否 |  |
| `live` | `boolean` | 否 |  |

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

重新读取进行中申请的页面，标注结果日期：已关闭、已开始面试、无回复。

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

类型：写入。Scope：`write`, `explore`。

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `jobIds` | `array<string>` | 否 |  |
| `limit` | `integer` | 否 |  |

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

读取密钥创建者已连接邮箱中的 Upwork 通知邮件，并推进管道中职位的状态。

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

类型：写入。Scope：`write`。

| 参数 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| `accountId` | `string` | 否 |  |
| `limit` | `integer` | 否 |  |

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