Organizations API

Organizations represent law firms, companies, or business entities in Silent Witness. They help you organize cases and manage billing.

Endpoints

Method	Endpoint	Description
POST	/api/organizations	Create organization
GET	/api/organizations/:id	Get organization
GET	/api/organizations	List organizations
PUT	/api/organizations/:id	Update organization
DELETE	/api/organizations/:id	Delete organization

Organization Object

{
  "id": "org_abc123def456",
  "account_id": "acc_xyz789",
  "name": "Smith & Associates Law Firm",
  "phone_number": "555-123-4567",
  "street_address": "123 Main Street, Suite 400",
  "city": "San Francisco",
  "state": "CA",
  "zip_code": "94102",
  "country": "United States",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Fields

Field	Type	Description
id	string	Unique organization identifier
account_id	string	Account this organization belongs to
name	string	Organization name
phone_number	string	Primary contact phone number
street_address	string	Physical street address
city	string	City
state	string	State or province
zip_code	string	ZIP or postal code
country	string	Country
created_at	datetime	When the organization was created
updated_at	datetime	When the organization was last updated

Workflow

1. Create an organization with your firm's details
2. Create cases within the organization by passing the organization_id
3. List organizations to view all firms in your account
4. Update an organization when contact details change
5. Delete an organization when it is no longer needed

Use Cases

• Law firms: Create an organization for each law firm you work with
• Multi-office: Create separate organizations for different office locations
• Client segregation: Organize cases by client organization

Next Steps

• Create an Organization
• Create a Case within an organization