TRtrycompai
People

Add multiple members to organization

Changed on

Bulk adds multiple members to the authenticated organization. Each member must have a valid user ID that exists in the system. Members who already exist in the organization or have invalid data will be skipped with error details returned.

post/v1/people/bulk

Request

  • Base URL
    https://api.trycomp.ai
  • Auth
    API key in header X-API-Key

Request body

Example request

{
  "members": [
    {
      "userId": "usr_abc123def456",
      "role": "admin",
      "department": "it",
      "isActive": true,
      "fleetDmLabelId": 123
    },
    {
      "userId": "usr_def456ghi789",
      "role": "member",
      "department": "hr",
      "isActive": true
    }
  ]
}

Response

Bulk member creation completed

authType'api-key' | 'session'

How the request was authenticated

Example response

{
  "created": [
    {
      "id": "mem_abc123def456",
      "organizationId": "org_abc123def456",
      "userId": "usr_abc123def456",
      "role": "admin",
      "createdAt": "2024-01-01T00:00:00Z",
      "department": "it",
      "isActive": true,
      "user": {
        "id": "usr_abc123def456",
        "name": "John Doe",
        "email": "john.doe@company.com",
        "emailVerified": true,
        "createdAt": "2024-01-01T00:00:00Z",
        "updatedAt": "2024-01-15T00:00:00Z"
      },
      "backgroundCheckRequests": [
        {
          "id": "bcr_abc123def456",
          "status": "invited"
        }
      ]
    }
  ],
  "errors": [
    {
      "index": 2,
      "userId": "usr_abc123def456",
      "error": "User user@example.com is already a member of this organization"
    }
  ],
  "summary": {
    "total": 5,
    "successful": 3,
    "failed": 2
  },
  "authenticatedUser": {
    "id": "usr_abc123def456",
    "email": "user@company.com"
  }
}

Changes

  • 33c685841b7aRevision changes
    • breaking

      removed the enum value admin of the request property //

    • breaking

      removed the enum value gov of the request property //

    • breaking

      removed the enum value hr of the request property //

    • breaking

      removed the enum value it of the request property //

    • breaking

      removed the enum value itsm of the request property //

    • breaking

      removed the enum value none of the request property //

    • breaking

      removed the enum value qms of the request property //

    • warning

      the // request property's maxLength was set to 64

    • info

      removed the admin enum value from the // response property for the response status

    • info

      removed the gov enum value from the // response property for the response status

    • info

      removed the hr enum value from the // response property for the response status

    • info

      removed the it enum value from the // response property for the response status

    • info

      removed the itsm enum value from the // response property for the response status

    • info

      removed the none enum value from the // response property for the response status

    • info

      removed the qms enum value from the // response property for the response status

  • 7ca7c363a732Revision changes
    • breaking

      request property // was restricted to a list of enum values

    • warning

      added the new admin enum value to the // response property for the response status

    • warning

      added the new gov enum value to the // response property for the response status

    • warning

      added the new hr enum value to the // response property for the response status

    • warning

      added the new it enum value to the // response property for the response status

    • warning

      added the new itsm enum value to the // response property for the response status

    • warning

      added the new none enum value to the // response property for the response status

    • warning

      added the new qms enum value to the // response property for the response status

    • info

      added the new admin enum value to the request property //

    • info

      added the new gov enum value to the request property //

    • info

      added the new hr enum value to the request property //

    • info

      added the new it enum value to the request property //

    • info

      added the new itsm enum value to the request property //

    • info

      added the new none enum value to the request property //

    • info

      added the new qms enum value to the request property //