# Organization

Organization and user management

## Get Organization Members

> Retrieves all members of an organization

```json
{"openapi":"3.0.3","info":{"title":"Ango Hub API v2","version":"2.0.0"},"tags":[{"name":"Organization","description":"Organization and user management"}],"servers":[{"url":"https://imeritapi.ango.ai/v2","description":"EU Production Server"},{"url":"https://us-api.ango.ai/v2","description":"US Production Server"},{"url":"https://in-api.ango.ai/v2","description":"India Production Server"},{"url":"https://testapi.ango.ai/v2","description":"Test Server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey","description":"API key for authentication. Format - apikey YOUR_API_KEY"}},"parameters":{"OrgIdParam":{"name":"orgId","in":"path","required":true,"schema":{"type":"string"},"description":"Organization ID"},"PageParam":{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1},"description":"Page number (1-indexed)"},"LimitParam":{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":10},"description":"Items per page (max 100)"}},"schemas":{"UserListResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"users":{"type":"array","items":{"$ref":"#/components/schemas/User"}}}}}},"User":{"type":"object","properties":{"_id":{"type":"string"},"email":{"type":"string"},"name":{"type":"string"},"organizationRole":{"type":"string","enum":["Admin","Member","Guest"]},"createdAt":{"type":"string","format":"date-time"}}}}},"paths":{"/organization/{orgId}/users":{"get":{"tags":["Organization"],"summary":"Get Organization Members","description":"Retrieves all members of an organization","operationId":"getOrganizationMembers","parameters":[{"$ref":"#/components/parameters/OrgIdParam"},{"$ref":"#/components/parameters/PageParam"},{"$ref":"#/components/parameters/LimitParam"},{"name":"search","in":"query","schema":{"type":"string"},"description":"Search by email or name"}],"responses":{"200":{"description":"Members retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserListResponse"}}}}}}}}}
```

## Update Members

> Updates roles for multiple organization members

```json
{"openapi":"3.0.3","info":{"title":"Ango Hub API v2","version":"2.0.0"},"tags":[{"name":"Organization","description":"Organization and user management"}],"servers":[{"url":"https://imeritapi.ango.ai/v2","description":"EU Production Server"},{"url":"https://us-api.ango.ai/v2","description":"US Production Server"},{"url":"https://in-api.ango.ai/v2","description":"India Production Server"},{"url":"https://testapi.ango.ai/v2","description":"Test Server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey","description":"API key for authentication. Format - apikey YOUR_API_KEY"}},"parameters":{"OrgIdParam":{"name":"orgId","in":"path","required":true,"schema":{"type":"string"},"description":"Organization ID"}},"schemas":{"BulkUpdateMembersRequest":{"type":"object","required":["users"],"properties":{"users":{"type":"array","items":{"type":"object","required":["email","organizationRole"],"properties":{"email":{"type":"string","format":"email"},"organizationRole":{"type":"string","enum":["Admin","Member","Guest"]}}}}}},"BulkUpdateResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"users":{"type":"object","properties":{"updated":{"type":"integer"},"failed":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string"},"status":{"type":"string"}}}}}}}}}}}},"paths":{"/organization/{orgId}/users":{"post":{"tags":["Organization"],"summary":"Update Members","description":"Updates roles for multiple organization members","operationId":"bulkUpdateMembers","parameters":[{"$ref":"#/components/parameters/OrgIdParam"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUpdateMembersRequest"}}}},"responses":{"200":{"description":"Members updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUpdateResponse"}}}}}}}}}
```

## Delete Members

> Removes multiple members from an organization

```json
{"openapi":"3.0.3","info":{"title":"Ango Hub API v2","version":"2.0.0"},"tags":[{"name":"Organization","description":"Organization and user management"}],"servers":[{"url":"https://imeritapi.ango.ai/v2","description":"EU Production Server"},{"url":"https://us-api.ango.ai/v2","description":"US Production Server"},{"url":"https://in-api.ango.ai/v2","description":"India Production Server"},{"url":"https://testapi.ango.ai/v2","description":"Test Server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey","description":"API key for authentication. Format - apikey YOUR_API_KEY"}},"parameters":{"OrgIdParam":{"name":"orgId","in":"path","required":true,"schema":{"type":"string"},"description":"Organization ID"}},"schemas":{"BulkDeleteMembersRequest":{"type":"object","required":["users"],"properties":{"users":{"type":"array","items":{"type":"string","format":"email"}}}},"BulkDeleteResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"deleted":{"type":"integer"},"failed":{"type":"integer"}}}}}}},"paths":{"/organization/{orgId}/users":{"delete":{"tags":["Organization"],"summary":"Delete Members","description":"Removes multiple members from an organization","operationId":"bulkDeleteMembers","parameters":[{"$ref":"#/components/parameters/OrgIdParam"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteMembersRequest"}}}},"responses":{"200":{"description":"Members deleted successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteResponse"}}}}}}}}}
```

## Get Organization Invites

> Retrieves pending invitations for an organization

```json
{"openapi":"3.0.3","info":{"title":"Ango Hub API v2","version":"2.0.0"},"tags":[{"name":"Organization","description":"Organization and user management"}],"servers":[{"url":"https://imeritapi.ango.ai/v2","description":"EU Production Server"},{"url":"https://us-api.ango.ai/v2","description":"US Production Server"},{"url":"https://in-api.ango.ai/v2","description":"India Production Server"},{"url":"https://testapi.ango.ai/v2","description":"Test Server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey","description":"API key for authentication. Format - apikey YOUR_API_KEY"}},"parameters":{"OrgIdParam":{"name":"orgId","in":"path","required":true,"schema":{"type":"string"},"description":"Organization ID"},"PageParam":{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"default":1},"description":"Page number (1-indexed)"},"LimitParam":{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":10},"description":"Items per page (max 100)"}},"schemas":{"InviteListResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"invites":{"type":"array","items":{"$ref":"#/components/schemas/Invitation"}}}}}},"Invitation":{"type":"object","properties":{"_id":{"type":"string"},"to":{"type":"string","format":"email"},"organizationRole":{"type":"string","enum":["Admin","Member","Guest"]},"status":{"type":"string","enum":["Pending","Sent","Accepted"]},"createdBy":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"}}}}},"paths":{"/organization/{orgId}/invites":{"get":{"tags":["Organization"],"summary":"Get Organization Invites","description":"Retrieves pending invitations for an organization","operationId":"getOrganizationInvites","parameters":[{"$ref":"#/components/parameters/OrgIdParam"},{"$ref":"#/components/parameters/PageParam"},{"$ref":"#/components/parameters/LimitParam"}],"responses":{"200":{"description":"Invites retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteListResponse"}}}}}}}}}
```

## Send Invitations

> Invites new members to your organization

```json
{"openapi":"3.0.3","info":{"title":"Ango Hub API v2","version":"2.0.0"},"tags":[{"name":"Organization","description":"Organization and user management"}],"servers":[{"url":"https://imeritapi.ango.ai/v2","description":"EU Production Server"},{"url":"https://us-api.ango.ai/v2","description":"US Production Server"},{"url":"https://in-api.ango.ai/v2","description":"India Production Server"},{"url":"https://testapi.ango.ai/v2","description":"Test Server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey","description":"API key for authentication. Format - apikey YOUR_API_KEY"}},"parameters":{"OrgIdParam":{"name":"orgId","in":"path","required":true,"schema":{"type":"string"},"description":"Organization ID"}},"schemas":{"InvitationRequest":{"type":"object","required":["to","organizationRole"],"properties":{"to":{"type":"array","items":{"type":"string","format":"email"},"minItems":1},"organizationRole":{"type":"string","enum":["Admin","Member","Guest"]},"projectAssignments":{"type":"array","items":{"type":"object","required":["projectId","projectRole"],"properties":{"projectId":{"type":"string"},"projectRole":{"type":"string"}}}},"organizationRoleAssignments":{"type":"object","additionalProperties":{"type":"string"}},"projectRoleAssignments":{"type":"object","additionalProperties":{"type":"string"}}}},"InviteListResponseData":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"invites":{"type":"array","items":{"$ref":"#/components/schemas/Invitation"}}}}}},"Invitation":{"type":"object","properties":{"_id":{"type":"string"},"to":{"type":"string","format":"email"},"organizationRole":{"type":"string","enum":["Admin","Member","Guest"]},"status":{"type":"string","enum":["Pending","Sent","Accepted"]},"createdBy":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"}}}}},"paths":{"/organization/{orgId}/invites":{"post":{"tags":["Organization"],"summary":"Send Invitations","description":"Invites new members to your organization","operationId":"sendInvitations","parameters":[{"$ref":"#/components/parameters/OrgIdParam"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationRequest"}}}},"responses":{"200":{"description":"Invitations sent successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteListResponseData"}}}}}}}}}
```

## Delete Invites

> Deletes multiple pending invitations

```json
{"openapi":"3.0.3","info":{"title":"Ango Hub API v2","version":"2.0.0"},"tags":[{"name":"Organization","description":"Organization and user management"}],"servers":[{"url":"https://imeritapi.ango.ai/v2","description":"EU Production Server"},{"url":"https://us-api.ango.ai/v2","description":"US Production Server"},{"url":"https://in-api.ango.ai/v2","description":"India Production Server"},{"url":"https://testapi.ango.ai/v2","description":"Test Server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey","description":"API key for authentication. Format - apikey YOUR_API_KEY"}},"parameters":{"OrgIdParam":{"name":"orgId","in":"path","required":true,"schema":{"type":"string"},"description":"Organization ID"}},"schemas":{"BulkDeleteInvitesRequest":{"type":"object","required":["invites"],"properties":{"invites":{"type":"array","items":{"type":"string"}}}},"BulkDeleteResponse":{"type":"object","properties":{"status":{"type":"string"},"data":{"type":"object","properties":{"deleted":{"type":"integer"},"failed":{"type":"integer"}}}}}}},"paths":{"/organization/{orgId}/invites":{"delete":{"tags":["Organization"],"summary":"Delete Invites","description":"Deletes multiple pending invitations","operationId":"bulkDeleteInvites","parameters":[{"$ref":"#/components/parameters/OrgIdParam"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteInvitesRequest"}}}},"responses":{"200":{"description":"Invites deleted successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteResponse"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.imerit.net/api/docs/organization.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.