OrganizationsApi
| Method | HTTP request | Description |
|---|---|---|
| CreateOrganizationUsingPOST | POST /api/web/v1/organizations | Create an organization |
| CreateUserOrganizationAssociationUsingPOST | POST /api/web/v1/organizations/{orgid}/users/{userid} | Add user to organization |
| DeleteUserOrganizationAssociationUsingDELETE | DELETE /api/web/v1/organizations/{orgid}/users/{userid} | Remove user from organization |
| GetOrganizationUsingGET | GET /api/web/v1/organizations/{id} | Get an organization |
| OrganizationsPagedUsingPOST | POST /api/web/v1/organizationspaged | List a page of organizations |
| RemoveOrganizationUsingDELETE | DELETE /api/web/v1/organizations/{id} | Delete an organization |
| UpdateOrganizationUsingPUT | PUT /api/web/v1/organizations/{id} | Update an organization |
CreateOrganizationUsingPOST
Organization CreateOrganizationUsingPOST (OrganizationParms organizationParms)
Create an organization
Create an organization. Caller requires the ORGANIZATIONS:ADD permission.
Using the CreateOrganizationUsingPOSTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| organizationParms | OrganizationParms |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
CreateUserOrganizationAssociationUsingPOST
void CreateUserOrganizationAssociationUsingPOST (string orgid, string userid)
Add user to organization
Add user to organization. Caller requires the ORGANIZATIONS:EDIT permission.
Example
Using the CreateUserOrganizationAssociationUsingPOSTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| orgid | string | The UUID of the organization. | |
| userid | string | The UUID of the user to be added to the organization. |
Return type
void (empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
DeleteUserOrganizationAssociationUsingDELETE
void DeleteUserOrganizationAssociationUsingDELETE (string orgid, string userid)
Remove user from organization
Remove user from organization. Caller requires the ORGANIZATIONS:EDIT permission.
Example
Using the DeleteUserOrganizationAssociationUsingDELETEWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| orgid | string | The UUID of the organization. | |
| userid | string | The UUID of the user to be remove from the organization. |
Return type
void (empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
GetOrganizationUsingGET
Organization GetOrganizationUsingGET (string id)
Get an organization
Get the specified organization. Caller requires the ORGANIZATIONS:VIEW permission.
Example
Using the GetOrganizationUsingGETWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | string | The UUID of the organization to be returned. |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
OrganizationsPagedUsingPOST
OrganizationPage OrganizationsPagedUsingPOST (SearchParms searchParms)
List a page of organizations
Returns organizations for the provided search parameters. Caller requires the ORGANIZATIONS:VIEW permission. The following searchByAttributes are supported:
- displayName: a string value that indicates the display name of the organizations. Allowed operators are: EQUALS, NOT_EQUALS, CONTAINS, NOT_CONTAINS, STARTS_WITH, ENDS_WITH.
- name: a string value that indicates the name of the organizations. Allowed operators are: EQUALS, NOT_EQUALS, CONTAINS, NOT_CONTAINS, STARTS_WITH, ENDS_WITH.
If you provide more than one search attribute, they are joined with an AND condition.
The orderByAttribute supports these attribute names: displayName, name.
Example
Using the OrganizationsPagedUsingPOSTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| searchParms | SearchParms |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
RemoveOrganizationUsingDELETE
void RemoveOrganizationUsingDELETE (string id)
Delete an organization
Delete the specified organization. Caller requires the ORGANIZATIONS:REMOVE permission.
Example
Using the RemoveOrganizationUsingDELETEWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | string | The UUID of the organization to be removed. |
Return type
void (empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |
UpdateOrganizationUsingPUT
Organization UpdateOrganizationUsingPUT (string id, OrganizationParms organizationParms)
Update an organization
Update the specified organization. Caller requires the ORGANIZATIONS:EDIT permission.
Example
Using the UpdateOrganizationUsingPUTWithHttpInfo variant
This returns an ApiResponse object which contains the response data, status code and headers.
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | string | The UUID of the organization to be modified. | |
| organizationParms | OrganizationParms |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 200 | Successful | - |
| 400 | Bad Request | - |
| 401 | Access denied | - |
| 403 | Forbidden | - |
| 404 | Not Found | - |
| 409 | Conflict | - |