Organization

Organization and user management

Get Organization Members

get

/organization/{orgId}/users

Retrieves all members of an organization

Authorizations

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

orgIdstringRequired

Organization ID

Query parameters

pageinteger · min: 1Optional

Page number (1-indexed)

Default: 1

limitinteger · min: 1 · max: 100Optional

Items per page (max 100)

Default: 10

searchstringOptional

Search by email or name

Responses

200

Members retrieved successfully

application/json

get

/organization/{orgId}/users

curl -X GET "https://imeritapi.ango.ai/v2/organization/org123/users?page=1&limit=10&search=john" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json"

200

Members retrieved successfully

{
  "status": "success",
  "data": {
    "users": [
      {
        "_id": "text",
        "email": "text",
        "name": "text",
        "organizationRole": "Admin",
        "createdAt": "2025-12-28T13:46:08.553Z"
      }
    ]
  }
}

Update Members

post

/organization/{orgId}/users

Updates roles for multiple organization members

Authorizations

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

orgIdstringRequired

Organization ID

Body

Responses

200

Members updated successfully

application/json

post

/organization/{orgId}/users

POST /v2/organization/{orgId}/users HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 65

{
  "users": [
    {
      "email": "[email protected]",
      "organizationRole": "Admin"
    }
  ]
}

200

Members updated successfully

{
  "status": "success",
  "data": {
    "users": {
      "updated": 1,
      "failed": 1,
      "results": [
        {
          "email": "text",
          "status": "text"
        }
      ]
    }
  }
}

Delete Members

delete

/organization/{orgId}/users

Removes multiple members from an organization

Authorizations

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

orgIdstringRequired

Organization ID

Body

usersstring · email[]Required

Responses

200

Members deleted successfully

application/json

delete

/organization/{orgId}/users

DELETE /v2/organization/{orgId}/users HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "users": [
    "[email protected]"
  ]
}

200

Members deleted successfully

{
  "status": "success",
  "data": {
    "deleted": 1,
    "failed": 1
  }
}

Get Organization Invites

get

/organization/{orgId}/invites

Retrieves pending invitations for an organization

Authorizations

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

orgIdstringRequired

Organization ID

Query parameters

pageinteger · min: 1Optional

Page number (1-indexed)

Default: 1

limitinteger · min: 1 · max: 100Optional

Items per page (max 100)

Default: 10

Responses

200

Invites retrieved successfully

application/json

get

/organization/{orgId}/invites

GET /v2/organization/{orgId}/invites HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Accept: */*

200

Invites retrieved successfully

{
  "status": "success",
  "data": {
    "invites": [
      {
        "_id": "text",
        "to": "[email protected]",
        "organizationRole": "Admin",
        "status": "Pending",
        "createdBy": "text",
        "createdAt": "2025-12-28T13:46:08.553Z",
        "expiresAt": "2025-12-28T13:46:08.553Z"
      }
    ]
  }
}

Send Invitations

post

/organization/{orgId}/invites

Invites new members to your organization

Authorizations

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

orgIdstringRequired

Organization ID

Body

tostring · email[] · min: 1Required

organizationRolestring · enumRequiredPossible values:

Responses

200

Invitations sent successfully

application/json

post

/organization/{orgId}/invites

POST /v2/organization/{orgId}/invites HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 242

{
  "to": [
    "[email protected]"
  ],
  "organizationRole": "Admin",
  "projectAssignments": [
    {
      "projectId": "text",
      "projectRole": "text"
    }
  ],
  "organizationRoleAssignments": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "projectRoleAssignments": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

200

Invitations sent successfully

{
  "status": "success",
  "data": {
    "invites": [
      {
        "_id": "text",
        "to": "[email protected]",
        "organizationRole": "Admin",
        "status": "Pending",
        "createdBy": "text",
        "createdAt": "2025-12-28T13:46:08.553Z",
        "expiresAt": "2025-12-28T13:46:08.553Z"
      }
    ]
  }
}

Delete Invites

delete

/organization/{orgId}/invites

Deletes multiple pending invitations

Authorizations

apikeystringRequired

API key for authentication. Format - apikey YOUR_API_KEY

Path parameters

orgIdstringRequired

Organization ID

Body

invitesstring[]Required

Responses

200

Invites deleted successfully

application/json

delete

/organization/{orgId}/invites

DELETE /v2/organization/{orgId}/invites HTTP/1.1
Host: imeritapi.ango.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 20

{
  "invites": [
    "text"
  ]
}

200

Invites deleted successfully

{
  "status": "success",
  "data": {
    "deleted": 1,
    "failed": 1
  }
}

Last updated 4 days ago