# Factify API

## Docs

- [Approve an access request](https://developers.factify.com/api-reference/access-requests/approve-an-access-request.md): Approve an access request.
- [Check access request status](https://developers.factify.com/api-reference/access-requests/check-access-request-status.md): Returns whether the caller has a pending access request for the document.
- [Create an access request](https://developers.factify.com/api-reference/access-requests/create-an-access-request.md): Creates a new access request for the specified document.
- [Deny an access request](https://developers.factify.com/api-reference/access-requests/deny-an-access-request.md): Deny an access request.
- [Inspect document access](https://developers.factify.com/api-reference/access-requests/inspect-document-access.md): Returns the caller's permissions and any access policies on a document.
- [List access requests](https://developers.factify.com/api-reference/access-requests/list-access-requests.md): Lists pending access requests for the specified document.
- [Create an API key](https://developers.factify.com/api-reference/api-keys/create-an-api-key.md): Creates a new API key for the specified organization. The secret is only returned once in the response and cannot be retrieved later.
- [List API keys](https://developers.factify.com/api-reference/api-keys/list-api-keys.md): Lists API keys for an organization.
- [Revoke an API key](https://developers.factify.com/api-reference/api-keys/revoke-an-api-key.md): Revokes an API key, immediately preventing it from being used for authentication.
- [Create a document](https://developers.factify.com/api-reference/documents/create-a-document.md): Creates a new document by uploading a PDF file.
- [Export a document](https://developers.factify.com/api-reference/documents/export-a-document.md): Generates a time-limited download URL for the document PDF.
- [List documents](https://developers.factify.com/api-reference/documents/list-documents.md): List documents with cursor-based pagination.
- [List duplicate documents](https://developers.factify.com/api-reference/documents/list-duplicate-documents.md): Finds documents that are visual duplicates of the specified document using perceptual hashing.
- [Process a document](https://developers.factify.com/api-reference/documents/process-a-document.md): Triggers the AI processing pipeline (extraction and summarization) for the document's current or specified version.
- [Restore a document from trash](https://developers.factify.com/api-reference/documents/restore-a-document-from-trash.md): Restores a document from trash. Previous sharing and access permissions are NOT restored.
- [Retrieve a document](https://developers.factify.com/api-reference/documents/retrieve-a-document.md): Retrieve a document by ID.
- [Transfer document ownership](https://developers.factify.com/api-reference/documents/transfer-document-ownership.md): Transfers ownership of a document to another user in the organization.
- [Trash a document](https://developers.factify.com/api-reference/documents/trash-a-document.md): Moves a document to trash and revokes all non-owner access.
- [Update a document](https://developers.factify.com/api-reference/documents/update-a-document.md): Update document title and description.
- [Accept an invitation](https://developers.factify.com/api-reference/invites/accept-an-invitation.md): Accepts the invitation and adds the authenticated user as a member of the organization. The authenticated user's verified email must match the invitation email (case-insensitive). Returns PERMISSION_DENIED if emails don't match, FAILED_PRECONDITION if the user is already a member, or NOT_FOUND if th…
- [Invite a user to join an organization](https://developers.factify.com/api-reference/invites/invite-a-user-to-join-an-organization.md): Creates an invitation and sends an email to the specified address. Returns FAILED_PRECONDITION if the email belongs to an existing organization member. Idempotency: If a PENDING invitation already exists for this email, the existing invitation is resent with a new token and refreshed expiration. Exp…
- [List organization invitations](https://developers.factify.com/api-reference/invites/list-organization-invitations.md): List invitations for an organization. Requires permission to invite organization members.
- [Resend an invitation email](https://developers.factify.com/api-reference/invites/resend-an-invitation-email.md): Resend an invitation email to the recipient. Useful if the original email was lost or expired. Requires permission to invite organization members.
- [Revoke an invitation](https://developers.factify.com/api-reference/invites/revoke-an-invitation.md): Revoke a pending invitation, preventing the recipient from joining. Requires permission to manage organization members.
- [Add a member to an organization](https://developers.factify.com/api-reference/members/add-a-member-to-an-organization.md): Directly adds a user as a member of an organization. Requires manage permission (owner or admin).
- [List organization members](https://developers.factify.com/api-reference/members/list-organization-members.md): List members of an organization. Requires organization membership.
- [Remove an organization member](https://developers.factify.com/api-reference/members/remove-an-organization-member.md): Remove a member from an organization. Requires manage permission, or the member can remove themselves. The organization owner cannot be removed.
- [Update an organization member](https://developers.factify.com/api-reference/members/update-an-organization-member.md): Update a member's role within an organization. Requires manage permission (owner or admin). The organization owner's role cannot be changed.
- [List organizations](https://developers.factify.com/api-reference/organizations/list-organizations.md): List organizations the caller has access to.
- [Retrieve an organization](https://developers.factify.com/api-reference/organizations/retrieve-an-organization.md): Retrieve an organization by ID.
- [Update an organization](https://developers.factify.com/api-reference/organizations/update-an-organization.md): Update an organization's display name.  Authorization: Requires organization#administer permission (owner or admin).
- [Attach a policy](https://developers.factify.com/api-reference/policies/attach-a-policy.md): Attach a policy to a document.
- [Detach a policy](https://developers.factify.com/api-reference/policies/detach-a-policy.md): Detach a policy from a document.
- [List document policies](https://developers.factify.com/api-reference/policies/list-document-policies.md): List policies attached to a document.
- [Generate entry page](https://developers.factify.com/api-reference/sharing-&-distribution/generate-entry-page.md): Generate and return a temporary downloadable URL for the document entry page PDF.
- [Create share link](https://developers.factify.com/api-reference/sharings/create-share-link.md): Create a share link for a document.
- [Get general access](https://developers.factify.com/api-reference/sharings/get-general-access.md): Get general access level for a document.
- [Grant document access](https://developers.factify.com/api-reference/sharings/grant-document-access.md): Grant access to one or more recipients.
- [List document access](https://developers.factify.com/api-reference/sharings/list-document-access.md): List all recipients with access to a document.
- [Revoke document access](https://developers.factify.com/api-reference/sharings/revoke-document-access.md): Revoke access from a recipient.
- [Set general access](https://developers.factify.com/api-reference/sharings/set-general-access.md): Set general access level for a document.
- [Update document access](https://developers.factify.com/api-reference/sharings/update-document-access.md): Update a recipient's role.
- [Get document timeline](https://developers.factify.com/api-reference/timelines/get-document-timeline.md): Retrieves timeline events for a document. Admins see all events; viewers see only their own.
- [Delete API key quota](https://developers.factify.com/api-reference/usage/delete-api-key-quota.md): Removes the per-key quota limit. The key will only be subject to the organization-level quota.
- [Get organization quota status](https://developers.factify.com/api-reference/usage/get-organization-quota-status.md): Returns the current quota status for an organization including usage, limits, tier, and reset date.
- [Get usage history](https://developers.factify.com/api-reference/usage/get-usage-history.md): Returns daily usage records for an organization within a specified date range.
- [List API key quotas](https://developers.factify.com/api-reference/usage/list-api-key-quotas.md): Returns all per-key quota configurations and current usage for an organization.
- [Set API key quota](https://developers.factify.com/api-reference/usage/set-api-key-quota.md): Creates or updates a per-key quota limit. The key will be enforced independently of the organization quota.
- [Get current user](https://developers.factify.com/api-reference/users/get-current-user.md): Returns the authenticated user's profile and organization memberships. Only available for user accounts (JWT auth), not API keys.
- [Create a new version](https://developers.factify.com/api-reference/versions/create-a-new-version.md): Creates a new version by uploading a PDF file.
- [List document versions](https://developers.factify.com/api-reference/versions/list-document-versions.md): List versions for a document with cursor-based pagination.
- [Retrieve a record](https://developers.factify.com/api-reference/versions/retrieve-a-record.md): Retrieves the processed content record for a given version. The content oneof is populated based on source_format: document formats (pdf, docx, markdown) populate the document field; spreadsheet formats (xlsx, csv) populate the spreadsheet field.
- [Retrieve a version](https://developers.factify.com/api-reference/versions/retrieve-a-version.md): Retrieve a specific version by ID.
- [Update a version](https://developers.factify.com/api-reference/versions/update-a-version.md): Update version title and description.
- [Core Principles](https://developers.factify.com/core-principles.md): The design principles that guide Factify's API—and the capabilities they unlock across every resource.
- [Attach a Policy](https://developers.factify.com/examples/attach-policy.md): Apply governance policies to documents for compliance enforcement.
- [Create a Version](https://developers.factify.com/examples/create-version.md): Learn how to create a new version of an existing document.
- [Invite Organization Member](https://developers.factify.com/examples/invite-member.md): Send invitations to add members to your organization.
- [List Documents](https://developers.factify.com/examples/list-documents.md): Retrieve and paginate through your organization's documents.
- [Request Document Access](https://developers.factify.com/examples/request-access.md): Request access to a document, then approve or deny the request.
- [Share a Document](https://developers.factify.com/examples/share-document.md): Generate secure, time-limited URLs to share documents externally.
- [Upload a Document](https://developers.factify.com/examples/upload-document.md): Learn how to upload a PDF and create a new document in Factify.
- [Authentication](https://developers.factify.com/guides/authentication.md): Learn how to authenticate with the Factify API using API keys and Bearer tokens.
- [Document System of Record](https://developers.factify.com/guides/document-system-of-record.md): Understand how documents are created, versioned, and managed in Factify.
- [Error Handling](https://developers.factify.com/guides/error-handling.md): Handle API errors gracefully with structured error responses.
- [File Uploads](https://developers.factify.com/guides/file-uploads.md): Upload PDF files efficiently using streaming to avoid memory issues.
- [Pagination](https://developers.factify.com/guides/pagination.md): Navigate through large result sets with cursor-based pagination.
- [Quickstart](https://developers.factify.com/guides/quickstart.md): Get up and running with Factify in 5 minutes.
- [Rate Limiting](https://developers.factify.com/guides/rate-limiting.md): Understand API rate limits and how the SDK handles them automatically.
- [Retries](https://developers.factify.com/guides/retries.md): Configure automatic retry behavior for transient failures.
- [SDK Installation](https://developers.factify.com/guides/sdk-installation.md): Install and configure the official Factify SDKs for TypeScript and Python.
- [Factify Developer Portal](https://developers.factify.com/introduction.md): APIs for documents that take action. Build intelligent documents that collect data, enforce access, and stay auditable.
- [SDKs](https://developers.factify.com/sdk/overview.md): Official Factify SDKs for TypeScript and Python.
- [Python SDK](https://developers.factify.com/sdk/python.md): Complete reference for the Factify Python SDK.
- [TypeScript SDK](https://developers.factify.com/sdk/typescript.md): Complete reference for the Factify TypeScript SDK.

## OpenAPI Specs

- [openapi](https://developers.factify.com/openapi.json)
- [openapi-with-samples](https://developers.factify.com/openapi-with-samples.json)