Companies

Manage Company business and network information.

Create a company

Request
Request Body schema: application/json
any (CompanyModel)
Responses
200

OK

put/api/company
Request samples
application/json
{
  • "name": "Foo International",
  • "company": {
    }
}

Remove role from user

Remove a role from a user within a given company.

Request
path Parameters
username
required
string

The username of the company to join.

Example: acmeinc
targetUsername
required
string

The username of the user to respond to.

Example: meg
roleName
required
string

The role to apply to or remove from the user.

Example: ADMIN
Responses
200

OK

delete/api/company/{username}/memberships/{targetUsername}/roles/{roleName}

Add role to user

Add a role to a user within a given company.

Request
path Parameters
username
required
string

The username of the company to join.

Example: acmeinc
targetUsername
required
string

The username of the user to respond to.

Example: meg
roleName
required
string

The role to apply to or remove from the user.

Example: ADMIN
Responses
200

OK

put/api/company/{username}/memberships/{targetUsername}/roles/{roleName}

Update user role state

LinkUserCompany object shows the state of the company membership requests. # I'm not seeing this object name in the examples? - INACTIVE - Request made by either company or user. - ACTIVE - Request accepted and they are a member of the company. - DENIED - Request denied by the company. - CANCELLED - Request cancelled by either company or user.

Request
path Parameters
username
required
string

The username of the company.

Example: acmeinc
targetUsername
required
string

the username of the user to modify.

Example: meg
Request Body schema: application/json
state
string

The new state for this user; INACTIVE, ACTIVE, DENIED, or CANCELLED.

Responses
200

OK

post/api/company/{username}/memberships/{targetUsername}
Request samples
application/json
{
  • "state": "ACTIVE"
}

Remove a user from a company

Request
path Parameters
username
required
string

The username of the company.

Example: acmeinc
targetUsername
required
string

the username of the user to modify.

Example: meg
Responses
200

OK

delete/api/company/{username}/memberships/{targetUsername}
Response samples
application/json
{ }

Leave a Company

Removes the authenticated user from the company.

Request
path Parameters
username
required
string

the username of the company to leave.

Example: acmeinc
Responses
200

OK

delete/api/company/{username}/memberships