Organizations and Projects
Organizations and projects provide a hierarchical structure for organizing your extraction workflows in Sterndesk.
Hierarchy Overview
Organization
└── Project
├── Extraction Schema
├── Upload Collector → Uploads → Extractions
└── Crawl Collector → Crawls → Extractions
Authentication and Access Control
API keys grant access to all organizations and projects that the associated user is a member of. When you authenticate with an API key, you can:
- List and manage organizations you belong to
- Create, update, and delete projects within those organizations
- Access all resources (schemas, collectors, extractions) within those projects
See Authentication for details on obtaining and using API keys.
API keys inherit the permissions of the user they belong to. A user can be a member of multiple organizations, and their API key provides access to all of them.
Common Use Cases
Separating Customers
If you’re building a platform that processes documents for multiple customers, create a separate project for each customer:
My Company (Organization)
├── Acme Corp (Project)
├── Globex Inc (Project)
└── Initech (Project)
Deployment Environments
Use separate projects within an organization to manage different environments:
My Company (Organization)
├── Ocean Research - Development (Project)
├── Ocean Research - Staging (Project)
└── Ocean Research - Production (Project)
Teams or Departments
Organizations can represent different teams or business units:
Finance Department (Organization)
├── Expense Reports (Project)
└── Vendor Invoices (Project)
Legal Department (Organization)
├── Contract Review (Project)
└── Compliance Documents (Project)
API Reference
For detailed information on creating, updating, and deleting organizations and projects, see the API Reference:
Next Steps
