API v1 Reference

Users

Users represent the people who are part of an awork workspace. They can be assigned to tasks, projects, and other resources. Users can have different roles and permissions in the workspace.

Use GET /users when you need a directory, and GET /users/me when you need the identity and workspace associated with the current token. User ids returned by these endpoints are used when assigning work, inviting members, or adding contact information.

Listing users

List active users
curl 'https://api.awork.com/api/v1/users?page=1&pageSize=50' \
  -H 'Authorization: Bearer {token}'

The list endpoint supports the standard filtering, ordering, and pagination parameters. Archived users are omitted unless you set showArchived=true.

Inviting Users

To invite a new user to an awork workspace, you need to make a request to POST /invitations. This is one of the few requests that requires a workspaceId.

Request
curl -X POST https://api.awork.com/api/v1/invitations \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{
	"email": "carla.creative@ncnstn.com",
	"invitationFlow": "invite",
	"workspaceId": "123e4567-e89b-12d3-a456-426614174000",
	"roleId": "123e4567-e89b-12d3-a456-426614174000"
  }'

You can find the workspace id of the current user by making a request to the /users/me endpoint.

Request
curl -X GET https://api.awork.com/api/v1/users/me \
  -H 'Authorization: Bearer {token}'
Response
{
	"id": "123e4567-e89b-12d3-a456-426614174000",
	"workspace": {
		"id": "123e4567-e89b-12d3-a456-426614174000",
		"name": "NCNSTN",
		"url": "https://ncnstn.awork.com"
	}
}

Updating a user

Update profile fields with PUT /users/{userId}. Use the dedicated activate, deactivate, and archive operations for account state changes.

Update a user's profile
curl -X PUT 'https://api.awork.com/api/v1/users/123e4567-e89b-12d3-a456-426614174000' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "firstName": "Carla",
    "lastName": "Creative",
    "position": "Senior Designer",
    "language": "en-GB"
  }'

For example, temporarily disable a user without deleting their historical assignments:

Deactivate a user
curl -X POST 'https://api.awork.com/api/v1/users/123e4567-e89b-12d3-a456-426614174000/deactivate' \
  -H 'Authorization: Bearer {token}'