Coolset Accounts API (1.0)
Download OpenAPI specification:Download
User account management, workspace configuration, and country data.
List workspaces
Returns all workspaces (companies) the authenticated user belongs to. Each workspace includes the company name, industry, and configuration. Use the search parameter to filter by workspace name.
Authorizations:
query Parameters
| name | string name |
| name__icontains | string name__icontains |
| name__istartswith | string name__istartswith |
| name__iendswith | string name__iendswith |
| type | string Enum: "active" "inactive" "test" "demo" "trial" "stakeholder" type |
| type__in | string type__in |
| country | string country |
| country__icontains | string country__icontains |
| country__istartswith | string country__istartswith |
| country__iendswith | string country__iendswith |
| country__in | string country__in |
| type__exclude | string type__exclude |
| ordering | string Which field to use when ordering the results. |
| search | string A search term. |
| limit | integer Number of results to return per page. |
| offset | integer The initial index from which to return the results. |
Responses
Response samples
- 200
{- "count": 0,
- "results": [
- {
- "workspace_id": 0,
- "workspace_name": "string",
- "id": 0,
- "name": "string",
- "type": "active",
- "country": "string",
- "member_count": 0,
- "is_mfa_enabled": true,
- "created_at": "2019-08-24T14:15:22Z",
- "updated_at": "2019-08-24T14:15:22Z"
}
]
}Invite a user to the workspace
Sends an email invitation to a new user to join the authenticated user's current workspace. The invitee will receive an email with a link to accept the invitation. Only OWNER and ADMIN users can invite users with the ADMIN role. Owners cannot be invited — they are created through the onboarding flow. Returns the invitation ID which can be used to retrieve the invitation status.
Authorizations:
Request Body schema: application/jsonrequired
| email required | string <email> (Email) [ 1 .. 1024 ] characters |
| auth_group required | integer (Auth group) |
Responses
Request samples
- Payload
{- "email": "user@example.com",
- "auth_group": 0
}Response samples
- 201
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "email": "user@example.com",
- "auth_group": 0
}Retrieve invitation status
Returns the status of a user invitation by its UUID. Use this to check whether the invitee has accepted the invitation and whether they are an existing Coolset user.
Authorizations:
path Parameters
| id required | string |
Responses
Response samples
- 200
{- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "email": "user@example.com",
- "company": {
- "id": 0,
- "name": "string",
- "type": "active",
- "country": "st",
- "credits_used": "string",
- "nr_of_employees": 0,
- "nr_of_locations": 0,
- "nr_of_transactions": 0,
- "minimum_date_filter": "2019-08-24",
- "results_limit_earliest_year": "2019-08-24",
- "results_limit_latest_year": "2019-08-24",
- "min_transaction_date": "string",
- "max_transaction_date": "string",
- "chift_consumer_id": "string",
- "default_currency": "string",
- "default_locale": "nl-NL",
- "data_room_consumer_id": "string",
- "information": { },
- "pulse_params": "string",
- "flags": [
- {
- "name": "string"
}
]
}, - "auth_group_id": "string",
- "is_existing_user": true,
- "is_active": "string",
- "is_mfa_enabled": "string"
}List users
Returns all users belonging to the authenticated user's company. Requires the view_user permission.
Authorizations:
query Parameters
| search | string A search term. |
| limit | integer Number of results to return per page. |
| offset | integer The initial index from which to return the results. |
Responses
Response samples
- 200
[- {
- "first_name": "string",
- "last_name": "string",
- "email": "user@example.com",
- "id": 0,
- "firebase_uid": "string",
- "active_user_company_id": 0,
- "user_company": {
- "id": 0,
- "user_id": "string",
- "company_id": "string",
- "auth_group_id": "string",
- "data_room_consumer_id": "string",
- "config": { }
}, - "company": {
- "id": 0,
- "name": "string",
- "type": "active",
- "country": "st",
- "credits_used": "string",
- "nr_of_employees": 0,
- "nr_of_locations": 0,
- "nr_of_transactions": 0,
- "minimum_date_filter": "2019-08-24",
- "results_limit_earliest_year": "2019-08-24",
- "results_limit_latest_year": "2019-08-24",
- "min_transaction_date": "string",
- "max_transaction_date": "string",
- "chift_consumer_id": "string",
- "default_currency": "string",
- "default_locale": "nl-NL",
- "data_room_consumer_id": "string",
- "information": { },
- "pulse_params": "string",
- "flags": [
- {
- "name": "string"
}
]
}, - "job_title": "string",
- "auth_group": {
- "id": 0,
- "name": "string",
- "permissions": [
- {
- "codename": "string"
}
]
}, - "is_mfa_enrolled": true,
- "is_mfa_required": true,
- "data_room_consumer_id": "string",
- "pylon_email_hash": "string"
}
]Get current user Deprecated
DEPRECATED. Use GET /api/accounts/users/me/ instead. Returns the profile of the currently authenticated user.
Authorizations:
Responses
Response samples
- 200
{- "first_name": "string",
- "last_name": "string",
- "email": "user@example.com",
- "id": 0,
- "firebase_uid": "string",
- "active_user_company_id": 0,
- "user_company": {
- "id": 0,
- "user_id": "string",
- "company_id": "string",
- "auth_group_id": "string",
- "data_room_consumer_id": "string",
- "config": { }
}, - "company": {
- "id": 0,
- "name": "string",
- "type": "active",
- "country": "st",
- "credits_used": "string",
- "nr_of_employees": 0,
- "nr_of_locations": 0,
- "nr_of_transactions": 0,
- "minimum_date_filter": "2019-08-24",
- "results_limit_earliest_year": "2019-08-24",
- "results_limit_latest_year": "2019-08-24",
- "min_transaction_date": "string",
- "max_transaction_date": "string",
- "chift_consumer_id": "string",
- "default_currency": "string",
- "default_locale": "nl-NL",
- "data_room_consumer_id": "string",
- "information": { },
- "pulse_params": "string",
- "flags": [
- {
- "name": "string"
}
]
}, - "job_title": "string",
- "auth_group": {
- "id": 0,
- "name": "string",
- "permissions": [
- {
- "codename": "string"
}
]
}, - "is_mfa_enrolled": true,
- "is_mfa_required": true,
- "data_room_consumer_id": "string",
- "pylon_email_hash": "string"
}List workspaces
Returns all workspaces (companies) the authenticated user is a member of. Each workspace includes its name, ID, logo, member count, and MFA status. Use the workspace ID with the switch workspace endpoint to change the active workspace.
Authorizations:
query Parameters
| limit | integer Number of results to return per page. |
| offset | integer The initial index from which to return the results. |
Responses
Response samples
- 200
{- "workspaces": [
- {
- "workspace_name": "string",
- "workspace_id": 0,
- "member_count": 0,
- "is_mfa_enabled": true
}
]
}Switch workspace
Switches the authenticated user's active workspace to the given company. Use the List workspaces endpoint to retrieve available workspace IDs, then pass the desired workspace_id as company_id in the request body.
Authorizations:
Request Body schema: application/jsonrequired
| company_id required | integer ID of the workspace to switch to (use List workspaces to get IDs) |
Responses
Request samples
- Payload
{- "company_id": 0
}Response samples
- 200
- 400
{- "message": "string"
}