OrganizationService
Manages organization creation, retrieval, updates, and SSO attribute mapping configuration.
Methods
Section titled “Methods”| Method | Description |
|---|---|
CreateOrganization | Create a new organization |
GetOrganization | Get the current organization |
UpdateOrganization | Update organization details |
UpdateSsoAttributeMappings | Configure SSO attribute mappings |
CreateOrganization
Section titled “CreateOrganization”Create a new organization. Called during onboarding after first sign-in.
Authorization: Authenticated user (JWT, no existing org required)
Request: CreateOrganizationRequest
Section titled “Request: CreateOrganizationRequest”| Field | Type | Description |
|---|---|---|
name | string | Organization name. Max 200 characters. |
industry | Industry | Industry vertical. |
company_size | CompanySize | Company size range. |
Response: CreateOrganizationResponse
Section titled “Response: CreateOrganizationResponse”| Field | Type | Description |
|---|---|---|
organization | Organization | The created organization. |
GetOrganization
Section titled “GetOrganization”Get the authenticated user’s organization.
Authorization: Authenticated user
Request: GetOrganizationRequest
Section titled “Request: GetOrganizationRequest”Empty request. Organization is derived from the JWT custom:org_id claim.
Response: GetOrganizationResponse
Section titled “Response: GetOrganizationResponse”| Field | Type | Description |
|---|---|---|
organization | Organization | The organization. |
UpdateOrganization
Section titled “UpdateOrganization”Authorization: Requires MANAGE_ORGANIZATION permission
Request: UpdateOrganizationRequest
Section titled “Request: UpdateOrganizationRequest”| Field | Type | Description |
|---|---|---|
name | string | Updated name. |
industry | Industry | Updated industry. |
company_size | CompanySize | Updated company size. |
Response: UpdateOrganizationResponse
Section titled “Response: UpdateOrganizationResponse”| Field | Type | Description |
|---|---|---|
organization | Organization | The updated organization. |
UpdateSsoAttributeMappings
Section titled “UpdateSsoAttributeMappings”Configure how SAML assertion attributes map to Pidgr user profile fields.
Authorization: Requires MANAGE_SSO permission
Request: UpdateSsoAttributeMappingsRequest
Section titled “Request: UpdateSsoAttributeMappingsRequest”| Field | Type | Description |
|---|---|---|
mappings | SsoAttributeMapping[] | Attribute mappings to set. |
Response: UpdateSsoAttributeMappingsResponse
Section titled “Response: UpdateSsoAttributeMappingsResponse”| Field | Type | Description |
|---|---|---|
mappings | SsoAttributeMapping[] | The saved mappings. |
Organization Message
Section titled “Organization Message”| Field | Type | Description |
|---|---|---|
id | string | Unique identifier. |
name | string | Organization name. |
industry | Industry | Industry vertical. |
company_size | CompanySize | Company size range. |
sso_attribute_mappings | SsoAttributeMapping[] | SSO attribute mappings. |
created_at | Timestamp | Creation timestamp. |
updated_at | Timestamp | Last update timestamp. |
Industry
Section titled “Industry”TECHNOLOGY, FINANCE, HEALTHCARE, EDUCATION, RETAIL, MANUFACTURING, MEDIA, GOVERNMENT, NON_PROFIT, OTHER
CompanySize
Section titled “CompanySize”SMALL (1–50), MEDIUM (51–200), LARGE (201–1000), ENTERPRISE (1001+)