Partially update a project

Update one or more fields on an existing project (supply only the fields you want to change). Returns the updated project. Returns 404 if the project does not exist.

On this page

HTTP request 

PATCH https://api.parsewise.ai/api/v1/projects/{id}/

URI Parameters

Name In Required Type Description
id path Yes string (uuid)  

Request Header

Name Required Type Description
X-API-Key Yes string API key with the pw_live_ prefix. See Authentication.

Request Body

Supported content types: application/json, application/x-www-form-urlencoded, multipart/form-data.

Name Required Type Description
name No string Human-readable name shown in the UI and in lists.
description No string Short description of what the project covers.
reference_date No string (date) (nullable) Reference date used by agents that need a “today” anchor (e.g. relative date extractions). Defaults to the date the project was created.
auto_archive_after_days No integer (nullable) Opt-in auto-archival for document-oriented projects: documents uploaded more than this many days ago are automatically moved into an archived project by a daily sweep. Null disables auto-archival.
is_pinned No boolean Whether the project is pinned to the top of the project list.
folder_id No string (uuid) (nullable) Folder that contains this project. Null means the project sits at the root of the organisation folder tree.

Responses

Status Type Description
200 V1Project —

Security

  • ApiKeyAuth — apiKey — in X-API-Key header. API key with pw_live_ prefix.

Python example 

import os
import requests

API_KEY = os.environ["PARSEWISE_API_KEY"]
BASE_URL = "https://api.parsewise.ai/api/v1"

id = "<uuid>"

body = {
    "name": "...",  # optional
    "description": "...",  # optional
    "reference_date": "YYYY-MM-DD",  # optional
    "auto_archive_after_days": 0,  # optional
    "is_pinned": False,  # optional
    "folder_id": "<uuid>",  # optional
}

resp = requests.patch(
    f"{BASE_URL}/projects/{id}/",
    headers={"X-API-Key": API_KEY},
    json=body,
)
resp.raise_for_status()
print(resp.json() if resp.content else None)

Definitions

PatchedV1ProjectRequest

A project: the top-level container that groups documents, agents, and extraction results.

Returned by GET /projects/ and GET /projects/{project_id}/; also accepted as the request body for PATCH /projects/{project_id}/, where only the fields you supply are updated. Server-managed fields such as id, created_at, last_visited_at, document_count, and agent_count are read-only.

Name Required Type Description
name No string Human-readable name shown in the UI and in lists.
description No string Short description of what the project covers.
reference_date No string (date) (nullable) Reference date used by agents that need a “today” anchor (e.g. relative date extractions). Defaults to the date the project was created.
auto_archive_after_days No integer (nullable) Opt-in auto-archival for document-oriented projects: documents uploaded more than this many days ago are automatically moved into an archived project by a daily sweep. Null disables auto-archival.
is_pinned No boolean Whether the project is pinned to the top of the project list.
folder_id No string (uuid) (nullable) Folder that contains this project. Null means the project sits at the root of the organisation folder tree.

V1Project

A project: the top-level container that groups documents, agents, and extraction results.

Returned by GET /projects/ and GET /projects/{project_id}/; also accepted as the request body for PATCH /projects/{project_id}/, where only the fields you supply are updated. Server-managed fields such as id, created_at, last_visited_at, document_count, and agent_count are read-only.

Name Required Type Description
id Yes string (uuid) Stable identifier for the project (UUID).
name Yes string Human-readable name shown in the UI and in lists.
description No string Short description of what the project covers.
last_visited_at Yes string (date-time) (nullable) Timestamp of the most recent visit to this project.
reference_date No string (date) (nullable) Reference date used by agents that need a “today” anchor (e.g. relative date extractions). Defaults to the date the project was created.
auto_archive_after_days No integer (nullable) Opt-in auto-archival for document-oriented projects: documents uploaded more than this many days ago are automatically moved into an archived project by a daily sweep. Null disables auto-archival.
document_count Yes integer Number of documents currently in the project.
agent_count Yes integer Number of non-draft agents configured on the project.
is_pinned No boolean Whether the project is pinned to the top of the project list.
folder_id No string (uuid) (nullable) Folder that contains this project. Null means the project sits at the root of the organisation folder tree.
project_modules Yes any Per-project overrides for which application modules are enabled, keyed by module name with boolean values. A missing key falls back to the organisation’s default for that module.
target_output_schema Yes any (nullable)  
output_mapping_status Yes string