Add external user

Assign a user who already exists in the Surfsight database to an additional organization as an external user. The user needs administrator permissions in their original organization and receives administrator permissions in the organization to which they are now assigned.

Note: POST calls create new data, and do not affect existing data.

Request
Security:
path Parameters
orgId
required
string

The ID of the organization. Obtain this from GET /organizations.

Example: 62
Request Body schema: application/json
email
required
string <email> (Email) ^\S+@\S+\.\S{2,}$

The email address of the entity.

Responses
200

Successful operation

400

Bad request error

401

Unauthorized error

403

Forbidden error

404

Not found error

500

Internal server error

post/organizations/{orgId}/external-users
Request samples
application/json
{
  • "email": "email@email.com"
}
Response samples
application/json
{
  • "requestId": "df5fg-45fgfdsg-45fg-45454"
}