> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.document360.com/llms.txt
> Use this file to discover all available pages before exploring further.
# List archived items in a workspace
> Returns one keyset page of archived articles and categories for the workspace + language,
newest-archived first. Reuses the SAME M:Document360.Business.Archive.IArchiveBusinessService.GetArchivedItemsAsync(Document360.Core.Models.Documentation.Archive.ArchivedItemsListRequestModel)
call as the Portal's Archive-section grid (`ArchiveController.GetArchivedItems`), so ACL
semantics — fail-closed on an unresolved ACL, whole-version denies, category-level
deny/allow-list scoping including inheritance-disabled categories — never drift between the two
surfaces. Pagination is real server-side keyset paging, not the offset/in-memory-cursor helper
other V3 list endpoints use: pass the previous response's `pagination.next_cursor` back as
`cursor` to fetch the next page; `pagination.page` is always `0`.
## OpenAPI
````json GET /v3/projects/{project_id}/workspaces/{workspace_id}/archived-items
{
"openapi": "3.0.1",
"info": {
"title": "Document360 Customer API",
"description": "Document360 RESTful APIs let you integrate your documentation with your software — onboard readers, manage articles, automate publishing, and more.\n\nFull reference: [API Documentation](https://apidocs.document360.io/docs).\n\n## Authentication\nV3 authenticates with an **API key** — not the `api_token` used by V1/V2. Create one in the Document360 portal under **Settings → Knowledge base portal → API keys**, then click **Create API key**. (Projects that still have the older screen show two tabs; choose **Enhanced keys (v3)**, or pick **API v3** from the Create menu.)\n\nSend it in the `X-API-Key` header:\n\n```\nX-API-Key: d360_sk_...\n```\n\nThe plaintext key is shown **once**, at creation — only its hash is stored, so a lost key must be replaced rather than recovered. Each key carries a fixed portal role, content role and content-access scope, supports an optional expiry, and can be disabled or deleted at any time from the same screen. Treat it as an opaque string: it is a pre-shared secret, not an OAuth 2.0 access token, and must not be parsed.\n\nFor flows that act on behalf of a specific person, V3 also accepts an OAuth 2.0 bearer token carrying the `customerApi` scope.\n\nAPI access is part of your subscription plan. If your plan does not include it, every endpoint returns `403` with the error code `FEATURE_NOT_IN_LICENSE` — including for keys created while an earlier plan was active. Contact your Customer Success Manager or `support@document360.com` to enable it.\n\n> **Note on terminology:** V1/V2 call these *API tokens* and manage them under **Settings → Knowledge base portal → API tokens**. V3 keys are a separate credential with their own screen, roles and scope — a V1/V2 token will not authenticate a V3 request.\n\n## Rate Limits\nAll endpoints are rate-limited per API key per project. Default limits vary by plan. When rate-limited, responses include `Retry-After`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` headers. Use exponential backoff with jitter for optimal retry behavior.",
"termsOfService": "https://document360.com/terms",
"contact": {
"name": "Document360 Support",
"url": "https://document360.io/contact-us/",
"email": "support@document360.com"
},
"license": {
"name": "Document360 API Terms of Use",
"url": "https://document360.com/terms"
},
"version": "3.0.0"
},
"servers": [
{
"url": "https://apihub.document360.io",
"description": "Document 360 API Hub"
},
{
"url": "https://apihub.us.document360.io",
"description": "Document360 API Hub - US data center"
},
{
"url": "https://apihub.{private_hosting}.document360.io",
"description": "Private hosting - Please provide the subdomain name.",
"variables": {
"private_hosting": {
"default": "domain",
"description": "Sub domain for private hosting"
}
}
}
],
"security": [
{
"ApiKey": []
},
{
"Bearer": [
"customerApi"
]
}
],
"tags": [
{
"name": "Projects",
"description": "List and manage knowledge base projects. Export and import project documentation, and manage project-level site customization such as custom CSS and JavaScript."
},
{
"name": "Projects > Import & export",
"description": "Start a project export or import and poll the resulting background operation for completion."
},
{
"name": "Workspaces",
"description": "Manage workspaces and access workspace-scoped categories and articles."
},
{
"name": "Workspaces > AI",
"description": "Query the workspace with Eddy AI and submit feedback on AI answers."
},
{
"name": "Articles",
"description": "Create, read, update, and delete knowledge base articles and their settings, including bulk operations."
},
{
"name": "Articles > Publishing & workflow",
"description": "Publish and unpublish articles (single and bulk) and update the article workflow status."
},
{
"name": "Articles > Versions",
"description": "List, fork, and delete article versions."
},
{
"name": "Articles > Attachments",
"description": "Manage the files attached to an article — list, upload, and delete article attachments."
},
{
"name": "Articles > Content drafts",
"description": "(Internal) Stage AI-generated article content with an Accept/Reject review lifecycle — used by Eddy Copilot to preview content before committing to the live article body."
},
{
"name": "Articles > Labels",
"description": "Read and set the labels associated with an article."
},
{
"name": "Articles > Comments",
"description": "Read and create the comment threads authors and reviewers leave on an article's content, and reply to them. Each comment id matches the `data-comment-id` attribute of the corresponding marker in the raw article content, so adding a text-anchored comment takes two calls: update the content with the marker, then create the thread with the same id."
},
{
"name": "Categories",
"description": "Manage the category hierarchy that organizes articles. Create, update, and delete categories and their settings, including bulk operations."
},
{
"name": "Categories > Page category",
"description": "Read and update the content body of page-type categories, including bulk content updates."
},
{
"name": "Categories > Publishing & workflow",
"description": "Publish and unpublish categories (single and bulk) and update the category workflow status."
},
{
"name": "Categories > Versions",
"description": "List, fork, and delete category versions."
},
{
"name": "Categories > Labels",
"description": "Read and set the labels associated with a category."
},
{
"name": "Categories > Comments",
"description": "Read and create the comment threads authors and reviewers leave on a page category's content, and reply to them. Only page-type categories carry content, so other category types return `404`. Adding a text-anchored comment takes two calls: update the content with the marker, then create the thread with the same id."
},
{
"name": "ArticleTemplates",
"description": "Manage reusable article templates — per-language article skeletons that authors and AI tools (such as Eddy Copilot) can apply when starting a new article.",
"x-displayName": "Article templates"
},
{
"name": "Content reuse > Glossaries",
"description": "Manage glossary entries — terminology definitions referenced inside articles via merge codes (`{{glossary.name}}`) and rendered as tooltips on the public KB."
},
{
"name": "Content reuse > Snippets",
"description": "Manage reusable snippets — markdown or WYSIWYG content fragments referenced across articles via merge codes (`{{snippet.name}}`)."
},
{
"name": "Content reuse > Variables",
"description": "Manage reusable variables — short text values referenced across articles via merge codes (`{{variable.name}}`)."
},
{
"name": "AiWriterStyleGuides",
"description": "Retrieve AI writer style guides configured for the project — voice / tone instructions Eddy Copilot follows when generating article content. Used to let users pick a style before kicking off generation.",
"x-displayName": "AI writer style guides"
},
{
"name": "RedirectRules",
"description": "Manage article-redirection rules — 301/302 redirects from old article URLs to new locations after renames or restructures.",
"x-displayName": "Redirect rules"
},
{
"name": "Tags",
"description": "Manage tags — labels used to classify articles, categories, and files for filtering and discovery."
},
{
"name": "Labels",
"description": "Manage labels shown on the article list and category tree. (Associating labels with a specific article or category lives under Articles and Categories.)"
},
{
"name": "CustomFields",
"description": "Retrieve the custom field definitions configured for the project. Custom field values are read and written through the article and category settings endpoints.",
"x-displayName": "Custom fields"
},
{
"name": "ApiReferences",
"description": "Import, resync, and publish OpenAPI/Swagger specifications for API reference documentation.",
"x-displayName": "API references"
},
{
"name": "ApiReferences > Logs",
"description": "Monitor API reference import logs and inspect individual log entries."
},
{
"name": "Drive",
"description": "Search Drive and retrieve files associated with an article, and track Drive background tasks."
},
{
"name": "Drive > Folders",
"description": "Create, read, update, and delete Drive folders."
},
{
"name": "Drive > Files",
"description": "Upload, copy, move, delete, and tag Drive files."
},
{
"name": "Drive > Image drafts",
"description": "(Internal) Stage uploaded or AI-generated images (committed to Drive and associated with a staged article draft) — used by Eddy Copilot."
},
{
"name": "Readers",
"description": "Manage reader accounts, invitations, and access scopes for private documentation."
},
{
"name": "Readers > Groups",
"description": "Create, read, update, and delete reader groups."
},
{
"name": "Users",
"description": "Manage users, their portal and content roles, and consolidated (effective) permissions within a project."
},
{
"name": "Users > Groups",
"description": "Manage user groups, their portal role, and consolidated (effective) group permissions."
},
{
"name": "Roles",
"description": "Create, read, update, and delete portal and content roles, list the users assigned to a role, and retrieve the permission dependency matrix."
},
{
"name": "ContentAccess",
"description": "Manage per-node content-access permissions — grant, allow, deny, and inheritance overrides for users and groups against specific versions, languages, categories, or articles, plus version/language site protection.",
"x-displayName": "Content access"
},
{
"name": "ContentAccess > Eligibility",
"description": "List the readers and groups eligible to be granted content access."
},
{
"name": "Languages",
"description": "Retrieve configured languages for a workspace."
},
{
"name": "Translations",
"description": "Query translation status of articles across languages."
},
{
"name": "Operations",
"description": "Track asynchronous operations — long-running tasks (bulk updates, merges, exports) accepted with `202 Accepted` and an `Operation-Location` header. Poll until the operation reaches a terminal status, honouring the `Retry-After` header."
},
{
"name": "Analytics > Articles",
"description": "View article performance metrics including views, top articles, reader locations, and category breakdowns."
},
{
"name": "Analytics > Search",
"description": "View search usage metrics including top keywords, no-result queries, and bounced searches."
},
{
"name": "Analytics > AI search",
"description": "View AI-powered search metrics including usage trends, most-referenced articles, and trending topics."
},
{
"name": "Analytics > Feedback",
"description": "View reader feedback trends across articles, including top-performing articles and feedback keywords."
}
],
"externalDocs": {
"description": "Document360 API Documentation",
"url": "https://apidocs.document360.io/docs"
},
"x-tagGroups": [
{
"name": "Workspace",
"tags": [
"Projects",
"Projects > Import & export",
"Workspaces",
"Workspaces > AI"
]
},
{
"name": "Content",
"tags": [
"Articles",
"Articles > Publishing & workflow",
"Articles > Versions",
"Articles > Attachments",
"Articles > Content drafts",
"Articles > Labels",
"Categories",
"Categories > Page category",
"Categories > Publishing & workflow",
"Categories > Versions",
"Categories > Labels",
"ArticleTemplates",
"AiWriterStyleGuides",
"RedirectRules",
"Tags",
"Labels",
"ApiReferences",
"ApiReferences > Logs"
]
},
{
"name": "Content reuse",
"tags": [
"Content reuse > Glossaries",
"Content reuse > Snippets",
"Content reuse > Variables"
]
},
{
"name": "Media",
"tags": [
"Drive",
"Drive > Folders",
"Drive > Files",
"Drive > Image drafts"
]
},
{
"name": "Access",
"tags": [
"Readers",
"Readers > Groups",
"Users",
"Users > Groups",
"Roles",
"ContentAccess",
"ContentAccess > Eligibility"
]
},
{
"name": "Localization",
"tags": [
"Languages",
"Translations"
]
},
{
"name": "Operations",
"tags": [
"Operations"
]
},
{
"name": "Analytics",
"tags": [
"Analytics > Articles",
"Analytics > Search",
"Analytics > AI search",
"Analytics > Feedback"
]
}
],
"paths": {
"/v3/projects/{project_id}/workspaces/{workspace_id}/archived-items": {
"get": {
"tags": [
"Workspaces"
],
"summary": "List archived items in a workspace.",
"description": "Returns one keyset page of archived articles and categories for the workspace + language,\r\nnewest-archived first. Reuses the SAME M:Document360.Business.Archive.IArchiveBusinessService.GetArchivedItemsAsync(Document360.Core.Models.Documentation.Archive.ArchivedItemsListRequestModel)\r\ncall as the Portal's Archive-section grid (`ArchiveController.GetArchivedItems`), so ACL\r\nsemantics — fail-closed on an unresolved ACL, whole-version denies, category-level\r\ndeny/allow-list scoping including inheritance-disabled categories — never drift between the two\r\nsurfaces. Pagination is real server-side keyset paging, not the offset/in-memory-cursor helper\r\nother V3 list endpoints use: pass the previous response's `pagination.next_cursor` back as\r\n`cursor` to fetch the next page; `pagination.page` is always `0`.",
"operationId": "getWorkspaceArchivedItems",
"parameters": [
{
"$ref": "#/components/parameters/ProjectId"
},
{
"$ref": "#/components/parameters/WorkspaceId"
},
{
"$ref": "#/components/parameters/LangCode"
},
{
"name": "entity_type",
"in": "query",
"description": "Optional filter to only `article` or only `category` rows.",
"schema": {
"enum": [
"article",
"category"
],
"type": "string",
"example": "article"
},
"example": "article"
},
{
"name": "archived_by",
"in": "query",
"description": "Optional filter to items archived by one or more of these user IDs.",
"schema": {
"type": "array",
"items": {
"type": "string"
}
}
},
{
"name": "from",
"in": "query",
"description": "Optional lower bound (inclusive, UTC) on when the item was archived.",
"schema": {
"type": "string",
"format": "date-time"
}
},
{
"name": "to",
"in": "query",
"description": "Optional upper bound (inclusive, UTC) on when the item was archived.",
"schema": {
"type": "string",
"format": "date-time"
}
},
{
"name": "search",
"in": "query",
"description": "Optional title search term.",
"schema": {
"type": "string",
"example": "getting started"
},
"example": "getting started"
},
{
"$ref": "#/components/parameters/PageSize"
},
{
"name": "cursor",
"in": "query",
"description": "Opaque keyset cursor from a previous response's `pagination.next_cursor`. Omit for the first page.",
"schema": {
"type": "string",
"example": "eyJpZCI6IjlhM2I0YzVkLTZlN2YtOGE5Yi0wYzFkLTJlM2Y0YTViNmM3ZCJ9"
},
"example": "eyJpZCI6IjlhM2I0YzVkLTZlN2YtOGE5Yi0wYzFkLTJlM2Y0YTViNmM3ZCJ9"
}
],
"responses": {
"200": {
"description": "Archived items retrieved successfully.",
"headers": {
"X-RateLimit-Limit": {
"description": "The maximum number of requests allowed in the current time window for this request's bucket. Read requests (GET/HEAD) and write requests (POST/PUT/PATCH/DELETE) have independent limits, applied per caller (API key or user) per project.",
"schema": {
"type": "integer",
"format": "int32"
}
},
"X-RateLimit-Remaining": {
"description": "The number of requests remaining in the current time window. When this reaches 0, subsequent requests receive a 429 response.",
"schema": {
"type": "integer",
"format": "int32"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ArchivedItemSummaryResponsePaginatedResponse"
},
"examples": {
"Archived items retrieved successfully": {
"summary": "Returns one keyset page of archived articles and categories for the workspace, newest first.",
"value": {
"data": [
{
"id": "7f1a2b3c-4d5e-6f70-8a9b-0c1d2e3f4a5b",
"entity_id": "9a3b4c5d-6e7f-8a9b-0c1d-2e3f4a5b6c7d",
"entity_type": "article",
"title": "Deprecated Setup Guide",
"archived_by": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d",
"archived_on": "2026-07-01T10:15:00Z",
"original_category_id": "c5d6e7f8-9a0b-1c2d-3e4f-5a6b7c8d9e0f",
"original_path": "Getting Started / Installation",
"parent_archived": true,
"can_restore": true,
"can_delete_forever": true
},
{
"id": "8a2b3c4d-5e6f-7081-9a0b-1c2d3e4f5a6b",
"entity_id": "c5d6e7f8-9a0b-1c2d-3e4f-5a6b7c8d9e0f",
"entity_type": "category",
"title": "Legacy API Reference",
"archived_by": "b2c3d4e5-f6a7-8b9c-0d1e-2f3a4b5c6d7e",
"archived_on": "2026-06-20T14:30:00Z",
"original_category_id": null,
"original_path": null,
"parent_archived": false,
"can_restore": true,
"can_delete_forever": false
}
],
"pagination": {
"page": 0,
"page_size": 50,
"total_count": null,
"has_more": true,
"next_cursor": "eyJhcmNoaXZlZE9uIjoiMjAyNi0wNi0yMFQxNDozMDowMFoiLCJpZCI6IjhhMmIzYzRkIn0="
},
"success": true,
"request_id": "req_abc123def456",
"errors": null,
"warnings": null
}
}
}
}
}
},
"401": {
"description": "Authentication token is missing or invalid.",
"headers": {
"WWW-Authenticate": {
"description": "Indicates the authentication scheme required. Returns `Bearer` with optional `error` and `error_description` parameters per RFC 6750.",
"schema": {
"type": "string"
}
}
},
"content": {
"application/problem+json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/V3ProblemDetails"
},
{
"type": "object",
"properties": {
"type": {
"enum": [
"https://apidocs.document360.io/apidocs/errors/unauthorized"
],
"type": "string",
"description": "RFC 7807 error type URI. Always `https://apidocs.document360.io/apidocs/errors/unauthorized` for 401 responses."
},
"status": {
"enum": [
401
],
"type": "integer",
"description": "HTTP status code. Always `401` for this response.",
"format": "int32"
}
}
}
]
},
"examples": {
"Missing or invalid token": {
"summary": "Authentication token is missing or invalid.",
"value": {
"type": "https://apidocs.document360.io/apidocs/errors/unauthorized",
"title": "Unauthorized.",
"status": 401,
"detail": "The authentication token is missing or has expired.",
"instance": null,
"trace_id": "req_abc123def456",
"errors": [
{
"code": "UNAUTHORIZED",
"message": "Bearer token is missing or invalid.",
"field": null,
"details": null
}
],
"warnings": null
}
}
}
}
}
},
"403": {
"description": "User does not have access to this project.",
"content": {
"application/problem+json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/V3ProblemDetails"
},
{
"type": "object",
"properties": {
"type": {
"enum": [
"https://apidocs.document360.io/apidocs/errors/forbidden"
],
"type": "string",
"description": "RFC 7807 error type URI. Always `https://apidocs.document360.io/apidocs/errors/forbidden` for 403 responses."
},
"status": {
"enum": [
403
],
"type": "integer",
"description": "HTTP status code. Always `403` for this response.",
"format": "int32"
}
}
}
]
},
"examples": {
"Insufficient permissions": {
"summary": "Insufficient permissions for this resource.",
"value": {
"type": "https://apidocs.document360.io/apidocs/errors/forbidden",
"title": "Forbidden.",
"status": 403,
"detail": "You do not have permission to perform this action.",
"instance": null,
"trace_id": "req_abc123def456",
"errors": [
{
"code": "FORBIDDEN",
"message": "Insufficient permissions for this project.",
"field": null,
"details": null
}
],
"warnings": null
}
}
}
}
}
},
"404": {
"description": "Workspace not found.",
"content": {
"application/problem+json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/V3ProblemDetails"
},
{
"type": "object",
"properties": {
"type": {
"enum": [
"https://apidocs.document360.io/apidocs/errors/resource-not-found"
],
"type": "string",
"description": "RFC 7807 error type URI. Always `https://apidocs.document360.io/apidocs/errors/resource-not-found` for 404 responses."
},
"status": {
"enum": [
404
],
"type": "integer",
"description": "HTTP status code. Always `404` for this response.",
"format": "int32"
}
}
}
]
},
"examples": {
"Resource not found": {
"summary": "The requested resource was not found.",
"value": {
"type": "https://apidocs.document360.io/apidocs/errors/resource-not-found",
"title": "Not Found.",
"status": 404,
"detail": "The requested resource does not exist or has been deleted.",
"instance": null,
"trace_id": "req_abc123def456",
"errors": [
{
"code": "RESOURCE_NOT_FOUND",
"message": "The requested resource was not found.",
"field": null,
"details": null
}
],
"warnings": null
}
}
}
}
}
},
"422": {
"description": "Validation failed (missing lang_code, or an unrecognized entity_type).",
"content": {
"application/problem+json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/V3ProblemDetails"
},
{
"type": "object",
"properties": {
"type": {
"enum": [
"https://apidocs.document360.io/apidocs/errors/validation-error"
],
"type": "string",
"description": "RFC 7807 error type URI. Always `https://apidocs.document360.io/apidocs/errors/validation-error` for 422 responses."
},
"status": {
"enum": [
422
],
"type": "integer",
"description": "HTTP status code. Always `422` for this response.",
"format": "int32"
}
}
}
]
},
"examples": {
"Validation failed": {
"summary": "The request body contains invalid data.",
"value": {
"type": "https://apidocs.document360.io/apidocs/errors/validation-error",
"title": "Unprocessable Entity.",
"status": 422,
"detail": "One or more fields failed validation.",
"instance": null,
"trace_id": "req_abc123def456",
"errors": [
{
"code": "VALIDATION_ERROR",
"message": "This field is required.",
"field": "title",
"details": null
}
],
"warnings": null
}
}
}
}
}
},
"429": {
"description": "Rate limit exceeded. Retry after the duration specified in the Retry-After header.",
"headers": {
"Retry-After": {
"description": "Number of seconds to wait before retrying the request. Use exponential backoff with jitter for optimal retry behavior.",
"schema": {
"type": "integer",
"format": "int32"
}
},
"X-RateLimit-Limit": {
"description": "The maximum number of requests allowed in the current time window for this request's bucket. Read requests (GET/HEAD) and write requests (POST/PUT/PATCH/DELETE) have independent limits, applied per caller (API key or user) per project. Read limits are typically higher than write limits.",
"schema": {
"type": "integer",
"format": "int32"
}
},
"X-RateLimit-Remaining": {
"description": "The number of requests remaining in the current time window. When this reaches 0, subsequent requests will receive a 429 response.",
"schema": {
"type": "integer",
"format": "int32"
}
},
"X-RateLimit-Reset": {
"description": "The UTC epoch timestamp (in seconds) when the current rate limit window resets.",
"schema": {
"type": "integer",
"format": "int64"
}
}
},
"content": {
"application/problem+json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/V3ProblemDetails"
},
{
"type": "object",
"properties": {
"type": {
"enum": [
"https://apidocs.document360.io/apidocs/errors/too-many-requests"
],
"type": "string",
"description": "RFC 7807 error type URI. Always `https://apidocs.document360.io/apidocs/errors/too-many-requests` for 429 responses."
},
"status": {
"enum": [
429
],
"type": "integer",
"description": "HTTP status code. Always `429` for this response.",
"format": "int32"
}
}
}
]
},
"examples": {
"Rate limit exceeded": {
"summary": "Rate limit exceeded.",
"value": {
"type": "https://apidocs.document360.io/apidocs/errors/too-many-requests",
"title": "Too Many Requests.",
"status": 429,
"detail": "Rate limit exceeded. Retry after the duration specified in the Retry-After header.",
"instance": null,
"trace_id": "req_abc123def456",
"errors": [
{
"code": "TOO_MANY_REQUESTS",
"message": "Rate limit exceeded. Retry after the duration specified in the Retry-After header.",
"field": null,
"details": null
}
],
"warnings": null
}
}
}
}
}
},
"500": {
"description": "An unexpected server error occurred.",
"content": {
"application/problem+json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/V3ProblemDetails"
},
{
"type": "object",
"properties": {
"type": {
"enum": [
"https://apidocs.document360.io/apidocs/errors/internal-server-error"
],
"type": "string",
"description": "RFC 7807 error type URI. Always `https://apidocs.document360.io/apidocs/errors/internal-server-error` for 500 responses."
},
"status": {
"enum": [
500
],
"type": "integer",
"description": "HTTP status code. Always `500` for this response.",
"format": "int32"
}
}
}
]
},
"examples": {
"Unexpected server error": {
"summary": "Unexpected server error.",
"value": {
"type": "https://apidocs.document360.io/apidocs/errors/internal-server-error",
"title": "Internal Server Error.",
"status": 500,
"detail": "An unexpected error occurred. Please try again or contact support.",
"instance": null,
"trace_id": "req_abc123def456",
"errors": [
{
"code": "INTERNAL_SERVER_ERROR",
"message": "An unexpected error occurred.",
"field": null,
"details": null
}
],
"warnings": null
}
}
}
}
}
}
},
"security": [
{
"ApiKey": []
},
{
"Bearer": [
"customerApi"
]
}
]
}
}
},
"components": {
"parameters": {
"ProjectId": {
"name": "project_id",
"in": "path",
"description": "The unique identifier of the project. Retrieve project IDs from `GET /v3/projects`.",
"required": true,
"schema": {
"type": "string",
"format": "uuid",
"example": "9a3b4c5d-6e7f-8a9b-0c1d-2e3f4a5b6c7d"
}
},
"WorkspaceId": {
"name": "workspace_id",
"in": "path",
"description": "The unique identifier of the workspace. Retrieve workspace IDs from `GET /v3/projects/{projectId}/workspaces`.",
"required": true,
"schema": {
"type": "string",
"format": "uuid",
"example": "1c2d3e4f-5a6b-7c8d-9e0f-a1b2c3d4e5f6"
}
},
"LangCode": {
"name": "lang_code",
"in": "query",
"description": "ISO 639-1 language code (e.g., `en`, `fr`). Defaults to the project's primary language if omitted.",
"schema": {
"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
"type": "string",
"format": "language-tag",
"example": "en"
}
},
"PageSize": {
"name": "page_size",
"in": "query",
"description": "Number of results per page. Defaults to 25. Maximum 100.",
"schema": {
"maximum": 100,
"minimum": 1,
"type": "integer",
"format": "int32",
"default": 25
}
}
},
"schemas": {
"ArchivedItemSummaryResponsePaginatedResponse": {
"required": [
"data",
"pagination",
"request_id",
"success"
],
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ArchivedItemSummaryResponse"
},
"description": "List of items for the current page."
},
"pagination": {
"allOf": [
{
"$ref": "#/components/schemas/PaginationInfo"
}
],
"description": "Pagination metadata.",
"readOnly": true
},
"success": {
"type": "boolean",
"description": "Whether the API request was successful.",
"readOnly": true
},
"request_id": {
"minLength": 1,
"type": "string",
"description": "Unique identifier for request tracing and correlation.",
"readOnly": true
},
"errors": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ApiError"
},
"description": "List of errors if the request failed.",
"nullable": true
},
"warnings": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ApiWarning"
},
"description": "List of non-fatal warnings from the request.",
"nullable": true
}
},
"additionalProperties": false,
"description": "Paginated API response containing a list of items."
},
"V3ProblemDetails": {
"required": [
"status",
"title",
"type"
],
"type": "object",
"properties": {
"type": {
"minLength": 1,
"enum": [
"https://apidocs.document360.io/apidocs/errors/bad-request",
"https://apidocs.document360.io/apidocs/errors/unauthorized",
"https://apidocs.document360.io/apidocs/errors/forbidden",
"https://apidocs.document360.io/apidocs/errors/resource-not-found",
"https://apidocs.document360.io/apidocs/errors/conflict",
"https://apidocs.document360.io/apidocs/errors/validation-error",
"https://apidocs.document360.io/apidocs/errors/too-many-requests",
"https://apidocs.document360.io/apidocs/errors/internal-server-error"
],
"type": "string",
"description": "URI reference identifying the error type (links to documentation)."
},
"title": {
"minLength": 1,
"type": "string",
"description": "Short human-readable summary of the error type."
},
"status": {
"enum": [
400,
401,
403,
404,
409,
422,
429,
500
],
"type": "integer",
"description": "HTTP status code.",
"format": "int32"
},
"detail": {
"type": "string",
"description": "Human-readable explanation specific to this occurrence.",
"nullable": true
},
"instance": {
"type": "string",
"description": "URI of the request that generated the error.",
"nullable": true
},
"trace_id": {
"type": "string",
"description": "Request trace identifier for correlation.",
"nullable": true
},
"errors": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ApiError"
},
"description": "Structured list of specific errors (extension field).",
"nullable": true
},
"warnings": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ApiWarning"
},
"description": "Non-fatal warnings (extension field).",
"nullable": true
}
},
"additionalProperties": false,
"description": "RFC 7807 Problem Details response for V3 API errors.\r\nContent-Type: application/problem+json"
},
"ArchivedItemSummaryResponse": {
"required": [
"archived_on",
"can_delete_forever",
"can_restore",
"id",
"parent_archived",
"title"
],
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier of this archived-item record (distinct from `entity_id`).",
"format": "uuid",
"nullable": true,
"readOnly": true,
"example": "7f1a2b3c-4d5e-6f70-8a9b-0c1d2e3f4a5b"
},
"entity_id": {
"type": "string",
"description": "The identifier of the archived article or category itself.",
"nullable": true,
"readOnly": true,
"example": "9a3b4c5d-6e7f-8a9b-0c1d-2e3f4a5b6c7d"
},
"entity_type": {
"enum": [
"article",
"category"
],
"type": "string",
"allOf": [
{
"$ref": "#/components/schemas/ArchivedItemEntityType"
}
],
"description": "Whether the archived entity is an article or a category.",
"readOnly": true,
"x-enumNames": [
"Article",
"Category"
],
"x-enum-varnames": [
"Article",
"Category"
],
"x-ms-enum": {
"name": "ArchivedItemEntityType",
"modelAsString": true
}
},
"title": {
"type": "string",
"description": "The title of the article or category at the time it was archived.",
"nullable": true,
"readOnly": true,
"example": "Deprecated Setup Guide"
},
"archived_by": {
"type": "string",
"description": "The user ID of who archived this item. Corresponds to a user from `GET /v3/projects/{projectId}/users`.",
"nullable": true,
"readOnly": true,
"example": "a1b2c3d4-e5f6-7a8b-9c0d-1e2f3a4b5c6d"
},
"archived_on": {
"type": "string",
"description": "UTC timestamp of when this item was archived.",
"format": "date-time",
"readOnly": true,
"example": "2026-07-01T10:15:00Z"
},
"original_category_id": {
"type": "string",
"description": "The identifier of the category this item lived under immediately before archiving. Null for a root-level item.",
"nullable": true,
"readOnly": true,
"example": "f4a5b6c7-d8e9-0a1b-2c3d-4e5f6a7b8c9d"
},
"original_path": {
"type": "string",
"description": "The breadcrumb path of category titles this item lived under immediately before archiving.",
"nullable": true,
"readOnly": true,
"example": "Getting Started / Installation"
},
"parent_archived": {
"type": "boolean",
"description": "True when this row's parent category is itself archived — i.e. this row is a DESCENDANT of\r\nanother archived item, not an independently restorable one. This endpoint returns every\r\narchived item (unlike the Portal's Archive grid, which lists root rows only), so a consumer\r\nmust check this flag before attempting to RESTORE a row: doing so on a row with this flag set\r\nto true is rejected with `409 ARCHIVED_CONTENT_READ_ONLY`.\r\n\nRestore only — permanent delete has no such guard. A row with `parent_archived: true`\r\nCAN still be permanently deleted; delete-forever is deliberately not subtree-gated the way\r\nrestore is. Do not infer anything about delete-forever from this flag.\r\n",
"readOnly": true,
"example": false
},
"can_restore": {
"type": "boolean",
"description": "Whether the acting caller HOLDS THE PERMISSION to restore this item — a role/ACL check, wholly\r\nindependent of Document360.Customer.API.Models.V3.Archive.ArchivedItemSummaryResponse.ParentArchived. The two can disagree: a row can carry\r\n`can_restore: true` (the caller has the permission) alongside `parent_archived: true`\r\n(the actual restore call is still refused with `409` because the row is a descendant of a\r\nstill-archived category). `can_restore` answers \"am I allowed to try\", not \"will this\r\nspecific call succeed\" — check `parent_archived` too before attempting a restore.",
"readOnly": true,
"example": true
},
"can_delete_forever": {
"type": "boolean",
"description": "Whether the acting caller is permitted to permanently delete this item.",
"readOnly": true,
"example": true
}
},
"additionalProperties": false,
"description": "One row of a workspace's archive section: an archived article or category language, plus the\r\nacting caller's own restore / delete-forever permission for that row."
},
"PaginationInfo": {
"required": [
"has_more",
"page",
"page_size"
],
"type": "object",
"properties": {
"page": {
"type": "integer",
"description": "Current page number (1-based). Returns 0 when using cursor-based pagination.",
"format": "int32"
},
"page_size": {
"type": "integer",
"description": "Number of items per page.",
"format": "int32"
},
"total_count": {
"type": "integer",
"description": "Total number of items across all pages. Only populated when `include_total_count=true` is specified in the request.",
"format": "int64",
"nullable": true
},
"has_more": {
"type": "boolean",
"description": "Whether additional pages are available."
},
"next_cursor": {
"type": "string",
"description": "Opaque cursor to retrieve the next page of results. Pass this value as the `cursor` query parameter. Null when there are no more pages.",
"nullable": true
}
},
"additionalProperties": false,
"description": "Metadata describing the current pagination state. Supports both offset-based\r\nand cursor-based pagination."
},
"ApiError": {
"required": [
"code",
"message"
],
"type": "object",
"properties": {
"code": {
"minLength": 1,
"enum": [
"ARCHIVED_CONTENT_READ_ONLY",
"ARCHIVE_ALREADY_ARCHIVED",
"ARCHIVE_NOT_ARCHIVED",
"BAD_REQUEST",
"CONFLICT",
"FEATURE_NOT_IN_LICENSE",
"FORBIDDEN",
"INTERNAL_SERVER_ERROR",
"LICENSE_LIMIT_EXCEEDED",
"OPERATION_FAILED",
"PREMIUM_FEATURE_NOT_IN_LICENSE",
"RESOURCE_NOT_FOUND",
"TOO_MANY_REQUESTS",
"UNAUTHORIZED",
"UNRECOGNIZED_FIELD",
"UNRECOGNIZED_FIELDS",
"VALIDATION_ERROR"
],
"type": "string",
"description": "Machine-readable error code (e.g. VALIDATION_ERROR, RESOURCE_NOT_FOUND)."
},
"message": {
"minLength": 1,
"type": "string",
"description": "Human-readable error message."
},
"field": {
"type": "string",
"description": "The request field that caused the error, if applicable.",
"nullable": true
},
"details": {
"type": "string",
"description": "Additional context about the error.",
"nullable": true
}
},
"additionalProperties": false,
"description": "Represents an error returned by the API."
},
"ApiWarning": {
"required": [
"code",
"message"
],
"type": "object",
"properties": {
"code": {
"minLength": 1,
"type": "string",
"description": "Machine-readable warning code."
},
"message": {
"minLength": 1,
"type": "string",
"description": "Human-readable warning message."
}
},
"additionalProperties": false,
"description": "Represents a non-fatal warning from the API."
},
"ArchivedItemEntityType": {
"enum": [
"article",
"category"
],
"type": "string",
"description": "The kind of entity an archived-items row represents.",
"x-enumNames": [
"Article",
"Category"
],
"x-enum-varnames": [
"Article",
"Category"
],
"x-ms-enum": {
"name": "ArchivedItemEntityType",
"modelAsString": true
}
}
},
"securitySchemes": {
"ApiKey": {
"type": "apiKey",
"description": "API key for machine-to-machine integrations, webhooks, and CI/CD (recommended). This is a static, pre-shared secret - treat it as an opaque string and do not parse it; it is an API key, not an OAuth 2.0 access token. Create one in the portal under **Settings > Knowledge base portal > API keys** using the **Create API key** button - this is a different credential from the V1/V2 *API token*, which lives on its own screen and will not authenticate a V3 request. The plaintext key (format `d360_sk_...`) is shown only once, at creation. Send it in the `X-API-Key` header: `X-API-Key: d360_sk_...`. Each key carries a fixed portal role, content role, and content-access scope, supports an optional expiry, and can be disabled or deleted at any time from the portal.",
"name": "X-API-Key",
"in": "header"
},
"Bearer": {
"type": "oauth2",
"description": "All V3 endpoints require a Bearer token. Generate tokens in the Document360 portal under **Settings > API Tokens**. Tokens are project-scoped, require the `customerApi` scope, and do not expire by default. Tokens can be revoked at any time from the portal. Include the token in every request: `Authorization: Bearer `. Alternatively, use the Authorize button below to sign in via OAuth2 Authorization Code flow with PKCE.",
"flows": {
"authorizationCode": {
"authorizationUrl": "https://identity.document360.io/connect/authorize",
"tokenUrl": "https://identity.document360.io/connect/token",
"scopes": {
"openid": "OpenID Connect",
"profile": "User profile",
"email": "User email",
"customerApi": "Document360 Customer API"
},
"x-usePkce": {
"disableManualConfiguration": true,
"hideClientSecretInput": true
}
}
},
"x-d360-clientId": "apiHubWebClient"
}
}
}
}
````